本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
在 Amazon Personalize 中建立資料集匯出任務
您可以使用 Amazon Personalize 主控台 AWS Command Line Interface (AWS CLI) 或 AWS SDKs建立資料集匯出任務。
建立資料集匯出任務 (主控台)
將資料匯入資料集並建立輸出 Amazon S3 儲存貯體後,您可以將資料匯出至儲存貯體進行分析。若要使用 Amazon Personalize 主控台匯出資料集,您可以建立資料集匯出任務。如需有關建立 Amazon S3 儲存貯體的資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的建立儲存貯體。
匯出資料集之前,請確定您的 Amazon Personalize 服務角色可以存取和寫入輸出 Amazon S3 儲存貯體。請參閱 資料集匯出任務許可要求。
建立資料集匯出任務 (主控台)
-
在 https://console.aws.amazon.com/personalize/home
:// 開啟 Amazon Personalize 主控台。 -
在導覽窗格中,選擇資料集群組。
-
在資料集群組頁面上,選擇您的資料集群組。
-
在導覽窗格中,選擇資料集。
-
選擇您要匯出至 Amazon S3 儲存貯體的資料集。
-
在資料集匯出任務中,選擇建立資料集匯出任務。
-
在資料集匯出任務詳細資訊中,針對資料集匯出任務名稱,輸入匯出任務的名稱。
-
針對 IAM 服務角色,選擇您在 中建立的 Amazon Personalize 服務角色為 Amazon Personalize 建立 IAM 角色。
-
對於 Amazon S3 資料輸出路徑,輸入目的地 Amazon S3 儲存貯體。使用下列語法:
s3://amzn-s3-demo-bucket/<folder path>
-
如果您使用 AWS KMS 進行加密,請在 KMS 金鑰 ARN 中輸入 AWS KMS 金鑰的 Amazon Resource Name (ARN)。
-
對於匯出資料類型,請根據您最初匯入資料的方式選擇要匯出的類型資料。
-
選擇大量以僅匯出您使用資料集匯入任務大量匯入的資料。
-
選擇增量以僅匯出您使用主控台或
PutUsers
、PutEvents
或PutItems
操作個別匯入的資料。 -
選擇兩者以匯出資料集中的所有資料。
-
-
對於標籤,選擇性地新增任何標籤。如需標記 Amazon Personalize 資源的詳細資訊,請參閱標記 Amazon Personalize 資源。
-
選擇建立資料集匯出任務。
在資料集概觀頁面上,在資料集匯出任務中,任務會列出匯出任務狀態。當狀態為 ACTIVE 時,資料集匯出任務即完成。然後,您可以從輸出 Amazon S3 儲存貯體下載資料。如需從 Amazon S3 儲存貯體下載物件的資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的下載物件。
建立資料集匯出任務 (AWS CLI)
將資料匯入資料集並建立輸出 Amazon S3 儲存貯體後,您可以將資料集匯出至儲存貯體進行分析。若要使用 匯出資料集 AWS CLI,請使用 create-dataset-export-job
AWS CLI 命令建立資料集匯出任務。如需有關建立 Amazon S3 儲存貯體的資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的建立儲存貯體。
匯出資料集之前,請確定 Amazon Personalize 服務角色可以存取和寫入您的輸出 Amazon S3 儲存貯體。請參閱 資料集匯出任務許可要求。
以下是 create-dataset-export-job
AWS CLI 命令的範例。為任務命名、dataset arn
將 取代為您要匯出之資料集的 Amazon Resource Name (ARN),並將 取代role ARN
為您在 中建立的 Amazon Personalize 服務角色的 ARN為 Amazon Personalize 建立 IAM 角色。在 中s3DataDestination
,對於 kmsKeyArn
,選擇性地為您的 AWS KMS 金鑰提供 ARN,對於 ,path
則提供輸出 Amazon S3 儲存貯體的路徑。
針對 ingestion-mode
,指定要從下列選項匯出的資料:
-
指定 僅
BULK
匯出您使用資料集匯入任務大量匯入的資料。 -
指定 僅
PUT
匯出您使用主控台或PutEvents
、PutUsers 或PutItems
操作個別匯入的資料。 -
指定
ALL
匯出資料集中的所有資料。
如需詳細資訊,請參閱CreateDatasetExportJob。
aws personalize create-dataset-export-job \
--job-name job name
\
--dataset-arn dataset ARN
\
--job-output "{\"s3DataDestination\":{\"kmsKeyArn\":\"kms key ARN
\",\"path\":\"s3://amzn-s3-demo-bucket
/folder-name
/\"}}" \
--role-arn role ARN
\
--ingestion-mode PUT
資料集匯出任務 ARN 隨即顯示。
{
"datasetExportJobArn": "arn:aws:personalize:us-west-2:acct-id:dataset-export-job/DatasetExportJobName"
}
使用 DescribeDatasetExportJob
操作來檢查狀態。
aws personalize describe-dataset-export-job \ --dataset-export-job-arn
dataset export job ARN
建立資料集匯出任務AWS SDKs)
將資料匯入資料集並建立輸出 Amazon S3 儲存貯體後,您可以將資料集匯出至儲存貯體進行分析。若要使用 AWS SDKs 匯出資料集,請使用 CreateDatasetExportJob操作建立資料集匯出任務。如需有關建立 Amazon S3 儲存貯體的資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的建立儲存貯體。
下列程式碼說明如何使用適用於 Python 的 SDK (Boto3) 或適用於 Java 的 SDK 2.x SDK 來建立資料集匯出任務。
匯出資料集之前,請確定 Amazon Personalize 服務角色可以存取和寫入您的輸出 Amazon S3 儲存貯體。請參閱 資料集匯出任務許可要求。
使用下列項目將資料集中的資料create_dataset_export_job
匯出至 Amazon S3 儲存貯體。為任務命名、dataset arn
將 取代為您要匯出之資料集的 Amazon Resource Name (ARN),並將 取代role ARN
為您在 中建立的 Amazon Personalize 服務角色的 ARN為 Amazon Personalize 建立 IAM 角色。在 中s3DataDestination
,對於 kmsKeyArn
,選擇性地為您的 AWS KMS 金鑰提供 ARN,對於 ,path
則提供輸出 Amazon S3 儲存貯體的路徑。
針對 ingestionMode
,指定要從下列選項匯出的資料:
-
指定 僅
BULK
匯出您使用資料集匯入任務大量匯入的資料。 -
指定 僅
PUT
匯出您使用主控台或PutEvents
、PutUsers 或PutItems
操作個別匯入的資料。 -
指定
ALL
匯出資料集中的所有資料。
import boto3
personalize = boto3.client('personalize')
response = personalize.create_dataset_export_job(
jobName = 'job name
',
datasetArn = 'dataset ARN
',
jobOutput = {
"s3DataDestination": {
"kmsKeyArn": "kms key ARN
",
"path": "s3://amzn-s3-demo-bucket/folder-name/
"
}
},
roleArn = 'role ARN
',
ingestionMode = 'PUT
'
)
dsej_arn = response['datasetExportJobArn']
print ('Dataset Export Job arn: ' + dsej_arn)
description = personalize.describe_dataset_export_job(
datasetExportJobArn = dsej_arn)['datasetExportJob']
print('Name: ' + description['jobName'])
print('ARN: ' + description['datasetExportJobArn'])
print('Status: ' + description['status'])