CreateDataset - Amazon Forecast

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateDataset

Erstellt ein Amazon Forecast-Dataset. Die Informationen über den Datensatz, den Sie bereitstellen, helfen Forecast zu verstehen, wie die Daten für das Modelltraining verwendet werden. Diese umfasst die folgenden Funktionen:

  • DataFrequency - Wie häufig werden Ihre historischen Zeitreihendaten erfasst.

  • Domain und DatasetType - Jeder Datensatz hat eine zugeordnete Dataset-Domäne und einen Typ innerhalb der Domäne. Amazon Forecast bietet eine Liste vordefinierter Domänen und Typen innerhalb jeder Domäne. Für jede eindeutige Dataset-Domäne und jeden Typ innerhalb der Domäne erfordert Amazon Forecast, dass Ihre Daten einen Mindestsatz an vordefinierten Feldern enthalten.

  • Schema - Ein Schema gibt die Felder im Dataset an, einschließlich des Feldnamens und Datentyps.

Nach dem Erstellen eines Datasets importieren Sie Ihre Schulungsdaten darin und fügen den Dataset einer Datasetgruppe hinzu. Sie verwenden die Datensatzgruppe, um einen Prädiktor zu erstellen. Weitere Informationen finden Sie unterImportieren von Datasetsaus.

Um eine Liste aller Ihrer Datasets abzurufen, verwenden Sie dieListDatasetsverwenden.

Zum Beispiel Forecast-Datasets finden Sie in derAmazon-Prognose-Beispiel-GitHub-Repositoryaus.

Anmerkung

Der Status eines Datasets muss ACTIVE sein, bevor Sie Schulungsdaten importieren können. Verwenden derDescribeDataset-Operation, um den Status abzurufen.

Anforderungssyntax

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

Anfrageparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

DataFrequency

Die Häufigkeit der Datenerfassung. Dieser Parameter ist für RELATED_TIME_SERIES-Datasets erforderlich.

Gültige Intervalle sind Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde), 30 Minuten (30 Minuten), 15 Minuten (15 Minuten), 10 Minuten (10 Minuten), 5 Minuten (5 Minuten) und 1 Minute (1 Minute). Zum Beispiel zeigt „D“ jeden Tag an und „15min“ zeigt alle 15 Minuten an.

Type: String (Zeichenfolge)

Einschränkungen für die Länge: Mindestlänge 1. Maximale Länge beträgt 5.

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

Erforderlich: Nein

DatasetName

Ein Name für das Dataset.

Type: String (Zeichenfolge)

Einschränkungen für die Länge: Mindestlänge 1. Maximale Länge beträgt 63 Zeichen.

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

Erforderlich: Ja

DatasetType

Der Datensatztyp. Gültige Werte sind abhängig von den gewähltenDomainaus.

Type: String (Zeichenfolge)

Zulässige Werte: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Erforderlich: Ja

Domain

Die mit dem Datensatz verknüpfte Domäne. Wenn Sie einer Datensatzgruppe ein Dataset hinzufügen, werden dieser Wert und der Wert, der für dieDomain-Parameter desCreateDatasetGroup-Betrieb muss übereinstimmen.

DieDomainundDatasetTypedie Sie auswählen, bestimmen Sie die Felder, die in den Trainingsdaten vorhanden sein müssen, die Sie in den Datensatz importieren. Wenn Sie beispielsweise dieRETAILDomain undTARGET_TIME_SERIESwie derDatasetType, Amazon Forecast erfordertitem_id,timestamp, unddemand-Felder, die in Ihren Daten vorhanden sein sollen. Weitere Informationen finden Sie unterImportieren von Datasetsaus.

Type: String (Zeichenfolge)

Zulässige Werte: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

Erforderlich: Ja

EncryptionConfig

Der Key AWS Key Management Service (KMS) -Schlüssel und die AWS Identity and Access Management (IAM) -Rolle, die Amazon Forecast übernehmen kann, um auf den Schlüssel zuzugreifen.

Typ: EncryptionConfig Objekt

Erforderlich: Nein

Schema

Das Schema für den Datensatz. Die Schemaattribute und ihre Reihenfolge müssen mit den Feldern in Ihren Daten übereinstimmen. Der DatensatzDomainundDatasetTypedie Sie wählen, bestimmen Sie die erforderlichen Mindestfelder in Ihren Trainingsdaten. Informationen zu den erforderlichen Feldern für eine bestimmte Dataset-Domäne und einen bestimmten Typ finden Sie unterDataset-Domänen und Dataset-Typenaus.

Typ: Schema Objekt

Erforderlich: Ja

Tags

Die optionalen Metadaten, die Sie auf das Dataset anwenden, um die Kategorisierung und Organisation zu erleichtern. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

  • Die maximale Anzahl an Tags pro Ressource beträgt 50.

  • Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.

  • Maximale Schlüssellänge — 128 Unicode-Zeichen in UTF-8.

  • Maximale Wertlänge = 256 Unicode-Zeichen in UTF-8.

  • Wenn Ihr Markierungsschema für mehrere Services und Ressourcen verwendet wird, denken Sie daran, dass andere Services möglicherweise Einschränkungen für zulässige Zeichen haben. Allgemein erlaubte Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die in UTF-8 darstellbar sind, und die folgenden Sonderzeichen: + - = . _ : / @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß-/Kleinschreibung beachtet werden.

  • Nicht verwendenaws:,AWS:oder Kombinationen aus Groß- und Kleinbuchstaben von diesen als Präfix für Schlüssel, da sie für die AWS-Verwendung reserviert sind. Sie können keine Tag-Schlüssel oder mit diesem Präfix bearbeiten oder löschen. Werte können dieses Präfix haben. Wenn ein Tag-Wert hatawsals Präfix, aber der Schlüssel nicht, betrachtet Forecast es als Benutzer-Tag und zählt auf das Limit von 50 Tags. Tags mit nur dem key prefix vonawsNicht als Ihre Tags pro Ressourcenlimit angerechnet.

Type: Array vonTagObjekte

Array-Mitglieder: Minimale Anzahl der Elemente: 0. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{ "DatasetArn": "string" }

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

DatasetArn

Der Amazon-Ressourcenname (ARN) des Datasets.

Type: String (Zeichenfolge)

Einschränkungen für die Länge: Maximale Länge beträgt 256 Zeichen.

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

Fehler

InvalidInputException

Wir können die Anfrage nicht bearbeiten, da sie einen ungültigen Wert oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTP-Statuscode: 400

LimitExceededException

Das Limit für die Anzahl an Ressourcen pro Konto wurde überschritten.

HTTP-Statuscode: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Geben Sie einen anderen Namen ein.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: