

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Falldaten im Connect Customer Analytics Data Lake
<a name="data-lake-cases-data"></a>

In diesem Thema wird der Inhalt der Falltabellen von Connect Customer Data Lake detailliert beschrieben. In den Tabellen sind die Spalte, der Typ und die Beschreibung des Inhalts aufgeführt.

Es gibt zwei Möglichkeiten, auf den Analytics Data Lake zuzugreifen und Daten für die gemeinsame Nutzung zu konfigurieren: 
+ [Option 1: Verwenden Sie die Connect Customer-Konsole](access-datalake.md#option1-configure-data-to-be-shared)
+ [Option 2: Verwenden Sie CLI oder CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

Wenn Sie mit Option 1 nicht auf die Planungstabellen zugreifen können, versuchen Sie es mit Option 2.

**Topics**
+ [Ereignisse im Fall](#data-lake-case-events)
+ [Ereignisse, die sich auf einen Fall beziehen](#data-lake-case-related-item-events)

## Ereignisse im Fall
<a name="data-lake-case-events"></a>

**Name der Tabelle: ** `case_events`

**Beschreibung: ** Zeichnet Ereignisse im Fallzyklus auf (erstellt, aktualisiert, gelöscht), einschließlich Fallmetadaten, Statusänderungen, Vorlageninformationen und benutzerdefinierten Feldwerten für Connect Cases.

**Primärschlüssel: ** `instance_id, event_id`

**Partitionsschlüssel: ** `event_timestamp` (täglich)

**Schlüssel verbinden: **
+ `instance_id`— Verbindet sich mit allen Tabellen
+ `case_id`— Verbindet sich mit case\_related\_item\_events (as) `associated_case_id`


|  **Spalte**  |  **Typ**  |  **Auf Null setzbar **  |  **Beschreibung**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  Zeichenfolge  |  Nein  |  Die ID der Connect Customer-Instanz.  | 
|  aws\_account\_id  |  Zeichenfolge  |  Ja  |  Die ID des AWS Kontos, dem der Fall gehört.  | 
|  event\_id  |  Zeichenfolge  |  Nein  |  Die eindeutige ID des Fallereignisses.  | 
|  case\_id  |  Zeichenfolge  |  Ja  |  Die ID des Falls.  | 
|  event\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, zu dem das Ereignis eingetreten ist, in UTC.  | 
|  changed\_field\_ids  |  array(string)  |  Ja  |  Die Liste der Feld-IDs, die bei diesem Ereignis geändert wurden.  | 
|  event\_type  |  Zeichenfolge  |  Ja  |  Der Ereignistyp. Gültige Werte: CASE.CREATED, CASE.UPDATED, CASE.DELETED.  | 
|  Durchgeführt von\_iam\_principal  |  Zeichenfolge  |  Ja  |  Der IAM-Prinzipal-ARN der Entität, die das Ereignis ausgelöst hat.  | 
|  Durchgeführt von\_user\_arn  |  Zeichenfolge  |  Ja  |  Die ARN des Benutzers, der die Aktion ausgeführt hat.  | 
|  Durchgeführt von\_custom\_entity  |  Zeichenfolge  |  Ja  |  Die benutzerdefinierte Entität, die die Aktion ausgeführt hat.  | 
|  cases\_domain\_arn  |  Zeichenfolge  |  Ja  |  Der ARN der Domain Connect Customer Cases.  | 
|  template\_id  |  Zeichenfolge  |  Ja  |  Die ID der Fallvorlage, die zur Erstellung des Falls verwendet wurde.  | 
|  Name der Vorlage  |  Zeichenfolge  |  Ja  |  Der Name der Fallvorlage. Dieser Wert ist leer, wenn die Vorlage gelöscht wurde.  | 
|  last\_updated\_user  |  Zeichenfolge  |  Ja  |  Der letzte Benutzer, der den Fall aktualisiert hat. Dies bezieht sich auf den last\_updated\_user Systemfeldwert.  | 
|  reference\_number  |  Zeichenfolge  |  Ja  |  Die für Menschen lesbare Referenznummer für den Fall. Dies verweist auf den reference\_number Systemfeldwert.  | 
|  Status  |  Zeichenfolge  |  Ja  |  Der Status des Falls. Dies bezieht sich auf den status Systemfeldwert.  | 
|  assigned\_user  |  Zeichenfolge  |  Ja  |  Die ARN des Benutzers, der dem Fall zugewiesen ist. Dies verweist auf den assigned\_user Systemfeldwert.  | 
|  assigned\_queue  |  Zeichenfolge  |  Ja  |  Die ARN der Warteschlange, die dem Fall zugewiesen ist. Dies verweist auf den assigned\_queue Systemfeldwert.  | 
|  case\_reason  |  Zeichenfolge  |  Ja  |  Der Grund für die Eröffnung des Gehäuses. Dies bezieht sich auf den case\_reason Systemfeldwert.  | 
|  case\_title  |  Zeichenfolge  |  Ja  |  Der Titel des Falls. Dies bezieht sich auf den title Systemfeldwert.  | 
|  case\_summary  |  Zeichenfolge  |  Ja  |  Die Zusammenfassung des Falls. Dies bezieht sich auf den summary Systemfeldwert.  | 
|  customer\_profile\_arn  |  Zeichenfolge  |  Ja  |  Die ARN des Kundenprofils, das dem Fall zugeordnet ist. Dies bezieht sich auf den customer\_id Systemfeldwert.  | 
|  created\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, zu dem der Fall erstellt wurde, in UTC. Dies verweist auf den created\_datetime Systemfeldwert.  | 
|  last\_updated\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, an dem der Fall zuletzt aktualisiert wurde, in UTC. Dies verweist auf den last\_updated\_datetime Systemfeldwert.  | 
|  next\_sla\_breach\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel der Frist für die nächste SLA-Verletzung in UTC. Dies bezieht sich auf den next\_sla\_breach\_datetime Systemfeldwert.  | 
|  last\_closed\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, an dem der Fall zuletzt geschlossen wurde, in UTC. Dies verweist auf den last\_closed\_datetime Systemfeldwert.  | 
|  last\_reopened\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, zu dem der Fall zuletzt erneut geöffnet wurde, in UTC. Dies verweist auf den last\_reopened\_datetime Systemfeldwert.  | 
|  custom\_fields  |  Array (Struktur)  |  Ja  |  Ein Array von Objekten, das benutzerdefinierte Felddaten enthält, die dem Fall zugeordnet sind. Jedes Objekt enthält das Feld id, field\_name und ein typspezifisches Wertfeld (string\_value, double\_value, boolean\_value oder timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Zeitstempel  |  Ja  |  Zeitstempel, der anzeigt, wann der Data Lake den Datensatz zuletzt verarbeitet hat. Dies kann Transformation und Backfill beinhalten. Dieses Feld kann nicht zuverlässig zur Bestimmung der Datenaktualität verwendet werden.  | 

### Beispielabfragen
<a name="data-lake-case-events-sample-queries"></a>

Die folgende Beispielabfrage in Athena erstellt eine Ansicht, die benutzerdefinierte Felder aus der Fallereignis-Tabelle vereinfacht:

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

Im folgenden Beispiel wird eine Ansicht erstellt, die für jeden Fall den neuesten Status zurückgibt:

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

## Ereignisse, die sich auf einen Fall beziehen
<a name="data-lake-case-related-item-events"></a>

**Name der Tabelle: ** `case_related_item_events`

**Beschreibung: ** Zeichnet Ereignisse für Elemente auf, die sich auf Kundenvorgänge beziehen, einschließlich Kommentare, Kontakte, Dateianhänge, SLA-Tracking und benutzerdefinierte verwandte Elemente.

**Primärschlüssel: ** `instance_id, event_id`

**Partitionsschlüssel: ** `event_timestamp` (täglich)

**Schlüssel verbinden: **
+ `instance_id`— Verbindet sich mit allen Tabellen
+ `associated_case_id`— Verbindet sich mit case\_events (as) `case_id`
+ `contact_id`— Schließt sich dem Kontaktdatensatz an


|  **Spalte**  |  **Typ**  |  **Nullfähig **  |  **Beschreibung**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  Zeichenfolge  |  Nein  |  Die ID der Connect Customer-Instanz.  | 
|  aws\_account\_id  |  Zeichenfolge  |  Ja  |  Die ID des AWS Kontos, dem der zugehörige Artikel gehört.  | 
|  event\_id  |  Zeichenfolge  |  Nein  |  Die eindeutige ID des Ereignisses für den zugehörigen Artikel.  | 
|  related\_item\_id  |  Zeichenfolge  |  Ja  |  Die ID des zugehörigen Artikels.  | 
|  event\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, zu dem das Ereignis eingetreten ist, in UTC.  | 
|  event\_type  |  Zeichenfolge  |  Ja  |  Der Ereignistyp. Gültige Werte: CASE.RELATED \_ITEM.CREATED, CASE.RELATED \_ITEM.UPDATED, CASE.RELATED \_ITEM.DELETED.  | 
|  durchführt\_von\_iam\_principal  |  Zeichenfolge  |  Ja  |  Der IAM-Prinzipal-ARN der Entität, die das Ereignis ausgelöst hat.  | 
|  Durchgeführt von\_user\_arn  |  Zeichenfolge  |  Ja  |  Die ARN des Benutzers, der die Aktion ausgeführt hat.  | 
|  Durchgeführt von\_custom\_entity  |  Zeichenfolge  |  Ja  |  Die benutzerdefinierte Entitäts-ID, die die Aktion ausgeführt hat.  | 
|  cases\_domain\_arn  |  Zeichenfolge  |  Ja  |  Der ARN der Domain Connect Customer Cases.  | 
|  assoziierte\_fall\_id  |  Zeichenfolge  |  Ja  |  Die ID des Falls, dem dieser zugehörige Artikel zugeordnet ist.  | 
|  related\_item\_type  |  Zeichenfolge  |  Ja  |  Der Typ des verwandten Artikels. Gültige Werte: Kommentar, Datei, SLA, Connect, Kontakt, Benutzerdefiniert.  | 
|  created\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, zu dem das zugehörige Element erstellt wurde, in UTC.  | 
|  comment\_body  |  Zeichenfolge  |  Ja  |  Der Haupttext des Kommentars.  | 
|  Inhaltstyp des Kommentars  |  Zeichenfolge  |  Ja  |  Der Inhaltstyp des Kommentartextes. Zum Beispiel Text/Plain.  | 
|  related\_case\_id  |  Zeichenfolge  |  Ja  |  Die ID des zugehörigen Falls.  | 
|  Kontakt\_Kanal  |  Zeichenfolge  |  Ja  |  Der Kommunikationskanal des Kontakts. Zum Beispiel VOICE, CHAT, TASK, EMAIL.  | 
|  contact\_id  |  Zeichenfolge  |  Ja  |  Die ID des Kontakts.  | 
|  file\_arn  |  Zeichenfolge  |  Ja  |  Der ARN des Dateianhangs.  | 
|  sla\_name  |  Zeichenfolge  |  Ja  |  Der Name des SLA.  | 
|  sla\_status  |  Zeichenfolge  |  Ja  |  Der aktuelle Status des SLA. Zum Beispiel aktiv, überfällig, erfüllt, nicht erfüllt.  | 
|  sla\_target\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel der Zielfrist für das SLA in UTC.  | 
|  sla\_type  |  Zeichenfolge  |  Ja  |  Der Typ der SLA-Metrik, die verfolgt wird. Zum Beispiel. CaseField  | 
|  sla\_completion\_timestamp  |  Zeitstempel  |  Ja  |  Der Zeitstempel, an dem das SLA abgeschlossen wurde, in UTC.  | 
|  sla\_target\_field\_id  |  Zeichenfolge  |  Ja  |  Die ID des Felds, auf das das SLA abzielt.  | 
|  sla\_target\_field\_values  |  array(string)  |  Ja  |  Die Zielfeldwerte für sla\_target\_field\_id, damit das SLA abgeschlossen werden kann.  | 
|  custom\_related\_item\_fields  |  Array (Struktur)  |  Ja  |  Ein Array von Objekten, das benutzerdefinierte Felddaten enthält, die dem zugehörigen Element zugeordnet sind. Jedes Objekt enthält das Feld id, field\_name und ein typspezifisches Wertfeld (string\_value, double\_value, boolean\_value oder timestamp\_value).  | 
|  data\_lake\_last\_processed\_timestamp  |  Zeitstempel  |  Ja  |  Zeitstempel, der anzeigt, wann der Data Lake den Datensatz zuletzt verarbeitet hat. Dies kann Transformation und Backfill beinhalten. Dieses Feld kann nicht zuverlässig zur Bestimmung der Datenaktualität verwendet werden.  | 