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

# Connect 客户分析数据湖中的案例数据
<a name="data-lake-cases-data"></a>

本主题详细介绍了 “连接客户” 数据湖案例表中的内容。该表列出了内容的列、类型和说明。

有两种方法可以访问分析数据湖和配置要共享的数据：
+ [选项 1：使用 Connect Customer 控制台](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`

**描述：**记录案例生命周期事件（创建、更新、删除），包括案例元数据、状态更改、模板信息和 Connect 案例的自定义字段值。

**主键：**`instance_id, event_id`

**分区键：**`event_timestamp`（每天）

**加入密钥：**
+ `instance_id`— 加入所有表
+ `case_id`— 加入 case\_related\_item\_events（作为）`associated_case_id`


|  **列**  |  **Type**  |  **可以为空 **  |  **描述**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  字符串  |  否  |  连接客户实例的 ID。 | 
|  aws\_account\_id  |  字符串  |  是  |  拥有该案例的 AWS 账户的 ID。 | 
|  event\_id  |  字符串  |  否  |  案例事件的唯一 ID。 | 
|  case\_id  |  字符串  |  是  |  案例的编号。 | 
|  event\_timestamp  |  Timestamp  |  是  |  事件发生时的时间戳，以 UTC 表示。 | 
|  更改的字段\_ID  |  array(string)  |  是  |  在此事件中修改的字段 ID 列表。 | 
|  event\_type  |  字符串  |  是  |  事件类型。有效值： CASE.CREATED、 CASE.UPDATED、 CASE.DELETED。 | 
|  由 iam\_principal 表演  |  字符串  |  是  |  触发事件的实体的 IAM 主体 ARN。 | 
|  由 user\_arn 执行  |  字符串  |  是  |  执行操作的用户的 ARN。 | 
|  由自定义实体执行  |  字符串  |  是  |  执行操作的自定义实体。 | 
|  cases\_domain\_arn  |  字符串  |  是  |  “连接客户案例” 域的 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系统字段值。 | 
|  case\_title  |  字符串  |  是  |  案例的标题。这引用了title系统字段值。 | 
|  案例摘要  |  字符串  |  是  |  案件摘要。这引用了summary系统字段值。 | 
|  客户资料\_arn  |  字符串  |  是  |  与案例相关的客户资料的 ARN。这引用了customer\_id系统字段值。 | 
|  created\_timestamp  |  Timestamp  |  是  |  案例创建时的时间戳，以 UTC 表示。这引用了created\_datetime系统字段值。 | 
|  last\_updated\_timestamp  |  Timestamp  |  是  |  案例上次更新的时间戳，以 UTC 为单位。这引用last\_updated\_datetime系统字段值。 | 
|  next\_sla\_breach\_timestamp  |  Timestamp  |  是  |  下一次 SLA 违规截止日期的时间戳，以 UTC 为单位。这引用next\_sla\_breach\_datetime系统字段值。 | 
|  上次关闭的时间戳  |  Timestamp  |  是  |  案件上次结案的时间戳，以 UTC 为单位。这引用last\_closed\_datetime系统字段值。 | 
|  上次重新打开的时间戳  |  Timestamp  |  是  |  上次重新审理案件的时间戳，以 UTC 为单位。这引用last\_reopened\_datetime系统字段值。 | 
|  custom\_fields  |  数组（结构）  |  是  |  包含与案例相关的自定义字段数据的对象数组。每个对象都包括字段 ID、字段名称和特定类型的值字段（字符串值、双精值、布尔值或时间戳值）。 | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  是  |  显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 | 

### 示例查询
<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`

**描述：**记录与案例相关的项目的事件，包括评论、联系人、文件附件、SLA 跟踪和自定义相关项目。

**主键：**`instance_id, event_id`

**分区键：**`event_timestamp`（每天）

**加入密钥：**
+ `instance_id`— 加入所有表
+ `associated_case_id`— 加入 case\_events（身份）`case_id`
+ `contact_id`— 加入联系人记录


|  **列**  |  **Type**  |  **可以为空 **  |  **描述**  | 
| --- | --- | --- | --- | 
|  instance\_id  |  字符串  |  否  |  连接客户实例的 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.DELETED。 | 
|  由 iam\_principal 表演  |  字符串  |  是  |  触发事件的实体的 IAM 主体 ARN。 | 
|  由 user\_arn 执行  |  字符串  |  是  |  执行操作的用户的 ARN。 | 
|  由自定义实体执行  |  字符串  |  是  |  执行操作的自定义实体标识符。 | 
|  cases\_domain\_arn  |  字符串  |  是  |  “连接客户案例” 域的 ARN。 | 
|  关联案例编号  |  字符串  |  是  |  与该相关商品关联的案例编号。 | 
|  相关物品类型  |  字符串  |  是  |  相关项目的类型。有效值：评论、文件、sla、连接、联系人、自定义。 | 
|  created\_timestamp  |  Timestamp  |  是  |  创建相关项目时的时间戳，以 UTC 为单位。 | 
|  评论正文  |  字符串  |  是  |  评论的正文。 | 
|  评论内容类型  |  字符串  |  是  |  评论正文的内容类型。例如 Text/Plain。 | 
|  相关案例编号  |  字符串  |  是  |  相关案例的 ID。 | 
|  联系人频道  |  字符串  |  是  |  联系人的沟通渠道。例如，语音、聊天、任务、电子邮件。 | 
|  contact\_id  |  字符串  |  是  |  联系人的 ID。 | 
|  file\_arn  |  字符串  |  是  |  文件附件的 ARN。 | 
|  sla\_name  |  字符串  |  是  |  SLA 的名称。 | 
|  sla\_status  |  字符串  |  是  |  SLA 的当前状态。例如，活跃、逾期、已满足、未满足。 | 
|  sla\_target\_时间戳  |  Timestamp  |  是  |  SLA 目标截止日期的时间戳，以 UTC 为单位。 | 
|  sla\_type  |  字符串  |  是  |  正在跟踪的 SLA 指标的类型。例如 CaseField。 | 
|  sla\_completion\_时间戳  |  Timestamp  |  是  |  SLA 完成时的时间戳，以 UTC 表示。 | 
|  sla\_target\_field\_id  |  字符串  |  是  |  SLA 目标字段的 ID。 | 
|  sla\_target\_字段\_值  |  array(string)  |  是  |  sla\_target\_field\_id 的目标字段值，以便完成 SLA。 | 
|  自定义相关商品字段  |  数组（结构）  |  是  |  包含与相关项目关联的自定义字段数据的对象数组。每个对象都包括字段 ID、字段名称和特定类型的值字段（字符串值、双精值、布尔值或时间戳值）。 | 
|  data\_lake\_last\_processed\_timestamp  |  Timestamp  |  是  |  显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。 |