Amazon Connect 分析データレイクのケースデータ - Amazon Connect

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Connect 分析データレイクのケースデータ

このトピックでは、Amazon Connect データレイクケーステーブルの内容について詳しく説明します。以下の表には、内容の列、タイプ、説明が一覧表示されています。

分析データレイクにアクセスし、共有するデータを設定するには、次の 2 つの方法があります。

オプション 1 を使用してスケジューリングテーブルにアクセスできない場合は、オプション 2 を試してください。

ケースイベント

テーブル名: case_events

複合プライマリキー: {instance_id, event_id}

タイプ 説明
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 アクションを実行したカスタムエンティティ。
cases_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システムフィールド値を参照します。
ステータス 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(構造体) ケースに関連付けられたカスタムフィールドデータを含むオブジェクトの配列。各オブジェクトには、フィールド 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}

タイプ 説明
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 アクションを実行したカスタムエンティティ識別子。
cases_domain_arn string Amazon Connect Cases ドメインの ARN。
associated_case_id string この関連項目が関連付けられているケースの ID。
related_item_type string 関連項目のタイプ。有効な値: comment、file、sla、connect、contact、 custom。
created_timestamp タイムスタンプ 関連項目が作成されたタイムスタンプ。UTC。
コメント本文 string コメントの本文テキスト。
comment_content_type string コメント本文のコンテンツタイプ。例えば、Text/Plain などです。
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 を完了するための sla_target_field_id のターゲットフィールド値。
custom_related_item_fields array(構造体) 関連する項目に関連付けられたカスタムフィールドデータを含むオブジェクトの配列。各オブジェクトには、フィールド ID、field_name、および型固有の値フィールド (string_value、double_value、boolean_value、timestamp_value) が含まれます。