CreateDataset

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

• DataFrequency – Wie oft Ihre historischen Zeitreihendaten gesammelt werden.

• Domain und DatasetType – Jeder Datensatz hat eine zugeordnete Datensatzdomain und einen Typ innerhalb der Domain. Amazon Forecast bietet eine Liste vordefinierter Domains und Typen innerhalb jeder Domain. Für jede eindeutige Datensatzdomain und jeden Typ innerhalb der Domain verlangt Amazon Forecast, dass Ihre Daten einen Mindestsatz vordefinierter Felder enthalten.

• Schema – Ein Schema gibt die Felder im Datensatz an, einschließlich Feldname und Datentyp.

Nachdem Sie einen Datensatz erstellt haben, importieren Sie Ihre Trainingsdaten hinein und fügen den Datensatz einer Datensatzgruppe hinzu. Sie verwenden die Datensatz-Gruppe, um einen Prädiktor zu erstellen. Weitere Informationen finden Sie unter Importieren von Datensätzen.

Um eine Liste aller Datensätze abzurufen, verwenden Sie die ListDatasetsOperation.

Beispiele für Forecast-Datensätze finden Sie im Amazon Forecast Sample GitHub Repository.

Anmerkung

Der Status eines Datasets muss ACTIVE sein, bevor Sie Schulungsdaten importieren können. Verwenden Sie die DescribeDataset -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 Datenerhebung. Dieser Parameter ist für RELATED_TIME_SERIES-Datensätze erforderlich.

Gültige Intervalle sind eine Ganzzahl, gefolgt von Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde) und min (Minute). Beispielsweise steht „D“ für jeden Tag und „15min“ für alle 15 Minuten. Sie können keinen Wert angeben, der sich mit der nächsthöheren Häufigkeit überlappen würde. Das bedeutet, dass Sie beispielsweise keine Häufigkeit von 60 Minuten angeben können, da dies einer Stunde entspricht. Die folgenden Werte sind gültige Werte für die Häufigkeit:

• Minute (1–59)

• Stunde (1–23)

• Tag (1–6)

• Woche (1–4)

• Monat (1–11)

• Jahr (1)

Wenn Sie also Vorhersagen für jede zweite Woche wünschen, geben Sie „2W“ an. Oder, wenn Sie vierteljährliche Vorhersagen wünschen, geben Sie „3M“ an.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge 5 Zeichen.

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

Erforderlich: Nein

DatasetName

Ein Name für den Datensatz.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 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 ausgewählten WertenDomain.

Typ: Zeichenfolge

Zulässige Werte: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Erforderlich: Ja

Domain

Die dem Datensatz zugeordnete Domain. Wenn Sie einen Datensatz zu einer Datensatz-Gruppe hinzufügen, müssen dieser Wert und der für den Domain Parameter der CreateDatasetGroupOperation angegebene Wert übereinstimmen.

Die von Ihnen DatasetType ausgewählten Domain und anderen Elemente bestimmen die Felder, die in den Trainingsdaten vorhanden sein müssen, die Sie in den Datensatz importieren. Wenn Sie beispielsweise die RETAIL Domain und TARGET_TIME_SERIES als die auswählenDatasetType, verlangt Amazon Forecastitem_id, undtimestamp, dass die demand Felder in Ihren Daten vorhanden sind. Weitere Informationen finden Sie unter Importieren von Datensätzen.

Typ: Zeichenfolge

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

Erforderlich: Ja

EncryptionConfig

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

Typ: EncryptionConfig Objekt

Required: No

Schema

Das Schema für den Datensatz. Die Schema-Attribute und ihre Reihenfolge müssen mit den Feldern in Ihren Daten übereinstimmen. Die von Ihnen ausgewählten Datensätze Domain und DatasetType bestimmen die mindestens erforderlichen Felder in Ihren Trainingsdaten. Weitere Informationen zu den erforderlichen Feldern für eine bestimmte Datensatzdomain und einen bestimmten Typ finden Sie unter Datensatz-Domains und Datensatz-Typen.

Typ: Schema Objekt

Erforderlich: Ja

Tags

Die optionalen Metadaten, die Sie auf den Datensatz 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ß- und Kleinschreibung beachtet werden.

• Verwenden aws: Sie weder noch oder anderen Kombinationen aus Groß- und Kleinbuchstaben als Präfix für Schlüssel, da sie für die AWS -Verwendung reserviert sind. AWS: Sie können keine Tag-Schlüssel mit diesem Präfix bearbeiten oder löschen. Werte können dieses Präfix haben. Wenn ein Tag-Wert ein Präfix hataws, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzer-Tag und zählt auf das Limit von 50 Tags an. Tags mit dem key prefix werden aws nicht als Ihre Tags pro Ressourcenlimit angerechnet.

Typ: Array von Tag-Objekten

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

Required: No

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 Datensatzes.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 256.

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

Fehler

InvalidInputException

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

HTTP Status Code: 400

LimitExceededException

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

HTTP Status Code: 400

ResourceAlreadyExistsException

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

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

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

• AWS-Befehlszeilenschnittstelle

• AWS-SDK für .NET

• AWS-SDK für C++

• AWS-SDK für Go

• AWS-SDK für Java V2

• AWSSDK für JavaScript

• AWS SDK für PHP V3

• AWS SDK für Python

• AWS SDK für Ruby V3