View a markdown version of this page

Connect Customer Analytics データレイクのケースデータ - Amazon Connect Customer

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

Connect Customer Analytics データレイクのケースデータ

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

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

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

ケースイベント

テーブル名: case_events

説明: Connect Cases のケースメタデータ、ステータス変更、テンプレート情報、カスタムフィールド値など、ケースライフサイクルイベント (作成、更新、削除) を記録します。

プライマリキー: instance_id, event_id

パーティションキー: event_timestamp (毎日)

結合キー:

  • instance_id — すべてのテーブルに結合します

  • case_id — case_related_item_events に結合します ( としてassociated_case_id)

タイプ Nullable 説明
instance_id string いいえ Connect Customer インスタンスの 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 はい Connect Customer 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

説明: コメント、連絡先、添付ファイル、SLA 追跡、カスタム関連項目など、ケースに関連する項目のイベントを記録します。

プライマリキー: instance_id, event_id

パーティションキー: event_timestamp (毎日)

結合キー:

  • instance_id — すべてのテーブルに結合します

  • associated_case_id — case_events に結合します ( としてcase_id)

  • contact_id — 問い合わせレコードに結合します

タイプ Nullable 説明
instance_id string いいえ Connect Customer インスタンスの 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 はい Connect Customer 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、フィールド名、タイプ固有の値フィールド (string_value、double_value、boolean_value、timestamp_value) が含まれます。