

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 analítico do Amazon Connect
<a name="data-lake-cases-data"></a>

Este tópico detalha o conteúdo das tabelas de casos do data lake do Amazon Connect. 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 do Amazon Connect](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`

Chave primária composta: {instance\_id, event\_id}


|  **Coluna**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  instance\_id  |  string  |  O ID da instância do Amazon Connect.  | 
|  aws\_account\_id  |  string  |  O ID da AWS conta proprietária da caixa.  | 
|  event\_id  |  string  |  O ID exclusivo do evento do caso.  | 
|  case\_id  |  string  |  A identificação do caso.  | 
|  event\_timestamp  |  Timestamp  |  A data e hora em que o evento ocorreu, em UTC.  | 
|  id\_de\_campo alterados  |  array(string)  |  A lista de campos IDs que foram modificados nesse evento.  | 
|  event\_type  |  string  |  O tipo de evento. Valores válidos: CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  executada por \_iam\_principal  |  string  |  O ARN principal do IAM da entidade que acionou o evento.  | 
|  executado\_por\_user\_arn  |  string  |  O ARN do usuário que executou a ação.  | 
|  executado\_por\_entidade\_personalizada  |  string  |  A entidade personalizada que executou a ação.  | 
|  cases\_domain\_arn  |  string  |  O ARN do domínio Amazon Connect Cases.  | 
|  id\_do\_modelo  |  string  |  O ID do modelo de caso usado para criar o caso.  | 
|  template\_name  |  string  |  O nome do modelo de caso. Esse valor estará vazio se o modelo tiver sido excluído.  | 
|  last\_updated\_user  |  string  |  O último usuário que atualizou o caso. Isso faz referência ao valor last\_updated\_user do campo do sistema.  | 
|  reference\_number  |  string  |  O número de referência legível por humanos para a caixa. Isso faz referência ao valor reference\_number do campo do sistema.  | 
|  status  |  string  |  O status do caso. Isso faz referência ao valor status do campo do sistema.  | 
|  assigned\_user  |  string  |  O ARN do usuário atribuído ao caso. Isso faz referência ao valor assigned\_user do campo do sistema.  | 
|  assigned\_queue  |  string  |  O ARN da fila atribuída ao caso. Isso faz referência ao valor assigned\_queue do campo do sistema.  | 
|  case\_reason  |  string  |  O motivo da abertura do estojo. Isso faz referência ao valor case\_reason do campo do sistema.  | 
|  título\_de\_caso  |  string  |  O título do caso. Isso faz referência ao valor title do campo do sistema.  | 
|  resumo do caso  |  string  |  O resumo do caso. Isso faz referência ao valor summary do campo do sistema.  | 
|  cliente\_profile\_arn  |  string  |  O ARN do perfil do cliente associado ao caso. Isso faz referência ao valor customer\_id do campo do sistema.  | 
|  created\_timestamp  |  Timestamp  |  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  |  A data e hora da última atualização do caso, em UTC. Isso faz referência ao valor last\_updated\_datetime do campo do sistema.  | 
|  next\_sla\_breach\_timestamp  |  Timestamp  |  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.  | 
|  último carimbo de data/hora fechado  |  Timestamp  |  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.  | 
|  último carimbo de data/hora reaberto  |  Timestamp  |  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)  |  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).  | 

### 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 de 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`

Chave primária composta: {instance\_id, event\_id}


|  **Coluna**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  instance\_id  |  string  |  O ID da instância do Amazon Connect.  | 
|  aws\_account\_id  |  string  |  O ID da AWS conta que possui o item relacionado.  | 
|  event\_id  |  string  |  A ID exclusiva do evento do item relacionado.  | 
|  id\_do\_item\_relacionado  |  string  |  O ID do item relacionado.  | 
|  event\_timestamp  |  Timestamp  |  A data e hora em que o evento ocorreu, em UTC.  | 
|  event\_type  |  string  |  O tipo de evento. Valores válidos: CASE.RELATED\_ITEM.CREATED, CASE.RELATED\_ITEM.UPDATED, CASE.RELATED\_ITEM.DELETED.  | 
|  executada por \_iam\_principal  |  string  |  O ARN principal do IAM da entidade que acionou o evento.  | 
|  executado\_por\_user\_arn  |  string  |  O ARN do usuário que executou a ação.  | 
|  executado\_por\_entidade\_personalizada  |  string  |  O identificador personalizado da entidade que executou a ação.  | 
|  cases\_domain\_arn  |  string  |  O ARN do domínio Amazon Connect Cases.  | 
|  identificação\_do\_caso\_associado  |  string  |  O ID do caso ao qual esse item relacionado está associado.  | 
|  tipo\_de\_item relacionado  |  string  |  O tipo de item relacionado. Valores válidos: comentário, arquivo, sla, conexão, contato, personalizado.  | 
|  created\_timestamp  |  Timestamp  |  O carimbo de data e hora em que o item relacionado foi criado, em UTC.  | 
|  corpo do comentário  |  string  |  O corpo do texto do comentário.  | 
|  tipo\_de\_conteu\_comentário  |  string  |  O tipo de conteúdo do corpo do comentário. Por exemplo, Text/Plain.  | 
|  identificação\_do\_caso\_relacionado  |  string  |  O ID do caso relacionado.  | 
|  canal de contato  |  string  |  O canal de comunicação do contato. Por exemplo, VOZ, BATE-PAPO, TAREFA, E-MAIL.  | 
|  contact\_id  |  string  |  O ID do contato.  | 
|  file\_arn  |  string  |  O ARN do anexo do arquivo.  | 
|  nome\_sla  |  string  |  O nome do SLA.  | 
|  status do SLA  |  string  |  O status atual do SLA. Por exemplo, ativo, vencido, cumprido, não cumprido.  | 
|  sla\_target\_timestamp  |  Timestamp  |  O carimbo de data/hora do prazo alvo para o SLA, em UTC.  | 
|  tipo\_sla  |  string  |  O tipo de métrica de SLA que está sendo monitorada. Por exemplo, CaseField.  | 
|  sla\_completion\_timestamp  |  Timestamp  |  A data e hora em que o SLA foi concluído, em UTC.  | 
|  sla\_target\_field\_id  |  string  |  O ID do campo que o SLA tem como alvo.  | 
|  valores\_de\_campo de destino do sla\_target  |  array(string)  |  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)  |  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).  | 