As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Dados de casos no data lake de análise do Connect Customer
<a name="data-lake-cases-data"></a>

Este tópico detalha o conteúdo das tabelas de casos do data lake do Connect Customer. As tabelas listam a coluna, o tipo e a descrição do conteúdo.

Há duas maneiras de acessar o data lake de analytics e configurar os dados a serem compartilhados: 
+ [Opção 1: usar o console Connect Customer](access-datalake.md#option1-configure-data-to-be-shared)
+ [Opção 2: usar CLI ou CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

Se você não conseguir acessar as tabelas de agendamento usando a Opção 1, tente usar a Opção 2.

**Topics**
+ [Eventos de caso](#data-lake-case-events)
+ [Eventos de itens relacionados ao caso](#data-lake-case-related-item-events)

## Eventos de caso
<a name="data-lake-case-events"></a>

**Nome da tabela: ** `case_events`

**Descrição: ** registra eventos do ciclo de vida do caso (criados, atualizados, excluídos), incluindo metadados do caso, alterações de status, informações do modelo e valores de campo personalizados para Connect Cases.

**Chave primária: ** `instance_id, event_id`

**Chave de partição: ** `event_timestamp` (diariamente)

**Teclas de junção: **
+ `instance_id`— Junta-se a todas as mesas
+ `case_id`— Junta-se a case\_related\_item\_events (as) `associated_case_id`


|  **Coluna**  |  **Tipo**  |  **Anulável **  |  **Descrição**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  string  |  Não  |  O ID da instância do Connect Customer.  | 
|  aws\_account\_id  |  string  |  Sim  |  O ID da AWS conta proprietária da caixa.  | 
|  event\_id  |  string  |  Não  |  O ID exclusivo do evento do caso.  | 
|  case\_id  |  string  |  Sim  |  O ID do caso.  | 
|  event\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o evento ocorreu, em UTC.  | 
|  IDs\_de\_campo alterados  |  array(string)  |  Sim  |  A lista de IDs de campo que foram modificadas nesse evento.  | 
|  event\_type  |  string  |  Sim  |  O tipo de evento. Valores válidos: CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  executada por \_iam\_principal  |  string  |  Sim  |  O ARN principal do IAM da entidade que acionou o evento.  | 
|  executado\_por\_user\_arn  |  string  |  Sim  |  O ARN do usuário que executou a ação.  | 
|  executado\_por\_custom\_entity  |  string  |  Sim  |  A entidade personalizada que executou a ação.  | 
|  cases\_domain\_arn  |  string  |  Sim  |  O ARN do domínio Connect Customer Cases.  | 
|  id\_do\_modelo  |  string  |  Sim  |  O ID do modelo de caso usado para criar o caso.  | 
|  template\_name  |  string  |  Sim  |  O nome do modelo de caso. Esse valor ficará vazio se o modelo tiver sido excluído.  | 
|  last\_updated\_user  |  string  |  Sim  |  O último usuário que atualizou o caso. Isso faz referência ao valor last\_updated\_user do campo do sistema.  | 
|  reference\_number  |  string  |  Sim  |  O número de referência legível por humanos para o caso. Isso faz referência ao valor reference\_number do campo do sistema.  | 
|  status  |  string  |  Sim  |  O status do caso. Isso faz referência ao valor status do campo do sistema.  | 
|  assigned\_user  |  string  |  Sim  |  O ARN do usuário atribuído ao caso. Isso faz referência ao valor assigned\_user do campo do sistema.  | 
|  assigned\_queue  |  string  |  Sim  |  O ARN da fila atribuída ao caso. Isso faz referência ao valor assigned\_queue do campo do sistema.  | 
|  case\_reason  |  string  |  Sim  |  O motivo da abertura da caixa. Isso faz referência ao valor case\_reason do campo do sistema.  | 
|  título\_do\_caso  |  string  |  Sim  |  O título do caso. Isso faz referência ao valor title do campo do sistema.  | 
|  resumo do caso  |  string  |  Sim  |  O resumo do caso. Isso faz referência ao valor summary do campo do sistema.  | 
|  customer\_profile\_arn  |  string  |  Sim  |  O ARN do perfil do cliente associado ao caso. Isso faz referência ao valor customer\_id do campo do sistema.  | 
|  created\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o caso foi criado, em UTC. Isso faz referência ao valor created\_datetime do campo do sistema.  | 
|  last\_updated\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o caso foi atualizado pela última vez, em UTC. Isso faz referência ao valor last\_updated\_datetime do campo do sistema.  | 
|  timestamp next\_sla\_breach\_  |  Timestamp  |  Sim  |  A data e hora do próximo prazo de violação do SLA, em UTC. Isso faz referência ao valor next\_sla\_breach\_datetime do campo do sistema.  | 
|  carimbo de data/hora do último fechamento  |  Timestamp  |  Sim  |  A data e hora em que o caso foi encerrado pela última vez, em UTC. Isso faz referência ao valor last\_closed\_datetime do campo do sistema.  | 
|  carimbo de data/hora da última reabertura  |  Timestamp  |  Sim  |  A data e hora em que o caso foi reaberto pela última vez, em UTC. Isso faz referência ao valor last\_reopened\_datetime do campo do sistema.  | 
|  custom\_fields  |  matriz (estrutura)  |  Sim  |  Uma matriz de objetos contendo dados de campo personalizados associados ao caso. Cada objeto inclui o ID do campo, field\_name e um campo de valor específico do tipo (string\_value, double\_value, boolean\_value ou timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  Sim  |  O carimbo de data/hora, que mostra a última vez que o data lake foi atualizado. Pode incluir transformação e preenchimento. Esse campo não pode ser usado de forma confiável para determinar a atualização dos dados.  | 

### Exemplos de consultas
<a name="data-lake-case-events-sample-queries"></a>

O exemplo de consulta a seguir no Athena cria uma visualização que nivela os campos personalizados da tabela de eventos do caso:

```
CREATE VIEW case_events_flattened AS
SELECT
    ce.event_id,
    ce.case_id,
    ce.event_timestamp,
    ce.event_type,
    ce.instance_id,
    -- ... other system fields
    -- Flattened custom fields
    cf.id AS custom_field_id,
    cf.field_name AS custom_field_name,
    CASE
        WHEN cf.string_value IS NOT NULL THEN 'string'
        WHEN cf.double_value IS NOT NULL THEN 'double'
        WHEN cf.timestamp_value IS NOT NULL THEN 'timestamp'
        WHEN cf.boolean_value IS NOT NULL THEN 'boolean'
        ELSE 'unknown'
    END AS custom_field_type,
    cf.string_value AS custom_field_string_value,
    cf.double_value AS custom_field_double_value,
    -- Cast milliseconds to timestamp
    CAST(from_unixtime(cf.timestamp_value / 1000.0) AS TIMESTAMP) AS custom_field_timestamp_value,
    cf.boolean_value AS custom_field_boolean_value
FROM "{{case_events resource link table name}}" ce
CROSS JOIN UNNEST(ce.custom_fields) AS t(cf)
```

O exemplo a seguir cria uma visualização que retorna o estado mais recente de cada caso:

```
CREATE OR REPLACE VIEW latest_case_state AS
SELECT *
FROM (
    SELECT *,
        ROW_NUMBER() OVER (
            PARTITION BY case_id, instance_id
            ORDER BY event_timestamp DESC
        ) AS rn
    FROM "{{case_events resource link table name}}"
) t
WHERE rn = 1;
```

## Eventos de itens relacionados ao caso
<a name="data-lake-case-related-item-events"></a>

**Nome da tabela: ** `case_related_item_events`

**Descrição: ** registra eventos para itens relacionados a casos, incluindo comentários, contatos, anexos de arquivos, rastreamento de SLA e itens relacionados personalizados.

**Chave primária: ** `instance_id, event_id`

**Chave de partição: ** `event_timestamp` (diariamente)

**Teclas de junção: **
+ `instance_id`— Junta-se a todas as mesas
+ `associated_case_id`— Junta-se a case\_events (as) `case_id`
+ `contact_id`— Ingressos no registro de contato


|  **Coluna**  |  **Tipo**  |  **Anulável **  |  **Descrição**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  string  |  Não  |  O ID da instância do Connect Customer.  | 
|  aws\_account\_id  |  string  |  Sim  |  O ID da AWS conta que possui o item relacionado.  | 
|  event\_id  |  string  |  Não  |  O ID exclusivo do evento do item relacionado.  | 
|  id\_do\_item relacionado  |  string  |  Sim  |  O ID do item relacionado.  | 
|  event\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o evento ocorreu, em UTC.  | 
|  event\_type  |  string  |  Sim  |  O tipo de evento. Valores válidos: CASE.RELATED \_ITEM.CREATED, CASE.RELATED \_ITEM.UPDATED, CASE.RELATED \_ITEM.DELETED.  | 
|  executada por \_iam\_principal  |  string  |  Sim  |  O ARN principal do IAM da entidade que acionou o evento.  | 
|  executado\_por\_user\_arn  |  string  |  Sim  |  O ARN do usuário que executou a ação.  | 
|  executado\_por\_custom\_entity  |  string  |  Sim  |  O identificador de entidade personalizado que executou a ação.  | 
|  cases\_domain\_arn  |  string  |  Sim  |  O ARN do domínio Connect Customer Cases.  | 
|  case\_id associado  |  string  |  Sim  |  O ID do caso ao qual esse item relacionado está associado.  | 
|  tipo\_do\_item relacionado  |  string  |  Sim  |  O tipo de item relacionado. Valores válidos: comentário, arquivo, sla, conexão, contato, personalizado.  | 
|  created\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o item relacionado foi criado, em UTC.  | 
|  corpo\_do\_comentário  |  string  |  Sim  |  O corpo do texto do comentário.  | 
|  tipo\_do\_conteúdo de comentário  |  string  |  Sim  |  O tipo de conteúdo do corpo do comentário. Por exemplo, Text/Plain.  | 
|  id\_do\_caso relacionado  |  string  |  Sim  |  O ID do caso relacionado.  | 
|  canal de contato  |  string  |  Sim  |  O canal de comunicação do contato. Por exemplo, VOZ, BATE-PAPO, TAREFA, E-MAIL.  | 
|  contact\_id  |  string  |  Sim  |  O ID do contato.  | 
|  arquivo\_arn  |  string  |  Sim  |  O ARN do anexo do arquivo.  | 
|  nome\_da\_sla  |  string  |  Sim  |  O nome do SLA.  | 
|  status\_sla  |  string  |  Sim  |  O status atual do SLA. Por exemplo, ativo, vencido, atendido, não atendido.  | 
|  sla\_target\_timestamp  |  Timestamp  |  Sim  |  O carimbo de data/hora do prazo alvo para o SLA, em UTC.  | 
|  tipo\_sla  |  string  |  Sim  |  O tipo de métrica de SLA que está sendo rastreada. Por exemplo, CaseField.  | 
|  sla\_completion\_timestamp  |  Timestamp  |  Sim  |  A data e hora em que o SLA foi concluído, em UTC.  | 
|  sla\_target\_field\_id  |  string  |  Sim  |  O ID do campo que o SLA tem como alvo.  | 
|  sla\_target\_field\_values  |  array(string)  |  Sim  |  Os valores do campo de destino para o sla\_target\_field\_id para que o SLA seja concluído.  | 
|  campos\_do\_item\_relacionados personalizados  |  matriz (estrutura)  |  Sim  |  Uma matriz de objetos contendo dados de campo personalizados associados ao item relacionado. Cada objeto inclui o ID do campo, field\_name e um campo de valor específico do tipo (string\_value, double\_value, boolean\_value ou timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  Sim  |  O carimbo de data/hora, que mostra a última vez que o data lake foi atualizado. Pode incluir transformação e preenchimento. Esse campo não pode ser usado de forma confiável para determinar a atualização dos dados.  |