CreateDatasetImportJob - Amazon Personalize
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateDatasetImportJob

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 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.

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_PROGRESS> AKTIF -atau- BUAT GAGAL

Untuk mendapatkan status pekerjaan impor, hubungi DescribeDatasetImportJob, 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.

API Terkait

Sintaksis Permintaan

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

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

datasetArn

ARN dari dataset yang menerima data yang diimpor.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Diperlukan: Ya

dataSource

Bucket Amazon S3 yang berisi data pelatihan untuk diimpor.

Tipe: Objek DataSource

Wajib: Ya

importMode

Tentukan cara menambahkan catatan baru ke kumpulan data yang ada. Mode impor default adalahFULL. Jika Anda belum mengimpor catatan massal ke dalam kumpulan data sebelumnya, Anda hanya dapat menentukanFULL.

  • 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.

Jenis: String

Nilai yang Valid: FULL | INCREMENTAL

Diperlukan: Tidak

jobName

Nama untuk pekerjaan impor dataset.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

Pola: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Diperlukan: Ya

publishAttributionMetricsToS3

Jika Anda membuat atribusi metrik, tentukan apakah akan memublikasikan metrik untuk pekerjaan impor ini ke Amazon S3

Tipe: Boolean

Wajib: Tidak

roleArn

ARN dari peran IAM yang memiliki izin untuk membaca dari sumber data Amazon S3.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

Diperlukan: Ya

tags

Daftar tag untuk diterapkan ke pekerjaan impor dataset.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.

Diperlukan: Tidak

Sintaksis Respons

{
   "datasetImportJobArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

datasetImportJobArn

ARN dari pekerjaan impor dataset.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):personalize:.*:.*:.+

Kesalahan

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

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: