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

# DatasetImportJob
<a name="API_DatasetImportJob"></a>

描述將訓練資料從資料來源 (Amazon S3 儲存貯體) 匯入 Amazon Personalize 資料集的任務。如需詳細資訊，請參閱 [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)。

資料集匯入任務可處於下列任意一種狀態：
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED

## 目錄
<a name="API_DatasetImportJob_Contents"></a>

 ** creationDateTime **   <a name="personalize-Type-DatasetImportJob-creationDateTime"></a>
資料集匯入任務的建立日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** datasetArn **   <a name="personalize-Type-DatasetImportJob-datasetArn"></a>
接收匯入資料之資料集的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** datasetImportJobArn **   <a name="personalize-Type-DatasetImportJob-datasetImportJobArn"></a>
資料集匯入任務的 ARN。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** dataSource **   <a name="personalize-Type-DatasetImportJob-dataSource"></a>
此為 Amazon S3 儲存貯體，其中包含要匯入的訓練資料。  
類型：[DataSource](API_DataSource.md) 物件  
必要：否

 ** failureReason **   <a name="personalize-Type-DatasetImportJob-failureReason"></a>
如果資料集匯入任務失敗， 會提供原因。  
類型：字串  
必要：否

 ** importMode **   <a name="personalize-Type-DatasetImportJob-importMode"></a>
資料集匯入任務用來匯入新記錄的匯入模式。  
類型：字串  
有效值:`FULL | INCREMENTAL`   
必要：否

 ** jobName **   <a name="personalize-Type-DatasetImportJob-jobName"></a>
匯入任務的名稱。  
類型：字串  
長度限制：長度下限為 1。長度上限為 63。  
模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*`  
必要：否

 ** lastUpdatedDateTime **   <a name="personalize-Type-DatasetImportJob-lastUpdatedDateTime"></a>
上次更新資料集的日期和時間 （以 Unix 時間為單位）。  
類型：Timestamp  
必要：否

 ** publishAttributionMetricsToS3 **   <a name="personalize-Type-DatasetImportJob-publishAttributionMetricsToS3"></a>
任務是否針對指標屬性將指標發佈至 Amazon S3。  
類型：布林值  
必要：否

 ** roleArn **   <a name="personalize-Type-DatasetImportJob-roleArn"></a>
此為 IAM 角色的 ARN，該角色具有從 Amazon S3 資料來源讀取資料的許可。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

 ** status **   <a name="personalize-Type-DatasetImportJob-status"></a>
資料集匯入任務的狀態。  
資料集匯入任務可處於下列任意一種狀態：  
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
類型：字串  
長度限制：長度上限為 256。  
必要：否

## 另請參閱
<a name="API_DatasetImportJob_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DatasetImportJob) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DatasetImportJob) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DatasetImportJob)