View a markdown version of this page

CreateDataset - Amazon Forecast
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

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

CreateDataset

Membuat dataset Amazon Forecast.

penting

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

Informasi tentang kumpulan data yang Anda berikan membantu Forecast memahami cara menggunakan data untuk pelatihan model. Ini termasuk yang berikut:

  • DataFrequency- Seberapa sering data deret waktu historis Anda dikumpulkan.

  • Domaindan DatasetType - Setiap dataset memiliki domain dataset terkait dan tipe dalam domain. Amazon Forecast menyediakan daftar domain dan jenis yang telah ditentukan sebelumnya dalam setiap domain. Untuk setiap domain dan jenis kumpulan data unik dalam domain, Amazon Forecast mengharuskan data Anda menyertakan kumpulan minimum bidang yang telah ditentukan sebelumnya.

  • Schema- Skema menentukan bidang dalam dataset, termasuk nama bidang dan tipe data.

Setelah membuat dataset, Anda mengimpor data pelatihan ke dalamnya dan menambahkan dataset ke grup dataset. Anda menggunakan grup dataset untuk membuat prediktor. Untuk informasi selengkapnya, lihat Meng impor kumpulan data.

Untuk mendapatkan daftar semua kumpulan data Anda, gunakan ListDatasets operasi.

Misalnya kumpulan data Prakiraan, lihat GitHub repositori Sam pel Prakiraan Amazon.

catatan

Dataset harus ada ACTIVE sebelum Anda dapat mengimpor data pelatihan. Status Gunakan DescribeDataset operasi untuk mendapatkan status.

Sintaksis Permintaan

{
   "DataFrequency": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parameter Permintaan

Permintaan menerima data berikut dalam format JSON.

DataFrequency

Frekuensi pengumpulan data. Parameter ini diperlukan untuk dataset RELATED_TIME_SERIES.

Interval yang valid adalah bilangan bulat diikuti oleh Y (Tahun), M (Bulan), W (Minggu), D (Hari), H (Jam), dan min (Menit). Misalnya, “1D” menunjukkan setiap hari dan “15min” menunjukkan setiap 15 menit. Anda tidak dapat menentukan nilai yang akan tumpang tindih dengan frekuensi berikutnya yang lebih besar. Itu berarti, misalnya, Anda tidak dapat menentukan frekuensi 60 menit, karena itu setara dengan 1 jam. Nilai yang valid untuk setiap frekuensi adalah sebagai berikut:

  • Menit - 1-59

  • Jam - 1-23

  • Hari - 1-6

  • Minggu - 1-4

  • Bulan - 1-11

  • Tahun - 1

Jadi, jika Anda ingin perkiraan setiap minggu, tentukan “2W”. Atau, jika Anda ingin perkiraan triwulanan, Anda menentukan “3M”.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 5.

Pola: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Wajib: Tidak

DatasetName

Nama untuk dataset.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.

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

Wajib: Ya

DatasetType

Jenis dataset. Nilai yang valid tergantung pada yang dipilihDomain.

Tipe: String

Nilai yang Valid: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Wajib: Ya

Domain

Domain yang terkait dengan dataset. Saat Anda menambahkan dataset ke grup dataset, nilai ini dan nilai yang ditentukan untuk Domain parameter CreateDatasetGroup operasi harus cocok.

DomainDan DatasetType yang Anda pilih menentukan bidang yang harus ada dalam data pelatihan yang Anda impor ke dataset. Misalnya, jika Anda memilih RETAIL domain dan TARGET_TIME_SERIES sesuaiDatasetType, Amazon Forecast mewajibkan item_idtimestamp,, dan demand bidang yang akan ada dalam data Anda. Untuk informasi selengkapnya, lihat Meng impor kumpulan data.

Tipe: String

Nilai yang Valid: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

Wajib: Ya

EncryptionConfig

K AWS Key Management Service unci (KMS) dan peran AWS Identity and Access Management (IAM) yang dapat diasumsikan Amazon Forecast untuk mengakses kunci.

Tipe: Objek EncryptionConfig

Wajib: Tidak

Schema

Skema untuk dataset. Atribut skema dan urutannya harus sesuai dengan bidang dalam data Anda. Dataset Domain dan DatasetType yang Anda pilih menentukan bidang minimum yang diperlukan dalam data pelatihan Anda. Untuk informasi tentang bidang yang diperlukan untuk domain dan jenis dataset tertentu, lihat Domain Dataset dan Jenis Dataset.

Tipe: Objek Schema

Wajib: Ya

Tags

Metadata opsional yang Anda terapkan ke dataset 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

Sintaksis Respons

{
   "DatasetArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

DatasetArn

Amazon Resource Name (ARN) dari set data.

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

Lihat Juga

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