Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Lihat Juga

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.

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 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 CSV atau format 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 JSON format.

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.

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 IAM peran harus mengizinkan izin Amazon Forecast untuk mengakses kunci. KMSKunci dan IAM peran harus cocok dengan yang ditentukan dalam EncryptionConfig parameter CreateDatasetoperasi.

Tipe: Objek DataSource

Wajib: Ya

Format

Format data yang diimpor, CSV atauPARQUET. Nilai defaultnya adalahCSV.

Tipe: 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 ZIP kode 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.

Tipe: 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 yang diizinkan secara umum adalah: huruf, angka, dan spasi yang dapat direpresentasikan dalam UTF -8, dan 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.

Data berikut dikembalikan dalam JSON format oleh layanan.

DatasetImportJobArn

Amazon Resource Name (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.

HTTPKode Status: 400

LimitExceededException

Batas jumlah sumber daya per akun telah terlampaui.

HTTPKode Status: 400

ResourceAlreadyExistsException

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

HTTPKode Status: 400

ResourceInUseException

Sumber daya yang ditentukan sedang digunakan.

HTTPKode Status: 400

ResourceNotFoundException

Kami tidak dapat menemukan sumber daya dengan Amazon Resource Name (ARN). Periksa ARN dan coba lagi.

HTTPKode Status: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, 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