本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Connect 分析資料湖中的案例資料
<a name="data-lake-cases-data"></a>

本主題詳細說明 Amazon Connect 資料湖案例資料表中的內容。資料表列出內容的欄、類型和描述。

有兩種方式可存取分析資料湖並設定要共用的資料：
+ [選項 1：使用 Amazon Connect 主控台](access-datalake.md#option1-configure-data-to-be-shared)
+ [選項 2：使用 CLI 或 CloudShell](access-datalake.md#option2-configure-data-to-be-shared)

如果您無法使用「選項 1」存取排程資料表，請嘗試使用「選項 2」。

**Topics**
+ [案例事件](#data-lake-case-events)
+ [案例相關項目事件](#data-lake-case-related-item-events)

## 案例事件
<a name="data-lake-case-events"></a>

資料表名稱： `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)。 | 

### 範例查詢
<a name="data-lake-case-events-sample-queries"></a>

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

## 案例相關項目事件
<a name="data-lake-case-related-item-events"></a>

資料表名稱： `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)。 |