CreateDatasetImportJob

Mengimpor data pelatihan Anda ke kumpulan data Amazon Forecast. Anda menyediakan lokasi data latihan di bucket Amazon Simple Storage Service (Amazon S3) dan Amazon Resource Name (ARN) dari kumpulan data yang ingin Anda impor datanya.

Anda harus menentukan DataSourceobjek yang menyertakan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses data, karena Amazon Forecast membuat salinan data Anda dan memprosesnya dalam AWS sistem internal. Untuk informasi selengkapnya, lihat Menyiapkan izin.

Data pelatihan harus dalam format CSV atau Parket. Pembatas harus berupa koma (,).

Anda dapat menentukan path ke file tertentu, bucket S3, atau ke folder di bucket S3. Untuk dua kasus terakhir, Amazon Forecast mengimpor semua file hingga batas 10.000 file.

Karena impor dataset tidak digabungkan, impor dataset terbaru Anda adalah impor yang digunakan saat melatih prediktor atau menghasilkan perkiraan. Pastikan impor dataset terbaru Anda berisi semua data yang ingin Anda modelkan, dan bukan hanya data baru yang dikumpulkan sejak impor sebelumnya.

Untuk mendapatkan daftar semua pekerjaan impor dataset Anda, disaring berdasarkan kriteria yang ditentukan, gunakan ListDatasetImportJobsoperasi.

Sintaksis Permintaan

{
   "DatasetArn": "string",
   "DatasetImportJobName": "string",
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "GeolocationFormat": "string",
   "ImportMode": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimestampFormat": "string",
   "TimeZone": "string",
   "UseGeolocationForTimeZone": boolean
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

DatasetArn

Nama Sumber Daya Amazon (ARN) dari kumpulan data Amazon Forecast yang ingin Anda impor datanya.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Ya

DatasetImportJobName

Nama untuk pekerjaan impor dataset. Kami merekomendasikan menyertakan stempel waktu saat ini dalam nama, misalnya,. 20190721DatasetImport Ini dapat membantu Anda menghindari ResourceAlreadyExistsException pengecualian.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Wajib: Ya

DataSource

Lokasi data pelatihan yang akan diimpor dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses data. Data pelatihan harus disimpan dalam bucket Amazon S3.

Jika enkripsi digunakan, DataSource harus menyertakan kunci AWS Key Management Service (KMS) dan peran IAM harus mengizinkan izin Amazon Forecast untuk mengakses kunci tersebut. Kunci KMS dan peran IAM harus cocok dengan yang ditentukan dalam EncryptionConfig parameter operasi. CreateDataset

Tipe: Objek DataSource

Wajib: Ya

Format

Format data yang diimpor, CSV atau PARQUET. Nilai defaultnya adalah CSV.

Jenis: String

Kendala Panjang: Panjang maksimum 7.

Pola: ^CSV|PARQUET$

Wajib: Tidak

GeolocationFormat

Format atribut geolokasi. Atribut geolokasi dapat diformat dalam salah satu dari dua cara:

• LAT_LONG- garis lintang dan bujur dalam format desimal (Contoh: 47.61_-122.33).

• CC_POSTALCODE(Hanya AS) - kode negara (AS), diikuti oleh kode ZIP 5 digit (Contoh: US_98121).

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^[a-zA-Z0-9_]+$

Wajib: Tidak

ImportMode

Menentukan apakah pekerjaan dataset impor adalah FULL atau INCREMENTAL impor. Impor FULL dataset menggantikan semua data yang ada dengan data yang baru diimpor. INCREMENTALImpor menambahkan data yang diimpor ke data yang ada.

Jenis: String

Nilai yang Valid: FULL | INCREMENTAL

Wajib: Tidak

Tags

Metadata opsional yang Anda terapkan pada pekerjaan impor kumpulan data untuk membantu Anda mengkategorikan dan mengaturnya. Setiap tag terdiri dari kunci dan nilai opsional, yang keduanya Anda tentukan.

Batasan dasar berikut berlaku untuk tag:

• Jumlah maksimum tag per sumber daya - 50.

• Untuk setiap sumber daya, setiap kunci tag harus unik, dan setiap kunci tag hanya dapat memiliki satu nilai.

• Panjang kunci maksimum - 128 karakter Unicode di UTF-8.

• Panjang nilai maksimum - 256 karakter Unicode di UTF-8.

• Jika skema penandaan Anda digunakan di beberapa layanan dan sumber daya, ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter-karakter yang diizinkan secara umum adalah: huruf, angka, dan spasi yang dapat diwakili dalam UTF-8, beserta karakter-karakter berikut: + - = . _ : / @.

• Kunci dan nilai tanda peka huruf besar-kecil.

• Jangan gunakanaws:,AWS:, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci karena dicadangkan untuk digunakan. AWS Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini. Nilai dapat memiliki awalan ini. Jika nilai tag memiliki aws awalan tetapi kuncinya tidak, maka Forecast menganggapnya sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya key prefix dari aws tidak dihitung terhadap tag Anda per batas sumber daya.

Tipe: Array objek Tag

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

Wajib: Tidak

TimestampFormat

Format stempel waktu dalam dataset. Format yang Anda tentukan tergantung pada yang DataFrequency ditentukan saat dataset dibuat. Format berikut didukung

• “YYYY-MM-DD”

  Untuk frekuensi data berikut: Y, M, W, dan D

• “YYYY-MM-DD HH: mm: SS”

  Untuk frekuensi data berikut: H, 30 menit, 15 menit, dan 1 menit; dan opsional, untuk: Y, M, W, dan D

Jika format tidak ditentukan, Amazon Forecast mengharapkan formatnya menjadi “YYYY-MM-DD HH: mm:ss”.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

Wajib: Tidak

TimeZone

Zona waktu tunggal untuk setiap item dalam kumpulan data Anda. Opsi ini ideal untuk kumpulan data dengan semua stempel waktu dalam satu zona waktu, atau jika semua stempel waktu dinormalisasi ke satu zona waktu.

Lihat Joda-Time API untuk daftar lengkap nama zona waktu yang valid.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^[a-zA-Z0-9\/\+\-\_]+$

Wajib: Tidak

UseGeolocationForTimeZone

Secara otomatis memperoleh informasi zona waktu dari atribut geolokasi. Opsi ini ideal untuk kumpulan data yang berisi stempel waktu di beberapa zona waktu dan stempel waktu tersebut dinyatakan dalam waktu setempat.

Tipe: Boolean

Wajib: Tidak

Sintaksis Respons

{
   "DatasetImportJobArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

DatasetImportJobArn

Nama Sumber Daya Amazon (ARN) dari pekerjaan impor dataset.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

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

Kesalahan

InvalidInputException

Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid.

Kode Status HTTP: 400

LimitExceededException

Batas jumlah sumber daya per akun telah terlampaui.

Kode Status HTTP: 400

ResourceAlreadyExistsException

Sudah ada sumber daya dengan nama ini. Coba lagi dengan nama yang berbeda.

Kode Status HTTP: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

Kode Status HTTP: 400

ResourceNotFoundException

Kami tidak dapat menemukan sumber daya dengan Nama Sumber Daya Amazon (ARN) itu. Periksa ARN dan coba lagi.

Kode Status HTTP: 400

Lihat Juga

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

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3