本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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


|  **列**  |  **Type**  |  **描述**  | 
| --- | --- | --- | 
|  instance\_id  |  字符串  |  Amazon Connect 实例的 ID。 | 
|  aws\_account\_id  |  字符串  |  拥有该案例的 AWS 账户的 ID。 | 
|  event\_id  |  字符串  |  案例事件的唯一 ID。 | 
|  case\_id  |  字符串  |  案例 ID。 | 
|  event\_timestamp  |  Timestamp  |  事件发生的时间戳，以 UTC 为单位。 | 
|  已更改的字段 ID  |  array(string)  |  在此事件中修改的字段 IDs 列表。 | 
|  event\_type  |  字符串  |  事件类型。有效值：CASE.CREATED、CASE.UPDATED、CASE.DELET  | 
|  performed\_by\_iam\_princip  |  字符串  |  触发事件的实体的 IAM 委托人 ARN。 | 
|  performed\_by\_user\_arn  |  字符串  |  执行操作的用户的 ARN。 | 
|  由自定义实体执行  |  字符串  |  执行操作的自定义实体。 | 
|  cases\_domain\_arn  |  字符串  |  Amazon Connect 案例域名的 ARN。 | 
|  模板\_id  |  字符串  |  用于创建案例的案例模板的 ID。 | 
|  template\_name  |  字符串  |  案例模板的名称。如果模板已被删除，则此值为空。 | 
|  last\_updated\_user  |  字符串  |  上次更新案例的用户。这会引用last\_updated\_user系统字段值。 | 
|  reference\_number  |  字符串  |  人类可读的案例参考号。这会引用reference\_number系统字段值。 | 
|  status  |  字符串  |  案件的状态。这会引用status系统字段值。 | 
|  assigned\_user  |  字符串  |  分配给案例的用户的 ARN。这会引用assigned\_user系统字段值。 | 
|  assigned\_queue  |  字符串  |  分配给案例的队列的 ARN。这会引用assigned\_queue系统字段值。 | 
|  case\_reason  |  字符串  |  立案的原因。这会引用case\_reason系统字段值。 | 
|  案例标题  |  字符串  |  案件的标题。这会引用title系统字段值。 | 
|  案例摘要  |  字符串  |  案例摘要。这会引用summary系统字段值。 | 
|  客户资料\_arn  |  字符串  |  与问题关联的客户资料的 ARN。这会引用customer\_id系统字段值。 | 
|  created\_timestamp  |  Timestamp  |  创建案例的时间戳，以 UTC 为单位。这会引用created\_datetime系统字段值。 | 
|  last\_updated\_timestamp  |  Timestamp  |  上次更新案例的时间戳，以 UTC 为单位。这会引用last\_updated\_datetime系统字段值。 | 
|  下一页\_sla\_breach\_timestamp  |  Timestamp  |  下一次 SLA 违规截止日期的时间戳，以 UTC 为单位。这会引用next\_sla\_breach\_datetime系统字段值。 | 
|  last\_closed\_timestamp  |  Timestamp  |  上次结案的时间戳，以 UTC 为单位。这会引用last\_closed\_datetime系统字段值。 | 
|  last\_reopened\_timestamp  |  Timestamp  |  上次重新审理案例的时间戳，以 UTC 为单位。这会引用last\_reopened\_datetime系统字段值。 | 
|  custom\_fields  |  数组（结构）  |  包含与案例关联的自定义字段数据的对象数组。每个对象都包括字段 ID、字段名称和特定类型的值字段（字符串值、double\_value、boolean\_value 或 timestamp\_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}


|  **列**  |  **Type**  |  **描述**  | 
| --- | --- | --- | 
|  instance\_id  |  字符串  |  Amazon Connect 实例的 ID。 | 
|  aws\_account\_id  |  字符串  |  拥有相关商品的 AWS 账户的 ID。 | 
|  event\_id  |  字符串  |  相关商品事件的唯一 ID。 | 
|  相关商品编号  |  字符串  |  相关商品的 ID。 | 
|  event\_timestamp  |  Timestamp  |  事件发生的时间戳，以 UTC 为单位。 | 
|  event\_type  |  字符串  |  事件类型。有效值：CASE.RELATED\_ITEM.CREATED、CASE.RELATED\_ITEM.UPDATED、CASE.RELATED\_ITEM.D  | 
|  performed\_by\_iam\_princip  |  字符串  |  触发事件的实体的 IAM 委托人 ARN。 | 
|  performed\_by\_user\_arn  |  字符串  |  执行操作的用户的 ARN。 | 
|  由自定义实体执行  |  字符串  |  执行操作的自定义实体标识符。 | 
|  cases\_domain\_arn  |  字符串  |  Amazon Connect 案例域名的 ARN。 | 
|  关联案例\_id  |  字符串  |  与该相关商品关联的案例编号。 | 
|  相关商品类型  |  字符串  |  相关商品的类型。有效值：评论、文件、sla、连接、联系人、自定义。 | 
|  created\_timestamp  |  Timestamp  |  创建相关项目的时间戳，以 UTC 为单位。 | 
|  评论正文  |  字符串  |  评论的正文。 | 
|  评论内容类型  |  字符串  |  评论正文的内容类型。例如，文本/纯文本。 | 
|  相关案例编号  |  字符串  |  相关案例的 ID。 | 
|  联系人频道  |  字符串  |  联系人的沟通渠道。例如，语音、聊天、任务、电子邮件。 | 
|  contact\_id  |  字符串  |  联系人的 ID。 | 
|  file\_arn  |  字符串  |  文件附件的 ARN。 | 
|  sla\_name  |  字符串  |  服务等级协议的名称。 | 
|  sla 状态  |  字符串  |  SLA 的当前状态。例如，活跃、逾期、已满足、未满足。 | 
|  sla\_target\_timest  |  Timestamp  |  SLA 目标截止日期的时间戳，以 UTC 为单位。 | 
|  sla 类型  |  字符串  |  正在跟踪的 SLA 指标的类型。例如 CaseField。 | 
|  sla\_完成时间戳  |  Timestamp  |  SLA 完成时的时间戳，以 UTC 为单位。 | 
|  sla\_target\_field\_ID  |  字符串  |  SLA 所针对的字段的 ID。 | 
|  sla\_target\_field\_ 值  |  array(string)  |  sla\_target\_field\_id 的目标字段值，以便完成 SLA。 | 
|  自定义相关商品字段  |  数组（结构）  |  包含与相关项目关联的自定义字段数据的对象数组。每个对象都包括字段 ID、字段名称和特定类型的值字段（字符串值、double\_value、boolean\_value 或 timestamp\_value 或 timestamp\_value）。 |