Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

CreateDatasetImportJob

Mengimpor data pelatihan Anda ke dataset Amazon Forecast. Anda memberikan lokasi data pelatihan Anda dalam bucket Amazon Simple Storage Service (Amazon S3) dan Nama Sumber Daya Amazon (ARN) dari kumpulan data yang ingin Anda impor data.

penting

Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”

Anda harus menentukan DataSource objek 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 jalur 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 yang digunakan saat melatih prediktor atau membuat perkiraan. Pastikan impor dataset terbaru 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 ListDatasetImportJobs operasi.

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 tempat Anda ingin mengimpor data.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Ya

DatasetImportJobName

Nama untuk pekerjaan impor dataset. Sebaiknya sertakan stempel waktu saat ini dalam nama, misalnya,. 20190721DatasetImport Ini dapat membantu Anda menghindari peng ResourceAlreadyExistsException ecualian.

Tipe: 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. Kunci KMS dan peran IAM harus sesuai 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.

Tipe: String

Batasan Panjang: Panjang maksimum 7.

Pola: ^CSV|PARQUET$

Wajib: Tidak

GeolocationFormat

Format atribut geolokasi. Atribut geolokasi dapat diformat dengan 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 pos 5 digit (Contoh: US_98121).

Tipe: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Tidak

ImportMode

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

Tipe: String

Nilai yang Valid: FULL | INCREMENTAL

Wajib: Tidak

Tags

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

Batasan dasar berikut berlaku untuk tanda:

Jumlah maksimum tag per sumber daya - 50.
Untuk setiap sumber daya, setiap kunci tanda harus unik, dan setiap kunci tanda hanya dapat memuat satu nilai.
Panjang kunci maksimum - 128 karakter Unicode dalam UTF-8.
Panjang nilai maksimum - 256 karakter Unicode dalam UTF-8.
Jika skema pemberian tag Anda digunakan di beberapa layanan dan sumber daya , ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter yang umumnya diizinkan adalah: huruf, angka, dan spasi yang dapat direpresent UTF-8 asikan dalam, dan karakter berikut: + - =. _:/@.
Kunci dan nilai tag peka huruf besar/kecil.
Jangan gunakanaws:,AWS:, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci karena disediakan untuk AWS digunakan. Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini. Nilai dapat memiliki awalan ini. Jika nilai tag memiliki awalan tetapi kuncinya tidak, maka Forecast menganggapnya aws sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya awalan kunci 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 cap waktu dalam dataset. Format yang Anda tentukan tergantung pada DataFrequency waktu yang 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”.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

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

Wajib: Tidak

TimeZone

Satu zona waktu untuk setiap item dalam dataset 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.

Tipe: 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 cap waktu di beberapa zona waktu dan stempel waktu tersebut dinyatakan dalam waktu lokal.

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.

Tipe: 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 menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CreateDatasetGroup

CreateExplainability