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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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. # CreateDatasetImportJob Importiert Ihre Trainingsdaten in einen Amazon Forecast-Datensatz. Sie geben den Speicherort Ihrer Trainingsdaten in einem Amazon Simple Storage Service (Amazon S3) -Bucket und den Amazon-Ressourcennamen (ARN) des Datensatzes an, in den Sie die Daten importieren möchten. **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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) Sie müssen ein [DataSource](https://docs.aws.amazon.com/forecast/latest/dg/API_DataSource.html)Objekt angeben, das eine AWS Identity and Access Management (IAM-) Rolle enthält, die Amazon Forecast für den Zugriff auf die Daten übernehmen kann, da Amazon Forecast eine Kopie Ihrer Daten erstellt und diese in einem internen AWS System verarbeitet. Weitere Informationen finden Sie unter [Berechtigungen einrichten](https://docs.aws.amazon.com/forecast/latest/dg/aws-forecast-iam-roles.html). Die Trainingsdaten müssen im CSV- oder Parquet-Format vorliegen. Das Trennzeichen muss ein Komma (,) sein. Sie können den Pfad zu einer bestimmten Datei, dem S3-Bucket oder zu einem Ordner im S3-Bucket angeben. In den beiden letztgenannten Fällen importiert Amazon Forecast alle Dateien bis zum Limit von 10.000 Dateien. Da Datensatzimporte nicht aggregiert werden, ist Ihr letzter Datensatzimport derjenige, der beim Trainieren eines Prädiktors oder beim Generieren einer Prognose verwendet wird. Stellen Sie sicher, dass Ihr letzter Datensatz-Import alle Daten enthält, anhand derer Sie modellieren möchten, und nicht nur die neuen Daten, die seit dem letzten Import erfasst wurden. Verwenden Sie den [ListDatasetImportJobs](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetImportJobs.html)Vorgang, um eine nach bestimmten Kriterien gefilterte Liste aller Ihrer Datensatz-Importaufträge zu erhalten. ## Anforderungssyntax ``` { "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 } ``` ## Anforderungsparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [DatasetArn](#API_CreateDatasetImportJob_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des Amazon Forecast-Datensatzes, in den Sie Daten importieren möchten. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):forecast:.*:.*:.+` Erforderlich: Ja ** [DatasetImportJobName](#API_CreateDatasetImportJob_RequestSyntax) ** Der Name für den Datensatz-Importjob. Wir empfehlen, den aktuellen Zeitstempel in den Namen aufzunehmen, zum Beispiel. `20190721DatasetImport` Dies kann Ihnen helfen, eine `ResourceAlreadyExistsException` Ausnahme zu vermeiden. 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 ** [DataSource](#API_CreateDatasetImportJob_RequestSyntax) ** Der Speicherort der zu importierenden Trainingsdaten und eine AWS Identity and Access Management (IAM-) Rolle, die Amazon Forecast für den Zugriff auf die Daten übernehmen kann. Die Trainingsdaten müssen in einem Amazon S3 S3-Bucket gespeichert werden. Wenn Verschlüsselung verwendet wird, `DataSource` muss sie einen AWS Key Management Service (KMS-) Schlüssel enthalten und die IAM-Rolle muss Amazon Forecast die Erlaubnis gewähren, auf den Schlüssel zuzugreifen. Der KMS-Schlüssel und die IAM-Rolle müssen mit denen übereinstimmen, die im `EncryptionConfig` Parameter des [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html)Vorgangs angegeben sind. Typ: [DataSource](API_DataSource.md) Objekt Erforderlich: Ja ** [Format](#API_CreateDatasetImportJob_RequestSyntax) ** Das Format der importierten Daten, CSV oder PARQUET. Der Standardwert lautet CSV. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 7. Pattern: `^CSV|PARQUET$` Erforderlich: Nein ** [GeolocationFormat](#API_CreateDatasetImportJob_RequestSyntax) ** Das Format des Geolocation-Attributs. Das Geolocation-Attribut kann auf zwei Arten formatiert werden: + `LAT_LONG`- Breitengrad und Längengrad im Dezimalformat (Beispiel: 47.61\$1-122.33). + `CC_POSTALCODE`(Nur USA) — die Landesvorwahl (USA), gefolgt von der fünfstelligen Postleitzahl (Beispiel: US\$198121). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9_]+$` Erforderlich: Nein ** [ImportMode](#API_CreateDatasetImportJob_RequestSyntax) ** Gibt an, ob es sich bei dem Dataset-Importjob um einen Import oder um einen Import handelt. `FULL` `INCREMENTAL` Ein `FULL` Datensatzimport ersetzt alle vorhandenen Daten durch die neu importierten Daten. Bei einem `INCREMENTAL` Import werden die importierten Daten an die vorhandenen Daten angehängt. Typ: Zeichenfolge Zulässige Werte: `FULL | INCREMENTAL` Erforderlich: Nein ** [Tags](#API_CreateDatasetImportJob_RequestSyntax) ** Die optionalen Metadaten, die Sie auf den Dataset-Importjob anwenden, helfen Ihnen dabei, 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 in UTF-8 dargestellt werden können, sowie die folgenden Zeichen: \$1 - =. \$1:/@. + 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, 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 hat`aws`, 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, werden `aws` nicht auf Ihre Stichwörter pro Ressourcenlimit angerechnet. Typ: Array von [Tag](API_Tag.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente. Erforderlich: Nein ** [TimestampFormat](#API_CreateDatasetImportJob_RequestSyntax) ** Das Format der Zeitstempel im Datensatz. Das Format, das Sie angeben, hängt von dem Format ab, das bei der Erstellung des Datensatzes `DataFrequency` angegeben wurde. Die folgenden Formate werden unterstützt + „yyyy-MM-DD“ Für die folgenden Datenfrequenzen: Y, M, W und D + „yyyy-MM-dd HH:mm:SS“ Für die folgenden Datenfrequenzen: H, 30 Minuten, 15 Minuten und 1 Minute; und optional für: Y, M, W und D Wenn das Format nicht angegeben ist, erwartet Amazon Forecast, dass das Format „yyyy-MM-DD hh:mm:ss“ lautet. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\-\:\.\,\'\s]+$` Erforderlich: Nein ** [TimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** Eine einzige Zeitzone für jeden Artikel in Ihrem Datensatz. Diese Option ist ideal für Datensätze mit allen Zeitstempeln innerhalb einer einzigen Zeitzone oder wenn alle Zeitstempel auf eine einzige Zeitzone normalisiert sind. Eine vollständige Liste der gültigen [Zeitzonennamen finden Sie in der Joda-Time API](http://joda-time.sourceforge.net/timezones.html). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `^[a-zA-Z0-9\/\+\-\_]+$` Erforderlich: Nein ** [UseGeolocationForTimeZone](#API_CreateDatasetImportJob_RequestSyntax) ** Leiten Sie automatisch Zeitzoneninformationen aus dem Geolocation-Attribut ab. Diese Option ist ideal für Datensätze, die Zeitstempel in mehreren Zeitzonen enthalten und diese Zeitstempel in Ortszeit ausgedrückt werden. Typ: Boolesch Erforderlich: Nein ## Antwortsyntax ``` { "DatasetImportJobArn": "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. ** [DatasetImportJobArn](#API_CreateDatasetImportJob_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des Datensatz-Importjobs. 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. HTTP-Statuscode: 400 ** LimitExceededException ** Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten. HTTP-Statuscode: 400 ** ResourceAlreadyExistsException ** Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen. HTTP-Statuscode: 400 ** ResourceInUseException ** Die angegebene Ressource wird verwendet. HTTP-Statuscode: 400 ** ResourceNotFoundException ** Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie den ARN und versuchen Sie es erneut. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: + [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetImportJob) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetImportJob)