View a markdown version of this page

Falldaten im Connect Customer Analytics Data Lake - Amazon Connect-Kunde

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

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;

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.