CreateBatchLoadTask - Amazon Timestream

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: