

Für ähnliche Funktionen wie Amazon Timestream für sollten Sie Amazon Timestream for LiveAnalytics InfluxDB in Betracht ziehen. Es bietet eine vereinfachte Datenaufnahme und Antwortzeiten im einstelligen Millisekundenbereich für Analysen in Echtzeit. [Erfahren](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html) Sie hier 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.

# CreateBatchLoadTask
<a name="API_CreateBatchLoadTask"></a>

Erzeugt eine neue Timestream-Batch-Load-Task. Eine Batch-Load-Task verarbeitet Daten aus einer CSV-Quelle an einem S3-Standort und schreibt in eine Timestream-Tabelle. Eine Zuordnung von der Quelle zum Ziel wird in einer Batch-Load-Aufgabe definiert. Fehler und Ereignisse werden in einen Bericht an einem S3-Standort geschrieben. Wenn der AWS KMS Schlüssel für den Bericht nicht angegeben ist, wird der Bericht mit einem verwalteten S3-Schlüssel verschlüsselt, sofern dies möglich `SSE_S3` ist. Andernfalls wird ein Fehler ausgegeben. Weitere Informationen finden Sie unter [Von AWS verwaltete Schlüssel](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Hier gelten Servicekontingente.](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html) Einzelheiten finden Sie im [Codebeispiel](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html).

## Anforderungssyntax
<a name="API_CreateBatchLoadTask_RequestSyntax"></a>

```
{
   "ClientToken": "string",
   "DataModelConfiguration": { 
      "DataModel": { 
         "DimensionMappings": [ 
            { 
               "DestinationColumn": "string",
               "SourceColumn": "string"
            }
         ],
         "MeasureNameColumn": "string",
         "MixedMeasureMappings": [ 
            { 
               "MeasureName": "string",
               "MeasureValueType": "string",
               "MultiMeasureAttributeMappings": [ 
                  { 
                     "MeasureValueType": "string",
                     "SourceColumn": "string",
                     "TargetMultiMeasureAttributeName": "string"
                  }
               ],
               "SourceColumn": "string",
               "TargetMeasureName": "string"
            }
         ],
         "MultiMeasureMappings": { 
            "MultiMeasureAttributeMappings": [ 
               { 
                  "MeasureValueType": "string",
                  "SourceColumn": "string",
                  "TargetMultiMeasureAttributeName": "string"
               }
            ],
            "TargetMultiMeasureName": "string"
         },
         "TimeColumn": "string",
         "TimeUnit": "string"
      },
      "DataModelS3Configuration": { 
         "BucketName": "string",
         "ObjectKey": "string"
      }
   },
   "DataSourceConfiguration": { 
      "CsvConfiguration": { 
         "ColumnSeparator": "string",
         "EscapeChar": "string",
         "NullValue": "string",
         "QuoteChar": "string",
         "TrimWhiteSpace": boolean
      },
      "DataFormat": "string",
      "DataSourceS3Configuration": { 
         "BucketName": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "RecordVersion": number,
   "ReportConfiguration": { 
      "ReportS3Configuration": { 
         "BucketName": "string",
         "EncryptionOption": "string",
         "KmsKeyId": "string",
         "ObjectKeyPrefix": "string"
      }
   },
   "TargetDatabaseName": "string",
   "TargetTableName": "string"
}
```

## Anforderungsparameter
<a name="API_CreateBatchLoadTask_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ClientToken"></a>
  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.  
Erforderlich: Nein

 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataModelConfiguration"></a>
  
Typ: [DataModelConfiguration](API_DataModelConfiguration.md) Objekt  
Erforderlich: Nein

 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-DataSourceConfiguration"></a>
Definiert Konfigurationsdetails zur Datenquelle für eine Batch-Load-Task.  
Typ: [DataSourceConfiguration](API_DataSourceConfiguration.md) Objekt  
Erforderlich: Ja

 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-RecordVersion"></a>
  
Type: Long  
Erforderlich: Nein

 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-ReportConfiguration"></a>
Berichtskonfiguration für eine Batch-Load-Aufgabe. Dies enthält Details darüber, wo Fehlerberichte gespeichert werden.  
Typ: [ReportConfiguration](API_ReportConfiguration.md) Objekt  
Erforderlich: Ja

 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetDatabaseName"></a>
Timestream-Zieldatenbank für eine Batch-Load-Aufgabe.  
Typ: Zeichenfolge  
Pattern: `[a-zA-Z0-9_.-]+`   
Erforderlich: Ja

 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) **   <a name="timestream-CreateBatchLoadTask-request-TargetTableName"></a>
Ziel-Timestream-Tabelle für eine Batch-Load-Aufgabe.  
Typ: Zeichenfolge  
Pattern: `[a-zA-Z0-9_.-]+`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_CreateBatchLoadTask_ResponseSyntax"></a>

```
{
   "TaskId": "string"
}
```

## Antwortelemente
<a name="API_CreateBatchLoadTask_ResponseElements"></a>

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.

 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) **   <a name="timestream-CreateBatchLoadTask-response-TaskId"></a>
Die ID der Batch-Load-Aufgabe.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 3. Maximale Länge beträgt 32 Zeichen.  
Pattern: `[A-Z0-9]+` 

## Fehler
<a name="API_CreateBatchLoadTask_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** AccessDeniedException **   
Sie sind nicht berechtigt, diese Aktion auszuführen.  
HTTP-Statuscode: 400

 ** ConflictException **   
Timestream konnte diese Anfrage nicht verarbeiten, da sie eine Ressource enthält, die bereits vorhanden ist.  
HTTP-Statuscode: 400

 ** InternalServerException **   
 Timestream konnte diese Anfrage aufgrund eines internen Serverfehlers nicht vollständig verarbeiten.  
HTTP Status Code: 500

 ** InvalidEndpointException **   
Der angeforderte Endpunkt war nicht gültig.  
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Der Vorgang hat versucht, auf eine nicht existierende Ressource zuzugreifen. Die Ressource wurde möglicherweise nicht richtig angegeben, oder ihr Status ist möglicherweise nicht AKTIV.  
HTTP-Statuscode: 400

 ** ServiceQuotaExceededException **   
 Das Instanzkontingent der Ressource für dieses Konto wurde überschritten.  
HTTP-Statuscode: 400

 ** ThrottlingException **   
 Ein Benutzer hat zu viele Anfragen gestellt und sie haben die Servicekontingenten überschritten. Die Anforderung wurde gedrosselt.  
HTTP-Statuscode: 400

 ** ValidationException **   
 Eine ungültige oder falsch formatierte Anfrage.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_CreateBatchLoadTask_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) 