Per funzionalità simili a Amazon Timestream for, prendi in considerazione Amazon Timestream LiveAnalytics per InfluxDB. Offre un'acquisizione semplificata dei dati e tempi di risposta alle query di una sola cifra di millisecondi per analisi in tempo reale. Scopri di più qui.
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'origine CSV 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 in formato JSON.
- 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'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il 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.
Codice di stato HTTP: 400
- ConflictException
-
Timestream non è stato in grado di elaborare questa richiesta perché contiene risorse già esistenti.
Codice di stato HTTP: 400
- InternalServerException
-
Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.
Codice di stato HTTP: 500
- InvalidEndpointException
-
L'endpoint richiesto non era valido.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
L'operazione ha tentato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il suo stato potrebbe non essere ATTIVO.
Codice di stato HTTP: 400
- ServiceQuotaExceededException
-
La quota di risorse dell'istanza è stata superata per questo account.
Codice di stato HTTP: 400
- ThrottlingException
-
Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.
Codice di stato HTTP: 400
- ValidationException
-
Richiesta non valida o non valida.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
