Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# CreateDatasetImportJob
<a name="API_CreateDatasetImportJob"></a>

Membuat job yang mengimpor data pelatihan dari sumber data Anda (bucket Amazon S3) ke kumpulan data Amazon Personalize. Untuk mengizinkan Amazon Personalisasi mengimpor data pelatihan, Anda harus menentukan peran layanan IAM yang memiliki izin untuk membaca dari sumber data, karena Amazon Personalize membuat salinan data Anda dan memprosesnya secara internal. Untuk informasi tentang pemberian akses ke bucket Amazon S3, [lihat Memberikan Amazon Personalisasi Akses ke Sumber Daya Amazon](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html) S3. 

Jika Anda telah membuat pemberi rekomendasi atau menerapkan versi solusi kustom dengan kampanye, bagaimana catatan massal baru memengaruhi rekomendasi bergantung pada kasus penggunaan domain atau resep yang Anda gunakan. Untuk informasi selengkapnya, lihat [Bagaimana data baru memengaruhi rekomendasi waktu nyata](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html).

**penting**  
Secara default, pekerjaan impor dataset menggantikan data yang ada dalam kumpulan data yang Anda impor secara massal. Untuk menambahkan catatan baru tanpa mengganti data yang ada, tentukan INCREMENTAL untuk mode impor dalam CreateDatasetImportJob operasi.

 **Status** 

Pekerjaan impor dataset dapat berada di salah satu status berikut:
+ BUAT TERTUNDA > BUAT IN\$1PROGRESS> AKTIF -atau- BUAT GAGAL

Untuk mendapatkan status pekerjaan impor, hubungi [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html), berikan Nama Sumber Daya Amazon (ARN) dari pekerjaan impor kumpulan data. Impor dataset selesai ketika status ditampilkan sebagai AKTIF. Jika status ditampilkan sebagai CREATE FAILED, respons menyertakan `failureReason` kunci, yang menjelaskan mengapa pekerjaan gagal.

**catatan**  
Mengimpor membutuhkan waktu. Anda harus menunggu hingga status ditampilkan sebagai AKTIF sebelum melatih model menggunakan kumpulan data.

**Terkait APIs**
+  [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) 
+  [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) 

## Sintaksis Permintaan
<a name="API_CreateDatasetImportJob_RequestSyntax"></a>

```
{
   "datasetArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "importMode": "string",
   "jobName": "string",
   "publishAttributionMetricsToS3": boolean,
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parameter Permintaan
<a name="API_CreateDatasetImportJob_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [datasetArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-datasetArn"></a>
ARN dari dataset yang menerima data yang diimpor.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Wajib: Ya

 ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-dataSource"></a>
Bucket Amazon S3 yang berisi data pelatihan untuk diimpor.  
Tipe: Objek [DataSource](API_DataSource.md)  
Wajib: Ya

 ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-importMode"></a>
Tentukan cara menambahkan catatan baru ke kumpulan data yang ada. Mode impor default adalah`FULL`. Jika Anda belum mengimpor catatan massal ke dalam kumpulan data sebelumnya, Anda hanya dapat menentukan`FULL`.  
+ Tentukan `FULL` untuk menimpa semua data massal yang ada di kumpulan data Anda. Data yang Anda impor satu per satu tidak diganti.
+ Tentukan `INCREMENTAL` untuk menambahkan catatan baru ke data yang ada di kumpulan data Anda. Amazon Personalize menggantikan catatan apa pun dengan ID yang sama dengan yang baru.
Tipe: String  
Nilai yang Valid: `FULL | INCREMENTAL`   
Wajib: Tidak

 ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-jobName"></a>
Nama untuk pekerjaan impor dataset.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Wajib: Ya

 ** [publishAttributionMetricsToS3](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-publishAttributionMetricsToS3"></a>
Jika Anda membuat atribusi metrik, tentukan apakah akan memublikasikan metrik untuk pekerjaan impor ini ke Amazon S3  
Tipe: Boolean  
Wajib: Tidak

 ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-roleArn"></a>
ARN dari peran IAM yang memiliki izin untuk membaca dari sumber data Amazon S3.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Wajib: Tidak

 ** [tags](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-tags"></a>
Daftar [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) untuk diterapkan ke pekerjaan impor dataset.  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

## Sintaksis Respons
<a name="API_CreateDatasetImportJob_ResponseSyntax"></a>

```
{
   "datasetImportJobArn": "string"
}
```

## Elemen Respons
<a name="API_CreateDatasetImportJob_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [datasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetImportJob-response-datasetImportJobArn"></a>
ARN dari pekerjaan impor dataset.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Kesalahan
<a name="API_CreateDatasetImportJob_Errors"></a>

 ** InvalidInputException **   
Berikan nilai yang valid untuk bidang atau parameter.  
Kode Status HTTP: 400

 ** LimitExceededException **   
Batas jumlah permintaan per detik telah terlampaui.  
Kode Status HTTP: 400

 ** ResourceAlreadyExistsException **   
Sumber daya yang ditentukan sudah ada.  
Kode Status HTTP: 400

 ** ResourceInUseException **   
Sumber daya yang ditentukan sedang digunakan.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Tidak dapat menemukan sumber daya yang ditentukan.  
Kode Status HTTP: 400

 ** TooManyTagsException **   
Anda telah melampaui jumlah maksimum tag yang dapat Anda terapkan ke sumber daya ini.   
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateDatasetImportJob_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob)