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