View a markdown version of this page

Connect 客户分析数据湖中的案例数据 - Amazon Connect Customer

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

Connect 客户分析数据湖中的案例数据

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

有两种方法可以访问分析数据湖和配置要共享的数据:

如果您无法使用选项 1 访问调度表,请尝试使用选项 2。

案例活动

表名: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 显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。

示例查询

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

描述:记录与案例相关的项目的事件,包括评论、联系人、文件附件、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 显示数据湖最后一次处理记录的时间戳。这可能包括转换和回填。该字段不能可靠地用于确定数据的新鲜度。