Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“
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 einen Amazon-Forecast-Datensatz.
Wichtig
Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“
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
undDatasetType
– 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.
Verwenden Sie die ListDatasetsOperation, um eine Liste all Ihrer Datensätze zu erhalten.
Beispiele für Prognose-Datensätze finden Sie im Amazon GitHub Forecast-Beispiel-Repository
Anmerkung
Der Status
eines Datasets muss ACTIVE
sein, bevor Sie Schulungsdaten importieren können. Verwenden Sie den DescribeDatasetVorgang, 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
"
}
]
}
Anforderungsparameter
Die Anfrage 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 beträgt 1 Zeichen. Die maximale Länge beträgt 5.
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 beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.
Pattern:
^[a-zA-Z][a-zA-Z0-9_]*
Erforderlich: Ja
- DatasetType
-
Der Datensatztyp. Gültige Werte hängen von den ausgewählten Werten ab
Domain
.Typ: Zeichenfolge
Zulässige Werte:
TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA
Erforderlich: Ja
- Domain
-
Die dem Datensatz zugeordnete Domain. Wenn Sie einer Datensatzgruppe einen Datensatz hinzufügen, müssen dieser Wert und der für den
Domain
Parameter der CreateDatasetGroupOperation angegebene Wert übereinstimmen.Die
Domain
von Ihnen ausgewählten Felder bestimmen die Felder, die in den Trainingsdaten vorhanden sein müssen, die Sie in den Datensatz importieren.DatasetType
Wenn Sie beispielsweise dieRETAIL
Domain undTARGET_TIME_SERIES
als die auswählenDatasetType
, verlangt Amazon Forecastitem_id
timestamp
, dassdemand
Felder, und 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 für den Zugriff auf den Schlüssel übernehmen kann.
Typ: EncryptionConfig Objekt
Erforderlich: Nein
- 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
undDatasetType
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 sie zu kategorisieren und zu organisieren. 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):
-
Maximale Anzahl von Tags pro Ressource: 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 zulässige Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die durch UTF -8 dargestellt werden können, sowie die folgenden Zeichen: + - =. _:/@.
-
Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.
-
Verwenden Sie nicht
aws:
,AWS:
, oder eine Kombination von Groß- oder Kleinbuchstaben, wie z. B. ein Präfix, für Schlüssel, da es für die Verwendung reserviert ist. AWS Sie können Tag-Schlüssel mit diesem Präfix nicht 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 Benutzertag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das key prefix von enthalten, werdenaws
nicht auf Ihre Stichwörter pro Ressourcenlimit angerechnet.
Typ: Array von Tag-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Erforderlich: Nein
-
Antwortsyntax
{
"DatasetArn": "string"
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.
- DatasetArn
-
Der Amazon-Ressourcenname (ARN) des Datensatzes.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+
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.
HTTPStatuscode: 400
- LimitExceededException
-
Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten.
HTTPStatuscode: 400
- ResourceAlreadyExistsException
-
Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: