Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Données de cas dans le lac de données d'analyse Amazon Connect
<a name="data-lake-cases-data"></a>

Cette rubrique détaille le contenu des tableaux de cas relatifs aux lacs de données Amazon Connect. Les tables répertorient la colonne, le type et la description du contenu.

Il existe deux manières d’accéder au lac de données d’analytique et de configurer les données à partager : 
+ [Option 1 : utiliser la console Amazon Connect](access-datalake.md#option1-configure-data-to-be-shared)
+ [Option 2 : utiliser la CLI ou CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

Si vous ne parvenez pas à accéder aux tables de planification à l’aide de l’option 1, essayez d’utiliser l’option 2.

**Topics**
+ [Événements liés à l'affaire](#data-lake-case-events)
+ [Événements liés à un article lié à l'affaire](#data-lake-case-related-item-events)

## Événements liés à l'affaire
<a name="data-lake-case-events"></a>

Nom de la table : `case_events`

Clé primaire composite : {instance\_id, event\_id}


|  **Colonne**  |  **Type**  |  **Description**  | 
| --- | --- | --- | 
|  instance\_id  |  chaîne  |  Identifiant de l’instance Amazon Connect.  | 
|  aws\_account\_id  |  chaîne  |  L'ID du AWS compte propriétaire du dossier.  | 
|  event\_id  |  chaîne  |  L'identifiant unique de l'événement lié au cas.  | 
|  case\_id  |  chaîne  |  L'identifiant de l'affaire.  | 
|  event\_timestamp  |  Horodatage  |  Horodatage auquel l'événement s'est produit, en UTC.  | 
|  identifiant\_de\_champs modifiés  |  array(string)  |  Liste des champs IDs qui ont été modifiés lors de cet événement.  | 
|  event\_type  |  chaîne  |  Type d’événement. Valeurs valides : CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  réalisé par iam\_principal  |  chaîne  |  L'ARN principal IAM de l'entité qui a déclenché l'événement.  | 
|  exécuté par l'utilisateur\_arn  |  chaîne  |  L'ARN de l'utilisateur qui a effectué l'action.  | 
|  réalisé par une entité personnalisée  |  chaîne  |  Entité personnalisée qui a effectué l'action.  | 
|  cases\_domain\_arn  |  chaîne  |  L'ARN du domaine Amazon Connect Cases.  | 
|  identifiant du modèle  |  chaîne  |  ID du modèle de dossier utilisé pour créer le dossier.  | 
|  nom\_modèle  |  chaîne  |  Nom du modèle de dossier. Cette valeur est vide si le modèle a été supprimé.  | 
|  last\_updated\_user  |  chaîne  |  Le dernier utilisateur qui a mis à jour le dossier. Cela fait référence à la valeur last\_updated\_user du champ système.  | 
|  reference\_number  |  chaîne  |  Le numéro de référence lisible par l'homme du boîtier. Cela fait référence à la valeur reference\_number du champ système.  | 
|  status  |  chaîne  |  L'état de l'affaire. Cela fait référence à la valeur status du champ système.  | 
|  assigned\_user  |  chaîne  |  L'ARN de l'utilisateur affecté au dossier. Cela fait référence à la valeur assigned\_user du champ système.  | 
|  assigned\_queue  |  chaîne  |  L'ARN de la file d'attente affectée au dossier. Cela fait référence à la valeur assigned\_queue du champ système.  | 
|  case\_reason  |  chaîne  |  La raison de l'ouverture du boîtier. Cela fait référence à la valeur case\_reason du champ système.  | 
|  titre du dossier  |  chaîne  |  Titre de l'affaire. Cela fait référence à la valeur title du champ système.  | 
|  résumé du cas  |  chaîne  |  Le résumé de l'affaire. Cela fait référence à la valeur summary du champ système.  | 
|  client\_profil\_arn  |  chaîne  |  L'ARN du profil client associé au dossier. Cela fait référence à la valeur customer\_id du champ système.  | 
|  created\_timestamp  |  Horodatage  |  Horodatage de création du dossier, en UTC. Cela fait référence à la valeur created\_datetime du champ système.  | 
|  last\_updated\_timestamp  |  Horodatage  |  Horodatage de la dernière mise à jour du dossier, en UTC. Cela fait référence à la valeur last\_updated\_datetime du champ système.  | 
|  next\_sla\_breach\_timestamp  |  Horodatage  |  Horodatage de la prochaine date limite de violation du SLA, en UTC. Cela fait référence à la valeur next\_sla\_breach\_datetime du champ système.  | 
|  horodatage dernier\_fermé  |  Horodatage  |  Horodatage de la dernière clôture du dossier, en UTC. Cela fait référence à la valeur last\_closed\_datetime du champ système.  | 
|  horodatage de la dernière réouverture  |  Horodatage  |  Horodatage de la dernière réouverture du dossier, en UTC. Cela fait référence à la valeur last\_reopened\_datetime du champ système.  | 
|  custom\_fields  |  tableau (structure)  |  Un tableau d'objets contenant des données de champ personnalisées associées au dossier. Chaque objet inclut le champ id, field\_name et un champ de valeur spécifique au type (string\_value, double\_value, boolean\_value ou timestamp\_value).  | 

### Exemples de requêtes
<a name="data-lake-case-events-sample-queries"></a>

L'exemple de requête suivant dans Athena crée une vue qui aplatit les champs personnalisés de la table des événements de cas :

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

L'exemple suivant crée une vue qui renvoie l'état le plus récent pour chaque cas :

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

## Événements liés à un article lié à l'affaire
<a name="data-lake-case-related-item-events"></a>

Nom de la table : `case_related_item_events`

Clé primaire composite : {instance\_id, event\_id}


|  **Colonne**  |  **Type**  |  **Description**  | 
| --- | --- | --- | 
|  instance\_id  |  chaîne  |  Identifiant de l’instance Amazon Connect.  | 
|  aws\_account\_id  |  chaîne  |  L'ID du AWS compte propriétaire de l'article associé.  | 
|  event\_id  |  chaîne  |  ID unique de l'événement lié à l'article.  | 
|  identifiant\_article associé  |  chaîne  |  L'ID de l'article associé.  | 
|  event\_timestamp  |  Horodatage  |  Horodatage auquel l'événement s'est produit, en UTC.  | 
|  event\_type  |  chaîne  |  Type d’événement. Valeurs valides : CASE.RELATED\_ITEM.CREATED, CASE.RELATED\_ITEM.UPDATED, CASE.RELATED\_ITEM.DELETED.  | 
|  réalisé par iam\_principal  |  chaîne  |  L'ARN principal IAM de l'entité qui a déclenché l'événement.  | 
|  exécuté par l'utilisateur\_arn  |  chaîne  |  L'ARN de l'utilisateur qui a effectué l'action.  | 
|  réalisé par une entité personnalisée  |  chaîne  |  Identifiant d'entité personnalisé qui a effectué l'action.  | 
|  cases\_domain\_arn  |  chaîne  |  L'ARN du domaine Amazon Connect Cases.  | 
|  identifiant\_cas\_associé  |  chaîne  |  L'ID du dossier auquel cet élément associé est associé.  | 
|  type\_d'article connexe  |  chaîne  |  Type d'article connexe. Valeurs valides : comment, file, sla, connect, contact, custom.  | 
|  created\_timestamp  |  Horodatage  |  Horodatage de création de l'élément associé, en UTC.  | 
|  corps du commentaire  |  chaîne  |  Le corps du texte du commentaire.  | 
|  type\_contenu\_commentaire  |  chaîne  |  Type de contenu du corps du commentaire. Par exemple, Text/Plain.  | 
|  identifiant\_cas\_associé  |  chaîne  |  L'identifiant du dossier concerné.  | 
|  contact\_channel  |  chaîne  |  Le canal de communication du contact. Par exemple, VOICE, CHAT, TASK, EMAIL.  | 
|  contact\_id  |  chaîne  |  ID du contact.  | 
|  file\_arn  |  chaîne  |  L'ARN de la pièce jointe.  | 
|  nom\_sla  |  chaîne  |  Le nom du SLA.  | 
|  status du contrat de service  |  chaîne  |  État actuel du SLA. Par exemple, actif, en retard, atteint, non respecté.  | 
|  horodatage sla\_target\_  |  Horodatage  |  Horodatage de la date limite cible pour le SLA, en UTC.  | 
|  type de sla  |  chaîne  |  Type de métrique SLA faisant l'objet du suivi. Par exemple, CaseField.  | 
|  horodatage de fin de la session  |  Horodatage  |  Horodatage de la fin du SLA, en UTC.  | 
|  sla\_target\_field\_id  |  chaîne  |  L'ID du champ ciblé par le SLA.  | 
|  sla\_target\_field\_values  |  array(string)  |  Les valeurs du champ cible pour le sla\_target\_field\_id afin que le SLA soit complété.  | 
|  champ\_item\_relatifs\_personnalisés  |  tableau (structure)  |  Tableau d'objets contenant des données de champ personnalisées associées à l'élément associé. Chaque objet inclut le champ id, field\_name et un champ de valeur spécifique au type (string\_value, double\_value, boolean\_value ou timestamp\_value).  |