As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateBatchLoadTask
Cria uma nova tarefa de carregamento em lote do Timestream. Uma tarefa de carregamento em lote processa dados de uma CSV fonte em um local do S3 e grava em uma tabela Timestream. Um mapeamento da origem para o destino é definido em uma tarefa de carregamento em lote. Erros e eventos são gravados em um relatório em um local do S3. Para o relatório, se a AWS KMS chave não for especificada, o relatório será criptografado com uma chave gerenciada do S3 quando SSE_S3
for a opção. Caso contrário, um erro será gerado. Para obter mais informações, consulte Chaves gerenciadas pela AWS. Cotas de serviço se aplicam. Para obter detalhes, consulte o exemplo de código.
Sintaxe da Solicitação
{
"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
"
}
Parâmetros da solicitação
Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.
A solicitação aceita os seguintes dados no JSON formato.
- ClientToken
-
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Obrigatório: Não
- DataModelConfiguration
-
Tipo: objeto DataModelConfiguration
Obrigatório: Não
- DataSourceConfiguration
-
Define detalhes de configuração sobre a fonte de dados para uma tarefa de carregamento em lote.
Tipo: objeto DataSourceConfiguration
Obrigatório: Sim
- RecordVersion
-
Tipo: longo
Obrigatório: Não
- ReportConfiguration
-
Configuração do relatório para uma tarefa de carregamento em lote. Ele contém detalhes sobre onde os relatórios de erros são armazenados.
Tipo: objeto ReportConfiguration
Obrigatório: Sim
- TargetDatabaseName
-
Banco de dados Timestream de destino para uma tarefa de carregamento em lote.
Tipo: string
Padrão:
[a-zA-Z0-9_.-]+
Exigido: Sim
- TargetTableName
-
Tabela de Timestream de destino para uma tarefa de carregamento em lote.
Tipo: string
Padrão:
[a-zA-Z0-9_.-]+
Exigido: Sim
Sintaxe da Resposta
{
"TaskId": "string"
}
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- TaskId
-
O ID da tarefa de carregamento em lote.
Tipo: string
Restrições de tamanho: comprimento mínimo de 3. Comprimento máximo de 32.
Padrão:
[A-Z0-9]+
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não está autorizado a realizar essa ação.
HTTPCódigo de status: 400
- ConflictException
-
O Timestream não conseguiu processar essa solicitação porque ela contém um recurso que já existe.
HTTPCódigo de status: 400
- InternalServerException
-
O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor.
HTTPCódigo de status: 500
- InvalidEndpointException
-
O endpoint solicitado não era válido.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não estarACTIVE.
HTTPCódigo de status: 400
- ServiceQuotaExceededException
-
A cota de instância do recurso foi excedida para essa conta.
HTTPCódigo de status: 400
- ThrottlingException
-
Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada.
HTTPCódigo de status: 400
- ValidationException
-
Uma solicitação inválida ou malformada.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: