Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Datos de casos en el lago de datos analíticos de Connect Customer
<a name="data-lake-cases-data"></a>

En este tema se detalla el contenido de las tablas de casos del lago de datos de Connect Customer. Las tablas enumeran la columna, el tipo y la descripción del contenido.

Hay dos formas de acceder al lago de datos de análisis y configurar los datos que se van a compartir: 
+ [Opción 1: utilice la consola Connect Customer](access-datalake.md#option1-configure-data-to-be-shared)
+ [Opción 2: utilice la CLI o CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

Si no puede acceder a las tablas de programación mediante la opción 1, intente utilizar la opción 2.

**Topics**
+ [Casos y eventos](#data-lake-case-events)
+ [Eventos de artículos relacionados con el caso](#data-lake-case-related-item-events)

## Casos y eventos
<a name="data-lake-case-events"></a>

**Nombre de la tabla: ** `case_events`

**Descripción: ** registra los eventos del ciclo de vida de los casos (creados, actualizados y eliminados), incluidos los metadatos de los casos, los cambios de estado, la información de las plantillas y los valores de los campos personalizados para Connect Cases.

**Clave principal: ** `instance_id, event_id`

**Clave de partición: ** `event_timestamp` (diaria)

**Teclas de unión: **
+ `instance_id`— Se une a todas las tablas
+ `case_id`— Se une a case\_related\_item\_events (como) `associated_case_id`


|  **Columna**  |  **Tipo**  |  **Se puede anular **  |  **Descripción**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  cadena  |  No  |  El ID de la instancia de Connect Customer.  | 
|  aws\_account\_id  |  cadena  |  Sí  |  El ID de la AWS cuenta propietaria del caso.  | 
|  event\_id  |  cadena  |  No  |  El identificador único del evento del caso.  | 
|  case\_id  |  cadena  |  Sí  |  El identificador del caso.  | 
|  event\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que ocurrió el evento, en UTC.  | 
|  changed\_field\_ids  |  array(string)  |  Sí  |  La lista de ID de campo que se modificaron en este evento.  | 
|  event\_type  |  cadena  |  Sí  |  El tipo de evento. Valores válidos: CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  performed\_by\_iam\_principal  |  cadena  |  Sí  |  El ARN principal de IAM de la entidad que desencadenó el evento.  | 
|  performed\_by\_user\_arn  |  cadena  |  Sí  |  El ARN del usuario que realizó la acción.  | 
|  performed\_by\_custom\_entity  |  cadena  |  Sí  |  La entidad personalizada que realizó la acción.  | 
|  cases\_domain\_arn  |  cadena  |  Sí  |  El ARN del dominio Connect Customer Cases.  | 
|  template\_id  |  cadena  |  Sí  |  El ID de la plantilla de caso utilizada para crear el caso.  | 
|  template\_name  |  cadena  |  Sí  |  El nombre de la plantilla de caso. Este valor está vacío si se ha eliminado la plantilla.  | 
|  last\_updated\_user  |  cadena  |  Sí  |  El último usuario que actualizó el caso. Esto hace referencia al valor last\_updated\_user del campo del sistema.  | 
|  reference\_number  |  cadena  |  Sí  |  El número de referencia legible por humanos del caso. Esto hace referencia al valor reference\_number del campo del sistema.  | 
|  status  |  cadena  |  Sí  |  El estado del caso. Esto hace referencia al valor status del campo del sistema.  | 
|  assigned\_user  |  cadena  |  Sí  |  El ARN del usuario asignado al caso. Esto hace referencia al valor assigned\_user del campo del sistema.  | 
|  assigned\_queue  |  cadena  |  Sí  |  El ARN de la cola asignada al caso. Esto hace referencia al valor del campo assigned\_queue del sistema.  | 
|  case\_reason  |  cadena  |  Sí  |  El motivo de la apertura del caso. Esto hace referencia al valor case\_reason del campo del sistema.  | 
|  case\_title  |  cadena  |  Sí  |  El título del caso. Esto hace referencia al valor title del campo del sistema.  | 
|  case\_summary  |  cadena  |  Sí  |  El resumen del caso. Esto hace referencia al valor summary del campo del sistema.  | 
|  customer\_profile\_arn  |  cadena  |  Sí  |  El ARN del perfil del cliente asociado al caso. Esto hace referencia al valor customer\_id del campo del sistema.  | 
|  created\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se creó el caso, en UTC. Esto hace referencia al valor del campo created\_datetime del sistema.  | 
|  last\_updated\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se actualizó el caso por última vez, en UTC. Esto hace referencia al valor del campo last\_updated\_datetime del sistema.  | 
|  next\_sla\_breach\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo de la próxima fecha límite de incumplimiento del SLA, en UTC. Esto hace referencia al valor del campo del next\_sla\_breach\_datetime sistema.  | 
|  last\_closed\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se cerró el caso por última vez, en UTC. Esto hace referencia al valor del campo last\_closed\_datetime del sistema.  | 
|  last\_reopened\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se reabrió el caso por última vez, en UTC. Esto hace referencia al valor del campo del last\_reopened\_datetime sistema.  | 
|  custom\_fields  |  matriz (estructura)  |  Sí  |  Conjunto de objetos que contienen datos de campo personalizados asociados al caso. Cada objeto incluye el identificador del campo, el nombre\_campo y un campo de valor específico para cada tipo (string\_value, double\_value, boolean\_value o timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  Sí  |  Marca de tiempo que muestra la última vez que el lago de datos procesó el registro. Esto puede incluir la transformación y la reposición. Este campo no se puede utilizar de forma fiable para determinar la actualidad de los datos.  | 

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

El siguiente ejemplo de consulta en Athena crea una vista que aplana los campos personalizados de la tabla de eventos de casos:

```
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)
```

El siguiente ejemplo crea una vista que devuelve el estado más reciente 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 artículos relacionados con el caso
<a name="data-lake-case-related-item-events"></a>

**Nombre de la tabla: ** `case_related_item_events`

**Descripción: ** registra los eventos relacionados con los casos, incluidos los comentarios, los contactos, los archivos adjuntos, el seguimiento de los SLA y los elementos relacionados personalizados.

**Clave principal: ** `instance_id, event_id`

**Clave de partición: ** `event_timestamp` (diaria)

**Teclas de unión: **
+ `instance_id`— Se une a todas las tablas
+ `associated_case_id`— Se une a case\_events (as) `case_id`
+ `contact_id`— Se une al registro de contactos


|  **Columna**  |  **Tipo**  |  **Se puede anular **  |  **Descripción**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  cadena  |  No  |  El ID de la instancia de Connect Customer.  | 
|  aws\_account\_id  |  cadena  |  Sí  |  El ID de la AWS cuenta propietaria del artículo relacionado.  | 
|  event\_id  |  cadena  |  No  |  El identificador único del evento del artículo relacionado.  | 
|  related\_item\_id  |  cadena  |  Sí  |  El ID del artículo relacionado.  | 
|  event\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que ocurrió el evento, en UTC.  | 
|  event\_type  |  cadena  |  Sí  |  El tipo de evento. Valores válidos: CASE.RELATED \_ITEM.CREATED, \_ITEM.UPDATED, CASE.RELATED CASE.RELATED \_. ITEM.DELETED  | 
|  Realizado por iam\_principal  |  cadena  |  Sí  |  El ARN principal de IAM de la entidad que desencadenó el evento.  | 
|  performed\_by\_user\_arn  |  cadena  |  Sí  |  El ARN del usuario que realizó la acción.  | 
|  performed\_by\_custom\_entity  |  cadena  |  Sí  |  El identificador de entidad personalizado que realizó la acción.  | 
|  cases\_domain\_arn  |  cadena  |  Sí  |  El ARN del dominio Connect Customer Cases.  | 
|  associated\_case\_id  |  cadena  |  Sí  |  El ID del caso al que está asociado este artículo relacionado.  | 
|  related\_item\_type  |  cadena  |  Sí  |  El tipo de elemento relacionado. Valores válidos: comentario, archivo, acuerdo de nivel de servicio, conexión, contacto, personalizado.  | 
|  created\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se creó el elemento relacionado, en UTC.  | 
|  comment\_body  |  cadena  |  Sí  |  El cuerpo del texto del comentario.  | 
|  comment\_content\_type  |  cadena  |  Sí  |  El tipo de contenido del cuerpo del comentario. Por ejemplo, Text/Plain.  | 
|  related\_case\_id  |  cadena  |  Sí  |  El ID del caso relacionado.  | 
|  contact\_channel  |  cadena  |  Sí  |  El canal de comunicación del contacto. Por ejemplo, VOZ, CHAT, TAREA, CORREO ELECTRÓNICO.  | 
|  contact\_id  |  cadena  |  Sí  |  El ID del contacto.  | 
|  file\_arn  |  cadena  |  Sí  |  El ARN del archivo adjunto.  | 
|  sla\_name  |  cadena  |  Sí  |  El nombre del SLA.  | 
|  sla\_status  |  cadena  |  Sí  |  El estado actual del SLA. Por ejemplo, activo, atrasado, cumplido, no cumplido.  | 
|  sla\_target\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo de la fecha límite prevista para el SLA, en UTC.  | 
|  sla\_type  |  cadena  |  Sí  |  El tipo de métrica de SLA que se está rastreando. Por ejemplo, CaseField.  | 
|  sla\_completion\_timestamp  |  Timestamp  |  Sí  |  La marca de tiempo en la que se completó el SLA, en UTC.  | 
|  sla\_target\_field\_id  |  cadena  |  Sí  |  El ID del campo al que se dirige el SLA.  | 
|  sla\_target\_field\_values  |  array(string)  |  Sí  |  Los valores del campo objetivo del sla\_target\_field\_id para completar el SLA.  | 
|  custom\_related\_item\_fields  |  matriz (estructura)  |  Sí  |  Matriz de objetos que contienen datos de campo personalizados asociados al elemento relacionado. Cada objeto incluye el identificador del campo, el nombre\_campo y un campo de valor específico del tipo (string\_value, double\_value, boolean\_value o timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  Sí  |  Marca de tiempo que muestra la última vez que el lago de datos procesó el registro. Esto puede incluir la transformación y la reposición. Este campo no se puede utilizar de forma fiable para determinar la actualidad de los datos.  |