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
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:
Wenn Sie mit Option 1 nicht auf die Planungstabellen zugreifen können, versuchen Sie es mit Option 2.
Ereignisse im Fall
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 Tabellencase_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
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
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 Tabellenassociated_case_id— Verbindet sich mit case_events (as)case_idcontact_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. |