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

# Amazon Connect 分析データレイクのケースデータ
<a name="data-lake-cases-data"></a>

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

分析データレイクにアクセスし、共有するデータを設定するには、次の 2 つの方法があります。
+ [オプション 1: Amazon Connect コンソールを使用する。](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`

複合プライマリキー: {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) が含まれます。 | 

### サンプルクエリ
<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`

複合プライマリキー: {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) が含まれます。 |