本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon Connect 分析資料湖中的案例資料
本主題詳細說明 Amazon Connect 資料湖案例資料表中的內容。資料表列出內容的欄、類型和描述。
有兩種方式可存取分析資料湖並設定要共用的資料:
如果您無法使用「選項 1」存取排程資料表,請嘗試使用「選項 2」。
案例事件
資料表名稱: case_events
複合主鍵:{instance_id,event_id}
| Column (欄) | 類型 | Description |
|---|---|---|
| instance_id | string | Amazon Connect 執行個體的 ID。 |
| aws_account_id | string | 擁有案例 AWS 的帳戶 ID。 |
| event_id | string | 案例事件的唯一 ID。 |
| case_id | string | 案例的 ID。 |
| event_timestamp | 時間戳記 | 事件發生時的時間戳記,以 UTC 為單位。 |
| changed_field_ids | array(string) | 在此事件中修改的欄位 IDs 清單。 |
| event_type | string | 事件的類型。有效值:CASE.CREATED、CASE.UPDATED、CASE.DELETED。 |
| performed_by_iam_principal | string | 觸發事件之實體的 IAM 主體 ARN。 |
| performed_by_user_arn | string | 執行動作之使用者的 ARN。 |
| performed_by_custom_entity | string | 執行動作的自訂實體。 |
| case_domain_arn | string | Amazon Connect Cases 網域的 ARN。 |
| template_id | string | 用來建立案例的案例範本 ID。 |
| template_name | string | 案例範本的名稱。如果範本已刪除,則此值為空。 |
| last_updated_user | string | 上次更新案例的使用者。這會參考last_updated_user系統欄位值。 |
| reference_number | string | 案例的人類可讀參考號碼。這會參考reference_number系統欄位值。 |
| status | string | 案例的狀態。這會參考status系統欄位值。 |
| assigned_user | string | 指派給案例之使用者的 ARN。這會參考assigned_user系統欄位值。 |
| assigned_queue | string | 指派給案例之佇列的 ARN。這會參考assigned_queue系統欄位值。 |
| case_reason | string | 開啟案例的原因。這會參考case_reason系統欄位值。 |
| case_title | string | 案例的標題。這會參考title系統欄位值。 |
| case_summary | string | 案例的摘要。這會參考summary系統欄位值。 |
| customer_profile_arn | string | 與案例相關聯的客戶設定檔 ARN。這會參考customer_id系統欄位值。 |
| created_timestamp | 時間戳記 | 建立案例時的時間戳記,以 UTC 為單位。這會參考created_datetime系統欄位值。 |
| last_updated_timestamp | 時間戳記 | 上次更新案例時的時間戳記,以 UTC 為單位。這會參考last_updated_datetime系統欄位值。 |
| next_sla_breach_timestamp | 時間戳記 | 下一個 SLA 違規截止日期的時間戳記,以 UTC 為單位。這會參考next_sla_breach_datetime系統欄位值。 |
| last_closed_timestamp | 時間戳記 | 案例上次關閉時的時間戳記,以 UTC 為單位。這會參考last_closed_datetime系統欄位值。 |
| last_reopened_timestamp | 時間戳記 | 案例上次重新開啟時的時間戳記,以 UTC 為單位。這會參考last_reopened_datetime系統欄位值。 |
| custom_fields | array(struct) | 物件陣列,其中包含與案例相關聯的自訂欄位資料。每個物件都包含欄位 ID、Field_name 和類型特定值欄位 (string_value、double_value、boolean_value 或 timestamp_value)。 |
範例查詢
Athena 中的下列範例查詢會建立檢視,從案例事件資料表扁平化自訂欄位:
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)
下列範例會建立檢視,以傳回每個案例的最新狀態:
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;
案例相關項目事件
資料表名稱: case_related_item_events
複合主鍵:{instance_id,event_id}
| Column (欄) | 類型 | Description |
|---|---|---|
| instance_id | string | Amazon Connect 執行個體的 ID。 |
| aws_account_id | string | 擁有相關項目 AWS 的帳戶 ID。 |
| event_id | string | 相關項目事件的唯一 ID。 |
| related_item_id | string | 相關項目的 ID。 |
| event_timestamp | 時間戳記 | 事件發生時的時間戳記,以 UTC 為單位。 |
| event_type | string | 事件的類型。有效值:CASE.RELATED_ITEM.CREATED、CASE.RELATED_ITEM.UPDATED、CASE.RELATED_ITEM.DELETED。 |
| performed_by_iam_principal | string | 觸發事件之實體的 IAM 主體 ARN。 |
| performed_by_user_arn | string | 執行動作之使用者的 ARN。 |
| performed_by_custom_entity | string | 執行動作的自訂實體識別符。 |
| case_domain_arn | string | Amazon Connect Cases 網域的 ARN。 |
| associated_case_id | string | 與此相關項目相關聯的案例 ID。 |
| related_item_type | string | 相關項目的類型。有效值:評論、檔案、sla、連線、聯絡人、自訂。 |
| created_timestamp | 時間戳記 | 相關項目建立時的時間戳記,以 UTC 為單位。 |
| comment_body | string | 註解的內文文字。 |
| comment_content_type | string | 註解內文的內容類型。例如,文字/純文字。 |
| related_case_id | string | 相關案例的 ID。 |
| contact_channel | string | 聯絡人的通訊管道。例如,VOICE、CHAT、TASK、EMAIL。 |
| contact_id | string | 聯絡案例的 ID。 |
| file_arn | string | 檔案附件的 ARN。 |
| sla_name | string | SLA 的名稱。 |
| sla_status | string | SLA 的目前狀態。例如,作用中、過期、符合、未滿足。 |
| sla_target_timestamp | 時間戳記 | SLA 目標截止日期的時間戳記,以 UTC 為單位。 |
| sla_type | string | 要追蹤的 SLA 指標類型。例如,CaseField。 |
| sla_completion_timestamp | 時間戳記 | SLA 完成時的時間戳記,以 UTC 為單位。 |
| sla_target_field_id | string | SLA 目標的欄位 ID。 |
| sla_target_field_values | array(string) | sla_target_field_id 的目標欄位值,以便完成 SLA。 |
| custom_related_item_fields | array(struct) | 物件陣列,其中包含與相關項目相關聯的自訂欄位資料。每個物件都包含欄位 ID、Field_name 和類型特定值欄位 (string_value、double_value、boolean_value 或 timestamp_value)。 |