Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateBatchLoadTask
Crea una nuova attività di caricamento in batch di Timestream. Un'attività di caricamento in batch elabora i dati da un'CSVorigine in una posizione S3 e li scrive in una tabella Timestream. Una mappatura dall'origine alla destinazione è definita in un'attività di caricamento in batch. Gli errori e gli eventi vengono scritti in un report in una posizione S3. Per il report, se la AWS KMS chiave non è specificata, il report verrà crittografato con una chiave gestita S3, se SSE_S3 possibile. Altrimenti viene generato un errore. Per ulteriori informazioni, consulta chiavi gestite da AWS . Si applicano le quote di servizio. Per i dettagli, vedi esempio di codice.
Sintassi della richiesta
{
"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"
}Parametri della richiesta
Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.
La richiesta accetta i seguenti dati nel JSON formato.
- ClientToken
-
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
- DataModelConfiguration
-
Tipo: oggetto DataModelConfiguration
Campo obbligatorio: no
- DataSourceConfiguration
-
Definisce i dettagli di configurazione sull'origine dati per un'attività di caricamento in batch.
Tipo: oggetto DataSourceConfiguration
Campo obbligatorio: sì
- RecordVersion
-
Tipo: long
Campo obbligatorio: no
- ReportConfiguration
-
Configurazione del report per un'attività di caricamento in batch. Contiene dettagli sulla posizione in cui vengono archiviate le segnalazioni di errori.
Tipo: oggetto ReportConfiguration
Campo obbligatorio: sì
- TargetDatabaseName
-
Database Target Timestream per un'attività di caricamento in batch.
Tipo: stringa
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
- TargetTableName
-
Tabella Target Timestream per un'attività di caricamento in batch.
Tipo: stringa
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: sì
Sintassi della risposta
{
"TaskId": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- TaskId
-
L'ID dell'operazione di caricamento in batch.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 32 caratteri.
Modello:
[A-Z0-9]+
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- AccessDeniedException
-
Non sei autorizzato a eseguire questa azione.
HTTPCodice di stato: 400
- ConflictException
-
Timestream non è stato in grado di elaborare questa richiesta perché contiene una risorsa già esistente.
HTTPCodice di stato: 400
- InternalServerException
-
Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.
HTTPCodice di stato: 500
- InvalidEndpointException
-
L'endpoint richiesto non era valido.
HTTPCodice di stato: 400
- ResourceNotFoundException
-
L'operazione ha tentato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il relativo stato potrebbe non esserlo. ACTIVE
HTTPCodice di stato: 400
- ServiceQuotaExceededException
-
La quota di risorse dell'istanza è stata superata per questo account.
HTTPCodice di stato: 400
- ThrottlingException
-
Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.
HTTPCodice di stato: 400
- ValidationException
-
Una richiesta non valida o non valida.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
