Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateDataset 建立 Amazon Forecast 資料集。 **重要** Amazon Forecast 不再提供給新客戶。Amazon Forecast 的現有客戶可以繼續正常使用服務。[進一步了解」](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 您提供的資料集相關資訊有助於 Forecast 了解如何使用資料進行模型訓練。這包含下列項目： + * `DataFrequency` * – 收集歷史時間序列資料的頻率。 + * `Domain` * 和 * `DatasetType` * – 每個資料集都有網域內相關聯的資料集網域和類型。Amazon Forecast 提供每個網域內預先定義的網域和類型的清單。針對網域內每個唯一的資料集網域和類型，Amazon Forecast 要求資料包含最基本的一組預先定義欄位。 + * `Schema` * – 結構描述指定資料集中的欄位，包括欄位名稱和資料類型。 建立資料集之後，您將訓練資料匯入至其中並將資料集新增至資料集群組。您可以使用資料集群組來建立預測器。如需詳細資訊，請參閱[匯入資料集](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。 若要取得您所有資料集的清單，請使用 [ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html) 操作。 如需 Forecast 資料集範例，請參閱 [Amazon Forecast 範例 GitHub 儲存庫](https://github.com/aws-samples/amazon-forecast-samples)。 **注意** 資料集 `Status` 的必須是 `ACTIVE`，然後您才能匯入訓練資料。若要取得狀態，請使用 [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) 操作。 ## 請求語法 ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 請求接受採用 JSON 格式的下列資料。 ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** 資料收集的頻率。RELATED\$1TIME\$1SERIES 資料集需要此參數。 有效間隔為整數，後跟 Y (年)、M (月)、W (週)、D (天)、H (小時) 和 min (分鐘)。例如，"1D" 表示每隔一天，"15min" 表示每隔 15 分鐘。您無法指定會與下一個較大頻率重疊的值。例如，這意味著您不能指定頻率為 60 分鐘，因為這相當於 1 小時。每個頻率的有效值如下： + 分鐘–1-59 + 小時–1-23 + 天–1-6 + 週–1-4 + 月–1-11 + 年 – 1 因此，如果您希望每兩週預測一次，請指定 "2W"。或者，如果您希望每季度預測一次，請指定 "3M"。 類型：字串 長度限制：長度下限為 1。長度上限為 5。 模式：`^Y|M|W|D|H|30min|15min|10min|5min|1min$` 必要：否 ** [DatasetName](#API_CreateDataset_RequestSyntax) ** 資料集的名稱。 類型：字串 長度限制：長度下限為 1。長度上限為 63。 模式：`^[a-zA-Z][a-zA-Z0-9_]*` 必要：是 ** [DatasetType](#API_CreateDataset_RequestSyntax) ** 資料集類型。有效值取決於選擇的 `Domain`。 類型：字串 有效值:`TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` 必要：是 ** [Domain](#API_CreateDataset_RequestSyntax) ** 與資料集相關聯的網域。當您將資料集新增至資料集群組時，此值和為 [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html) 操作的 `Domain` 參數指定的值必須相符。 `DatasetType` 您選擇的 `Domain`和 會決定您匯入資料集的訓練資料中必須存在的欄位。例如，如果您選擇`RETAIL`網域 和 `TARGET_TIME_SERIES`作為 `DatasetType`，Amazon Forecast 需要 `item_id`、 `timestamp`和 `demand` 欄位存在於您的資料中。如需詳細資訊，請參閱[匯入資料集](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)。 類型：字串 有效值:`RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 必要：是 ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Amazon Forecast 可以擔任的 AWS Key Management Service (KMS) 金鑰和 AWS Identity and Access Management (IAM) 角色來存取金鑰。 類型：[EncryptionConfig](API_EncryptionConfig.md) 物件 必要：否 ** [Schema](#API_CreateDataset_RequestSyntax) ** 資料集的結構描述。結構描述屬性及其順序必須與資料中的欄位相符。您所選的資料集 `Domain` 和 `DatasetType` 決定了訓練資料中最基本的必要欄位。如需有關特定資料集網域和類型的必要欄位的資訊，請參閱[資料集網域和資料集類型](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html)。 類型：[Schema](API_Schema.md) 物件 必要：是 ** [Tags](#API_CreateDataset_RequestSyntax) ** 您套用至資料集的選用中繼資料，可協助您分類和組織這些中繼資料。每個標籤皆包含由您定義的一個金鑰與一個選用值。 以下基本限制適用於 標籤： + 每個資源的標籤數量上限 - 50。 + 針對每一個資源，每個標籤鍵必須是唯一的，且每個標籤鍵只能有一個值。 + 金鑰長度上限 - UTF-8 中的 128 個 Unicode 字元。 + 最大值長度 - UTF-8 256 個 Unicode 字元。 + 如果您的標記結構描述是跨多項服務和資源使用，請記得其他服務可能會有字元使用限制。通常允許的字元為：以 UTF-8 表示的字母、數字和空格，以及下列字元：\$1 - = . \$1 ： / @。 + 標籤鍵與值皆區分大小寫。 + 請勿使用 `aws:`、 `AWS:`或任何大寫或小寫的組合，例如金鑰的字首，因為其保留供 AWS 使用。您無法使用此字首編輯或刪除標籤索引鍵。值可以有此字首。如果標籤值具有 `aws` 作為其字首，但金鑰沒有，則預測會將其視為使用者標籤，並計入 50 個標籤的限制。只有 金鑰字首的標籤`aws`不會計入每個資源限制的標籤。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "DatasetArn": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** 資料集的 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度上限為 256。 模式：`arn:([a-z\d-]+):forecast:.*:.*:.+` ## 錯誤 ** InvalidInputException ** 我們無法處理請求，因為它包含無效的值或超過有效範圍的值。 HTTP 狀態碼：400 ** LimitExceededException ** 已超過每個帳戶的資源數量限制。 HTTP 狀態碼：400 ** ResourceAlreadyExistsException ** 已有具有此名稱的資源。請用不同的名稱再試一次。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset)