Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Casi e dati nel data lake di analisi Amazon Connect
<a name="data-lake-cases-data"></a>

Questo argomento descrive in dettaglio il contenuto delle tabelle dei casi di data lake di Amazon Connect. Ogni tabella elenca la colonna, il tipo e la descrizione del contenuto.

Per accedere al data lake di analisi e configurare i dati da condividere, è possibile procedere in due modi: 
+ [Opzione 1: utilizzare la console Amazon Connect.](access-datalake.md#option1-configure-data-to-be-shared)
+ [Opzione 2: utilizzare CLI o CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

Se non riesci ad accedere alle tabelle di pianificazione utilizzando l’opzione 1, prova a utilizzare l’opzione 2.

**Topics**
+ [Eventi relativi ai casi](#data-lake-case-events)
+ [Eventi relativi agli articoli correlati al caso](#data-lake-case-related-item-events)

## Eventi relativi ai casi
<a name="data-lake-case-events"></a>

Nome della tabella: `case_events`

Chiave primaria composita: {instance\_id, event\_id}


|  **Colonna**  |  **Tipo**  |  **Descrizione**  | 
| --- | --- | --- | 
|  instance\_id  |  stringa  |  L’ID dell’istanza Amazon Connect.  | 
|  aws\_account\_id  |  stringa  |  L'ID dell' AWS account proprietario della custodia.  | 
|  event\_id  |  stringa  |  L'ID univoco dell'evento case.  | 
|  case\_id  |  stringa  |  L'ID del caso.  | 
|  event\_timestamp  |  Time stamp  |  Il timestamp in cui si è verificato l'evento, in UTC.  | 
|  changed\_field\_ids  |  array(string)  |  L'elenco dei campi IDs che sono stati modificati in questo evento.  | 
|  event\_type  |  stringa  |  Tipo di evento. Valori validi: CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  eseguito\_da\_iam\_principal  |  stringa  |  L'ARN principale IAM dell'entità che ha attivato l'evento.  | 
|  eseguito da user\_arn  |  stringa  |  L'ARN dell'utente che ha eseguito l'azione.  | 
|  eseguito da un'entità personalizzata  |  stringa  |  L'entità personalizzata che ha eseguito l'azione.  | 
|  cases\_domain\_arn  |  stringa  |  L'ARN del dominio Amazon Connect Cases.  | 
|  template\_id  |  stringa  |  L'ID del modello di caso utilizzato per creare il caso.  | 
|  nome\_modello  |  stringa  |  Il nome del modello del caso. Questo valore è vuoto se il modello è stato eliminato.  | 
|  last\_updated\_user  |  stringa  |  L'ultimo utente che ha aggiornato il caso. Questo fa riferimento al valore last\_updated\_user del campo di sistema.  | 
|  reference\_number  |  stringa  |  Il numero di riferimento leggibile dall'uomo per il caso. Fa riferimento al valore del campo di reference\_number sistema.  | 
|  status  |  stringa  |  Lo stato del caso. Questo fa riferimento al valore status del campo di sistema.  | 
|  assigned\_user  |  stringa  |  L'ARN dell'utente assegnato al caso. Fa riferimento al valore del campo di assigned\_user sistema.  | 
|  assigned\_queue  |  stringa  |  L'ARN della coda assegnata al caso. Fa riferimento al valore del campo assigned\_queue di sistema.  | 
|  case\_reason  |  stringa  |  Il motivo per cui è stata aperta la custodia. Questo fa riferimento al valore case\_reason del campo di sistema.  | 
|  case\_title  |  stringa  |  Il titolo del caso. Fa riferimento al valore title del campo di sistema.  | 
|  riepilogo del caso  |  stringa  |  Il riepilogo del caso. Questo fa riferimento al valore summary del campo di sistema.  | 
|  customer\_profile\_arn  |  stringa  |  L'ARN del profilo cliente associato al caso. Questo fa riferimento al valore del campo di customer\_id sistema.  | 
|  created\_timestamp  |  Time stamp  |  Il timestamp in cui è stato creato il caso, in UTC. Questo fa riferimento al valore del campo di created\_datetime sistema.  | 
|  last\_updated\_timestamp  |  Time stamp  |  Il timestamp dell'ultimo aggiornamento del caso, in UTC. Questo fa riferimento al valore del campo di last\_updated\_datetime sistema.  | 
|  next\_sla\_breach\_timestamp  |  Time stamp  |  Il timestamp della prossima scadenza per la violazione dello SLA, in UTC. Questo fa riferimento al valore del campo di sistema. next\_sla\_breach\_datetime  | 
|  last\_closed\_timestamp  |  Time stamp  |  Il timestamp dell'ultima chiusura del caso, in UTC. Fa riferimento al valore del campo di last\_closed\_datetime sistema.  | 
|  last\_reopened\_timestamp  |  Time stamp  |  Il timestamp dell'ultima riapertura del caso, in UTC. Fa riferimento al valore del last\_reopened\_datetime campo di sistema.  | 
|  custom\_fields  |  array (struttura)  |  Una matrice di oggetti contenente dati di campo personalizzati associati al caso. Ogni oggetto include il campo id, field\_name e un campo di valori specifico del tipo (string\_value, double\_value, boolean\_value o timestamp\_value).  | 

### Query di esempio
<a name="data-lake-case-events-sample-queries"></a>

La seguente query di esempio in Athena crea una vista che appiattisce i campi personalizzati dalla tabella degli eventi dei casi:

```
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'esempio seguente crea una visualizzazione che restituisce lo stato più recente per ogni 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;
```

## Eventi relativi agli articoli correlati al caso
<a name="data-lake-case-related-item-events"></a>

Nome della tabella: `case_related_item_events`

Chiave primaria composita: {instance\_id, event\_id}


|  **Colonna**  |  **Tipo**  |  **Descrizione**  | 
| --- | --- | --- | 
|  instance\_id  |  stringa  |  L’ID dell’istanza Amazon Connect.  | 
|  aws\_account\_id  |  stringa  |  L'ID dell' AWS account proprietario dell'articolo correlato.  | 
|  event\_id  |  stringa  |  L'ID univoco dell'evento relativo all'elemento.  | 
|  related\_item\_id  |  stringa  |  L'ID dell'articolo correlato.  | 
|  event\_timestamp  |  Time stamp  |  Il timestamp in cui si è verificato l'evento, in UTC.  | 
|  event\_type  |  stringa  |  Tipo di evento. Valori validi: CASE.RELATED\_ITEM.CREATED, CASE.RELATED\_ITEM.UPDATED, CASE.RELATED\_ITEM.DELETED.  | 
|  eseguito\_da\_iam\_principal  |  stringa  |  L'ARN principale IAM dell'entità che ha attivato l'evento.  | 
|  eseguito da user\_arn  |  stringa  |  L'ARN dell'utente che ha eseguito l'azione.  | 
|  eseguito da un'entità personalizzata  |  stringa  |  L'identificatore di entità personalizzato che ha eseguito l'azione.  | 
|  cases\_domain\_arn  |  stringa  |  L'ARN del dominio Amazon Connect Cases.  | 
|  associated\_case\_id  |  stringa  |  L'ID del caso a cui è associato questo elemento correlato.  | 
|  tipo\_elemento correlato  |  stringa  |  Il tipo di elemento correlato. Valori validi: comment, file, sla, connect, contact, custom.  | 
|  created\_timestamp  |  Time stamp  |  Il timestamp in cui è stato creato l'elemento correlato, in UTC.  | 
|  comment\_body  |  stringa  |  Il corpo del testo del commento.  | 
|  comment\_content\_type  |  stringa  |  Il tipo di contenuto del corpo del commento. Ad esempio, Text/Plain.  | 
|  related\_case\_id  |  stringa  |  L'ID del caso correlato.  | 
|  contact\_channel  |  stringa  |  Il canale di comunicazione del contatto. Ad esempio, VOICE, CHAT, TASK, EMAIL.  | 
|  contact\_id  |  stringa  |  ID del contatto.  | 
|  file\_arn  |  stringa  |  L'ARN del file allegato.  | 
|  sla\_name  |  stringa  |  Il nome dello SLA.  | 
|  sla\_status  |  stringa  |  Lo stato attuale dello SLA. Ad esempio, active, scaduto, met, notmet.  | 
|  sla\_target\_timestamp  |  Time stamp  |  Il timestamp della scadenza prevista per lo SLA, in UTC.  | 
|  sla\_type  |  stringa  |  Il tipo di metrica SLA monitorata. Ad esempio,. CaseField  | 
|  sla\_completion\_timestamp  |  Time stamp  |  Il timestamp in cui è stato completato lo SLA, in UTC.  | 
|  sla\_target\_field\_id  |  stringa  |  L'ID del campo a cui si rivolge lo SLA.  | 
|  sla\_target\_field\_values  |  array(string)  |  I valori dei campi di destinazione per sla\_target\_field\_id per il completamento dello SLA.  | 
|  custom\_related\_item\_fields  |  array (struttura)  |  Una matrice di oggetti contenente dati di campo personalizzati associati all'elemento correlato. Ogni oggetto include il campo id, field\_name e un campo di valore specifico del tipo (string\_value, double\_value, boolean\_value o timestamp\_value).  |