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

# Connect Customer Analytics データレイクでのデータの予測
<a name="data-lake-forecasting-data"></a>

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

分析データレイクにアクセスし、共有するデータを設定するには、次の 2 つの方法があります。
+ [オプション 1: Connect Customer コンソールを使用する](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-forecasting-data-important)
+ [予測グループテーブル](#data-lake-forecast-groups)
+ [長期の予測テーブル](#data-lake-longterm-forecasts)
+ [短期予測テーブル](#data-lake-shortterm-forecasts)
+ [日中予測テーブル](#data-lake-intraday-forecasts)
+ [需要グループテーブル](#data-lake-demand-groups)
+ [需要グループ定義テーブル](#data-lake-demand-group-definition)

## 重要事項
<a name="data-lake-forecasting-data-important"></a>
+ このトピックで説明されているテーブルを使用して、データレイク内の公開された予測データにアクセスできます。
+ 予測グループテーブルには、バージョニングされたレコードが保存されます。例えば、予測グループへのキューの追加や削除など、予測グループの詳細が変更されると、新しいバージョンが作成されます。forecast\_group\_version の最大値を使用して、最新のレコードを取得できます。
+ 予測グループテーブルを長期予測テーブルと短期予測テーブルに結合するには、forecast\_group\_arn と forecast\_group\_version の列を使用します。

## 予測グループテーブル
<a name="data-lake-forecast-groups"></a>

**テーブル名:** `forecast_groups`

**説明:** 変更の追跡にバージョニングを使用して、需要予測のキューとチャネルを整理する予測グループを定義します。

**プライマリキー:** `instance_id, forecast_group_arn, forecast_group_version`

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `forecast_group_arn, forecast_group_version` — long\_term\_forecasts、short\_term\_forecasts に結合します
+ `forecast_group_arn` — staffing\_group\_forecast\_groups に結合します


| 列 | タイプ | Nullable | 説明 | 
| --- | --- | --- | --- | 
|  instance\_id  |  String  |  いいえ  |  Connect Customer インスタンスの識別子。 | 
|  forecast\_group\_arn  |  String  |  いいえ  |  予測グループの ARN。 | 
|  forecast\_group\_version |  Number  |  いいえ  | 予測グループのバージョン。新しいキューの追加など、予測グループが変更されるたびに、新しいバージョンが作成されます。 | 
|  forecast\_group\_name |  String  |  はい  |  予測グループの名前。 | 
|  instance\_arn  |  String  |  はい  |  Connect Customer インスタンスの ARN。 | 
|  is\_deleted  |  ブール値  |  はい  |  予測グループが削除されるかどうか。 | 
|  last\_updated\_timestamp |  String  |  はい  |  予測グループが最後に作成/更新/削除された時刻のタイムスタンプ (エポック形式、ミリ秒単位)。 | 
| data\_lake\_last\_processed\_timestamp |  タイムスタンプ  |  はい  | データレイクがレコードを最後に処理した時刻のタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 | 

## 長期の予測テーブル
<a name="data-lake-longterm-forecasts"></a>

**テーブル名:** `long_term_forecasts`

**説明:** 問い合わせ量や平均処理時間予測を含む長期 (1 日間隔) 予測データが含まれ、お客様が適用したオーバーライドがサポートされます。

**プライマリキー:** `instance_id, long_term_forecast_id`

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `forecast_group_arn, forecast_group_version` — forecast\_groups に結合します
+ `queue_id` — エージェントキュー統計レコードに結合します


| 列 | タイプ | Nullable | 説明 | 
| --- | --- | --- | --- | 
| instance\_id | String |  いいえ  | Connect Customer インスタンスの ID | 
| long\_term\_forecast\_id | String |  はい  | 予測データ行の一意の識別子。キーは複数の値のハッシュです: instanceId、forecastGroupId、forecastGroupVersion、forecastType、queueId、channel、forecastStarttime、creationTime。 | 
| forecast\_group\_arn | String |  はい  | 予測グループの ARN。 | 
| forecast\_group\_version | Number |  はい  | 予測グループのバージョン。 | 
| interval | String |  はい  | 予測データの時間間隔。例えば、長期予測データの場合は日別。 | 
| queue\_id | String |  はい  | 予測のキューの ID。 | 
| channel | String |  はい  | 予測のチャネル。例: VOICE。 | 
| forecast\_interval\_start\_time | タイムスタンプ |  はい  | この予測データ行の時間間隔の開始時刻。 | 
| creation\_timestamp | タイムスタンプ |  はい  | この予測が最初に計算または公開された日時。 | 
| computed\_time | タイムスタンプ |  はい  | この予測が計算される日時。 | 
| published\_time | タイムスタンプ |  はい  | この予測が公開される日時。この値は、予測が公開されるまで null です。 | 
| timezone | String |  はい  | 予測のタイムゾーン (例えば、UTC など)。 | 
| is\_published | ブール値 |  はい  | この予測が公開されているかどうか。 | 
| average\_handle\_time | Number |  はい  | 予測データ行の平均処理時間メトリクス値。 | 
| contact\_volume | Number |  はい  | 予測データ行のコンタクトボリュームメトリクス値。 | 
| average\_handle\_time\_override | Number |  はい  | 顧客が適用した平均処理時間メトリクスのオーバーライド値。 | 
| contact\_volume\_override | Number |  はい  | 顧客が適用したコンタクトボリュームメトリクス値のオーバーライド値。 | 
| instance\_arn | String |  はい  | 予測の Connect Customer インスタンスの ARN。 | 
| data\_lake\_last\_processed\_timestamp | タイムスタンプ |  はい  | データレイクがレコードを最後に処理した時刻のタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 | 

## 短期予測テーブル
<a name="data-lake-shortterm-forecasts"></a>

**テーブル名:** `short_term_forecasts`

**説明:** 問い合わせ量や平均処理時間予測などの短期 (15 分間隔) 予測データが含まれ、お客様が適用したオーバーライドがサポートされています。

**プライマリキー:** `instance_id, short_term_forecast_id`

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `forecast_group_arn, forecast_group_version` — forecast\_groups に結合します
+ `queue_id` — エージェントキュー統計レコードに結合します


| 列 | タイプ | Nullable | 説明 | 
| --- | --- | --- | --- | 
| instance\_id | String |  いいえ  | Connect Customer インスタンスの ID。 | 
| short\_term\_forecast\_id | String |  はい  | 予測データ行の一意の識別子。キーは複数の値のハッシュです: instanceId、forecastGroupId、forecastGroupVersion、forecastType、queueId、channel、forecastStarttime、creationTime。 | 
| forecast\_group\_arn | String |  はい  | 予測データ行の予測グループの ARN。 | 
| forecast\_group\_version | Number |  はい  | 予測グループのバージョン。 | 
| interval | String |  はい  | 予測データ行の時間間隔。例: 短期間の 15 分の予測データ行の場合は FIFTEEN\_MINUTES。 | 
| queue\_id | String |  はい  | 予測のキューの ID。 | 
| channel | String |  はい  | VOICE など、この予測のチャネル。 | 
| forecast\_interval\_start\_time | タイムスタンプ |  はい  | この予測データ行の時間間隔の開始時刻。 | 
| creation\_timestamp | タイムスタンプ |  はい  | この予測が最初に計算または公開された日時。 | 
| computed\_time | タイムスタンプ |  はい  | この予測が計算される日時。 | 
| published\_time | タイムスタンプ |  はい  | この予測が公開される日時。この値は、予測が公開されるまで null です。 | 
| is\_published | ブール値 |  はい  | この予測が公開されているかどうか。 | 
| average\_handle\_time | Number |  はい  | 予測データ行の平均処理時間メトリクス値。 | 
| contact\_volume | Number |  はい  | 予測データ行のコンタクトボリュームメトリクス値。 | 
| average\_handle\_time\_override | Number |  はい  | 顧客が適用した平均処理時間メトリクスのオーバーライド値。 | 
| contact\_volume\_override | Number |  はい  | 顧客が適用したコンタクトボリュームメトリクス値のオーバーライド値。 | 
| instance\_arn | String |  はい  | 予測の Connect Customer インスタンスの ARN。 | 
| data\_lake\_last\_processed\_timestamp | タイムスタンプ |  はい  | データレイクがレコードを最後に処理した時刻のタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドを使用して、データの鮮度を確実に判断することはできません。 | 

## 日中予測テーブル
<a name="data-lake-intraday-forecasts"></a>

**テーブル名:** `intraday_forecasts`

**説明:** 予測された問い合わせ量、平均処理時間、キュー応答時間、リアルタイムのワークフォース調整のための効果的なエージェントスタッフ配置など、日中予測データが含まれています。

**プライマリキー:** `instance_id, intraday_forecast_id`

**パーティションキー:** `forecast_interval_start_timestamp` (毎日)

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `queue_arn` — エージェントキュー統計レコードに結合します (キュー ARN と ID マッピング経由)


|  **列**  |  **タイプ**  |  **Nullable**  |  **説明**  | 
| --- | --- | --- | --- | 
|  intraday\_forecast\_id |  string  |  いいえ  |  この日中予測データの一意の識別子。 | 
|  aws\_account\_id  |  string  |  はい  |  Intraday Forecast を所有する AWS アカウントの識別子。 | 
|  instance\_id |  string  |  いいえ  |  Connect Customer インスタンスの識別子。インスタンスの Amazon リソースネーム (ARN) で[インスタンス ID を確認](find-instance-arn.md)できます。 | 
|  instance\_arn |  string  |  はい  |  Connect Customer インスタンスのインスタンス ARN。 | 
| channel  |  string  |  はい  |  コンタクトセンターに連絡するために使用する方法。 | 
|  queue\_arn |  string  |  はい  |  キューの Amazon リソースネーム。 | 
| forecast\_interval\_start\_timestamp  |  タイムスタンプ  |  はい  |  予測間隔の開始タイムスタンプ。 | 
|  creation\_timestamp |  タイムスタンプ  |  はい  |  予測システムで予測が計算された日時。 | 
| average\_handle\_time  |  Double  |  はい  | 予測メトリクスデータ: 平均処理時間。 | 
| average\_queue\_answer\_time  |  Double  |  はい  | 予測メトリクスデータ: 平均キュー応答時間。 | 
|  contact\_volume |  Double  |  はい  |  予測メトリクスデータ: コンタクトボリューム。 | 
| effective\_agent\_staffing  |  Double  |  はい  | 予測メトリクスデータ: 効果的なエージェントの人員配置。 | 
| data\_lake\_last\_processed\_timestamp |  タイムスタンプ  |  はい  | データレイクがレコードを最後に処理した時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。 | 

## 需要グループテーブル
<a name="data-lake-demand-groups"></a>

**テーブル名:** `demand_group`

**説明:** キャパシティプランニングの特定のキューチャネルの組み合わせを表す需要グループを定義し、需要ターゲットを予測グループに関連付けます。

**プライマリキー:** `instance_id, demand_group_arn, demand_group_version`

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `forecast_group_arn` — forecast\_groups に結合します ( として`forecast_group_arn`)
+ `demand_group_arn, demand_group_version` — demand\_group\_definitions に結合します
+ `demand_group_arn` — staffing\_group\_demand\_group、 staff\_demand\_group に結合します


| 列 | タイプ | Nullable | 説明 | 
| --- | --- | --- | --- | 
|  instance\_id  |  string  |  いいえ  |  Connect Customer インスタンスの識別子。 | 
|  demand\_group\_arn  |  string  |  いいえ  |  需要グループの ARN。 | 
|  demand\_group\_version |  Long  |  いいえ  | 需要グループのバージョン。新しいバージョンは、新しいキューの追加など、需要グループに変更が加えられるたびに作成されます。 | 
|  instance\_arn  |  string  |  はい  |  Connect Customer インスタンスの ARN。 | 
|  demand\_group\_name |  string  |  はい  |  需要グループの名前。 | 
|  forecast\_group\_arn  |  string  |  はい  |  予測グループの ARN。 | 
|  is\_deleted  |  ブール値  |  はい  |  需要グループが削除されるかどうか。 | 
|  last\_updated\_timestamp |  タイムスタンプ  |  はい  |  需要グループが最後にcreated/updated/deletedタイムスタンプ。 | 
| data\_lake\_last\_processed\_timestamp |  タイムスタンプ  |  はい  | レコードが最後にデータレイクによって更新された時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。 | 

## 需要グループ定義テーブル
<a name="data-lake-demand-group-definition"></a>

**テーブル名:** `demand_group_definitions`

**説明:** 各需要グループを構成するキューとチャネルの組み合わせを定義し、特定のワークロードタイプを需要配分ターゲットにマッピングします。

**プライマリキー:** `instance_id, demand_group_definition_id`

**結合キー:**
+ `instance_id` — すべてのテーブルに結合します
+ `demand_group_arn, demand_group_version` — demand\_group に結合します
+ `queue_id` — エージェントキュー統計レコードに結合します


| 列 | タイプ | Nullable | 説明 | 
| --- | --- | --- | --- | 
|  instance\_id  |  string  |  いいえ  |  Connect Customer インスタンスの識別子。 | 
|  demand\_group\_definition\_id  |  string  |  いいえ  |  demandGroup 定義行の一意の識別子。 | 
|  demand\_group\_arn  |  string  |  はい  |  需要グループの ARN。 | 
|  demand\_group\_version |  Long  |  はい  | 需要グループのバージョン。新しいバージョンは、新しいキューの追加など、需要グループに変更が加えられるたびに作成されます。 | 
|  instance\_arn  |  string  |  はい  |  Connect Customer インスタンスの ARN。 | 
| queue\_id |  string  |  はい  |  需要グループの一部であるキューの ID。 | 
| channel |  string  |  はい  |  需要グループに属するqueue-and-channelの組み合わせのチャネル。 | 
|  is\_deleted  |  ブール値  |  はい  |  需要グループが削除されるかどうか。 | 
|  last\_updated\_timestamp |  タイムスタンプ  |  はい  |  需要グループが最後にcreated/updated/deletedタイムスタンプ。 | 
| data\_lake\_last\_processed\_timestamp |  タイムスタンプ  |  はい  | レコードが最後にデータレイクによって更新された時刻を示すタイムスタンプ。これには、変換とバックフィルが含まれる場合があります。このフィールドは、データの鮮度を判断するために確実に使用することはできません。 |