本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 Connect Customer Analytics 資料湖中預測資料
<a name="data-lake-forecasting-data"></a>

本主題詳細說明 Connect Customer 資料湖預測資料表中的內容。每個資料表都會列出資料表中內容的欄、類型和描述。

有兩種方式可存取分析資料湖並設定要共用的資料：
+ [選項 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


| 資料行 | Type | 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  |  Boolean  |  是  |  預測群組是否已刪除。 | 
|  last\_updated\_timestamp |  String  |  是  |  上次建立/更新/刪除預測群組時的 epoch 時間戳記，以毫秒為單位。 | 
| data\_lake\_last\_processed\_timestamp |  時間戳記  |  是  | 資料湖上次處理記錄的時間戳記。這可能包括轉換和回填程序。此欄位無法用來判斷可靠的資料新鮮度。 | 

## 長期預測資料表
<a name="data-lake-longterm-forecasts"></a>

**資料表名稱：** `long_term_forecasts`

**描述：**包含長期 （每日間隔） 預測資料，包括聯絡量和平均處理時間預測，並支援客戶套用的覆寫。

**主索引鍵：** `instance_id, long_term_forecast_id`

**聯結金鑰：**
+ `instance_id` — 聯結至所有資料表
+ `forecast_group_arn, forecast_group_version` — 加入 forecast\_groups
+ `queue_id` — 加入客服人員佇列統計資料記錄


| 資料行 | Type | 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 |  是  | 預測群組的版本。 | 
| 間隔 | String |  是  | 預測資料的時間間隔。例如，長期預測資料為「每日」。 | 
| queue\_id | String |  是  | 預測的佇列 ID。 | 
| 通道 | String |  是  | 預測的通道。例如，VOICE。 | 
| forecast\_interval\_start\_time | 時間戳記 |  是  | 此預測資料列的時間間隔開始時間。 | 
| creation\_timestamp | 時間戳記 |  是  | 首次計算或發佈此預測的日期和時間。 | 
| computed\_time | 時間戳記 |  是  | 計算此預測的日期和時間。 | 
| published\_time | 時間戳記 |  是  | 此預測發佈的日期和時間。在預測發佈之前，此值為 null。 | 
| timezone | String |  是  | 預測的時區，例如 UTC。 | 
| is\_published | Boolean |  是  | 此預測是否已發佈。 | 
| 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` — 加入客服人員佇列統計資料記錄


| 資料行 | Type | 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 |  是  | 預測群組的版本。 | 
| 間隔 | String |  是  | 預測資料列的時間間隔。例如，FIFTEEN\_MINUTES 適用於短期 15 分鐘預測資料列。 | 
| queue\_id | String |  是  | 預測的佇列 ID。 | 
| 通道 | String |  是  | 此預測的通道，例如 VOICE。 | 
| forecast\_interval\_start\_time | 時間戳記 |  是  | 此預測資料列的時間間隔開始時間。 | 
| creation\_timestamp | 時間戳記 |  是  | 首次計算或發佈此預測的日期和時間。 | 
| computed\_time | 時間戳記 |  是  | 計算此預測的日期和時間。 | 
| published\_time | 時間戳記 |  是  | 發佈此預測的日期和時間。在預測發佈之前，此值為 null。 | 
| is\_published | Boolean |  是  | 此預測是否已發佈。 | 
| 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 映射）


|  **Column (欄)**  |  **類型**  |  **Nullable**  |  **Description**  | 
| --- | --- | --- | --- | 
|  intraday\_forecast\_id |  string  |  否  |  此當日預測資料的唯一識別符。 | 
|  aws\_account\_id  |  string  |  是  |  擁有 Intraday Forecast AWS 之帳戶的識別符。 | 
|  instance\_id |  string  |  否  |  Connect Customer 執行個體的識別符。您可以在執行個體的 Amazon Resource Name (ARN) 中[找到執行個體 ID](find-instance-arn.md)。 | 
|  instance\_arn |  string  |  是  |  Connect Customer 執行個體的執行個體 ARN。 | 
| 通道  |  string  |  是  |  用於聯絡您的聯絡中心的方式。 | 
|  queue\_arn |  string  |  是  |  佇列的 Amazon Resource Name。 | 
| 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


| 資料行 | Type | 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  |  Boolean  |  是  |  是否刪除需求群組。 | 
|  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` — 加入客服人員佇列統計資料記錄


| 資料行 | Type | 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。 | 
| 通道 |  string  |  是  |  屬於需求群組之queue-and-channel組合的頻道。 | 
|  is\_deleted  |  Boolean  |  是  |  是否刪除需求群組。 | 
|  last\_updated\_timestamp |  時間戳記  |  是  |  需求群組上次created/updated/deleted時的時間戳記。 | 
| data\_lake\_last\_processed\_timestamp |  時間戳記  |  是  | 時間戳記，顯示資料湖上次觸碰記錄的時間。這可能包括轉換和回填。此欄位無法可靠地用於判斷資料新鮮度。 |