View a markdown version of this page

Data kasus di data lake Connect Customer analytics - Pelanggan Amazon Connect

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Data kasus di data lake Connect Customer analytics

Topik ini merinci konten dalam tabel kasus danau data Connect Customer. Tabel mencantumkan kolom, jenis, dan deskripsi konten.

Ada dua cara untuk mengakses data lake analitik dan mengonfigurasi data yang akan dibagikan:

Jika Anda tidak dapat mengakses tabel penjadwalan dengan menggunakan Opsi 1, coba gunakan Opsi 2.

Peristiwa kasus

Nama tabel: case_events

Deskripsi: Merekam peristiwa siklus hidup kasus (dibuat, diperbarui, dihapus), termasuk metadata kasus, perubahan status, informasi templat, dan nilai bidang khusus untuk Connect Cases.

Kunci utama: instance_id, event_id

Kunci partisi: event_timestamp (harian)

Bergabung kunci:

  • instance_id— Bergabung ke semua tabel

  • case_id— Bergabung ke case_related_item_events (as) associated_case_id

Kolom Jenis Nullable Deskripsi
instance_id string Tidak ID dari instans Connect Customer.
aws_account_id string Ya ID AWS akun yang memiliki kasing.
event_id string Tidak ID unik dari peristiwa kasus.
kasus_id string Ya ID kasus ini.
event_timestamp Stempel waktu Ya Stempel waktu saat peristiwa terjadi, di UTC.
changed_field_ids array (string) Ya Daftar ID bidang yang dimodifikasi dalam acara ini.
event_type string Ya Jenis peristiwa. Nilai yang valid: CASE.CREATED, CASE.UPDATED, CASE.DELETED.
dilakukan_by_iam_principal string Ya ARN utama IAM dari entitas yang memicu peristiwa tersebut.
dilakukan_by_user_arn string Ya ARN dari pengguna yang melakukan tindakan.
performed_by_custom_entity string Ya Entitas kustom yang melakukan tindakan.
kasus_domain_arn string Ya ARN dari domain Connect Customer Cases.
template_id string Ya ID dari template kasus yang digunakan untuk membuat kasus.
template_name string Ya Nama template kasus. Nilai ini kosong jika template telah dihapus.
last_updated_user string Ya Pengguna terakhir yang memperbarui kasus. Ini merujuk pada nilai bidang last_updated_user sistem.
referensi_nomor string Ya Nomor referensi yang dapat dibaca manusia untuk kasus ini. Ini merujuk pada nilai bidang reference_number sistem.
status string Ya Status kasus ini. Ini merujuk pada nilai bidang status sistem.
assigned_user string Ya ARN pengguna yang ditugaskan untuk kasus ini. Ini merujuk pada nilai bidang assigned_user sistem.
assigned_queue string Ya ARN dari antrian yang ditugaskan untuk kasus ini. Ini merujuk pada nilai bidang assigned_queue sistem.
kasus_alasan string Ya Alasan untuk membuka kasus ini. Ini merujuk pada nilai bidang case_reason sistem.
case_title string Ya Judul kasus ini. Ini merujuk pada nilai bidang title sistem.
case_summary string Ya Ringkasan kasus ini. Ini merujuk pada nilai bidang summary sistem.
customer_profile_id string Ya ARN dari profil pelanggan yang terkait dengan kasus ini. Ini merujuk pada nilai bidang customer_id sistem.
created_timestamp Stempel waktu Ya Stempel waktu saat kasing dibuat, di UTC. Ini merujuk pada nilai bidang created_datetime sistem.
last_updated_timestamp Stempel waktu Ya Stempel waktu saat kasus terakhir diperbarui, di UTC. Ini merujuk pada nilai bidang last_updated_datetime sistem.
next_sla_breach_timestamp Stempel waktu Ya Stempel waktu tenggat waktu pelanggaran SLA berikutnya, di UTC. Ini merujuk pada nilai bidang next_sla_breach_datetime sistem.
last_closed_timestamp Stempel waktu Ya Stempel waktu saat kasus terakhir ditutup, di UTC. Ini merujuk pada nilai bidang last_closed_datetime sistem.
last_reopened_timestamp Stempel waktu Ya Stempel waktu saat kasing terakhir dibuka kembali, di UTC. Ini merujuk pada nilai bidang last_reopened_datetime sistem.
custom_fields array (struct) Ya Array objek yang berisi data bidang kustom yang terkait dengan kasus ini. Setiap objek menyertakan id bidang, field_name, dan bidang nilai khusus tipe (string_value, double_value, boolean_value, atau timestamp_value).

Kueri Sampel

Contoh kueri berikut di Athena membuat tampilan yang meratakan bidang kustom dari tabel peristiwa kasus:

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)

Contoh berikut membuat tampilan yang mengembalikan status terbaru untuk setiap kasus:

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;

Nama tabel: case_related_item_events

Deskripsi: Merekam peristiwa untuk item yang terkait dengan kasus, termasuk komentar, kontak, lampiran file, pelacakan SLA, dan item terkait khusus.

Kunci utama: instance_id, event_id

Kunci partisi: event_timestamp (harian)

Bergabung kunci:

  • instance_id— Bergabung ke semua tabel

  • associated_case_id— Bergabung ke case_events (as) case_id

  • contact_id— Bergabung ke Rekaman Kontak

Kolom Jenis Nullable Deskripsi
instance_id string Tidak ID dari instans Connect Customer.
aws_account_id string Ya ID AWS akun yang memiliki item terkait.
event_id string Tidak ID unik dari acara item terkait.
terkait_item_id string Ya ID dari item terkait.
event_timestamp Stempel waktu Ya Stempel waktu saat peristiwa terjadi, di UTC.
event_type string Ya Jenis peristiwa. Nilai yang valid: CASE.RELATED _ITEM.CREATED, CASE.RELATED _ITEM.UPDATED, CASE.RELATED _ITEM.DELETED.
dilakukan_by_iam_principal string Ya ARN utama IAM dari entitas yang memicu peristiwa tersebut.
dilakukan_by_user_arn string Ya ARN dari pengguna yang melakukan tindakan.
performed_by_custom_entity string Ya Pengidentifikasi entitas kustom yang melakukan tindakan.
kasus_domain_arn string Ya ARN dari domain Connect Customer Cases.
associated_case_id string Ya ID kasus yang dikaitkan dengan item terkait ini.
terkait_item_type string Ya Jenis barang terkait. Nilai yang valid: komentar, file, sla, sambungkan, kontak, kustom.
created_timestamp Stempel waktu Ya Stempel waktu saat item terkait dibuat, di UTC.
komentar_body string Ya Teks isi komentar.
comment_content_type string Ya Jenis konten badan komentar. Misalnya, Text/Plain.
related_case_id string Ya ID dari kasus terkait.
contact_channel string Ya Saluran komunikasi kontak. Misalnya, SUARA, OBROLAN, TUGAS, EMAIL.
contact_id string Ya ID kontak.
file_id string Ya ARN dari lampiran file.
sla_nama string Ya Nama SLA.
sla_status string Ya Status SLA saat ini. Misalnya, aktif, terlambat, bertemu, notmet.
sla_target_timestamp Stempel waktu Ya Stempel waktu tenggat waktu target untuk SLA, di UTC.
tipe sla_ string Ya Jenis metrik SLA yang dilacak. Misalnya, CaseField.
sla_completion_timestamp Stempel waktu Ya Stempel waktu saat SLA selesai, di UTC.
sla_target_field_id string Ya ID bidang yang ditargetkan SLA.
sla_target_field_values array (string) Ya Nilai bidang target untuk sla_target_field_id agar SLA selesai.
custom_related_item_fields array (struct) Ya Array objek yang berisi data bidang kustom yang terkait dengan item terkait. Setiap objek menyertakan id bidang, field_name, dan bidang nilai khusus tipe (string_value, double_value, boolean_value, atau timestamp_value).