Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais [aqui](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html). 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 tarefa de carregamento em lote do Timestream. Uma tarefa de carregamento em lote processa dados de uma fonte CSV em um local do S3 e grava em uma tabela do 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](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Cotas de serviço se aplicam](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Consulte a [amostra de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html) para obter detalhes. ## 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 que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 64. Obrigatório: não ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md) Obrigatório: não ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Define detalhes de configuração sobre a fonte de dados para uma tarefa de carregamento em lote. Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md) Obrigatório: sim ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: longo Obrigatório: não ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Configuração do relatório para uma tarefa de carregamento em lote. Contém detalhes sobre onde os relatórios de erros são armazenados. Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md) Obrigatório: sim ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** Banco de dados Timestream de destino para uma tarefa de carregamento em lote. Tipo: string Padrão: `[a-zA-Z0-9_.-]+` Obrigatório: sim ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** Tabela de Timestream de destino para uma tarefa de carregamento em lote. Tipo: string Padrão: `[a-zA-Z0-9_.-]+` Obrigatório: sim ## Sintaxe da resposta ``` { "TaskId": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** ID da tarefa de carregamento em lote. Tipo: string Restrições de tamanho: comprimento mínimo de 3. O comprimento máximo é 32. Padrão: `[A-Z0-9]+` ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Erros comuns](CommonErrors.md). ** AccessDeniedException ** Você não tem autorização para executar esta ação. Código de status HTTP: 400 ** ConflictException ** O Timestream não conseguiu processar essa solicitação porque ela contém um recurso que já existe. Código de status HTTP: 400 ** InternalServerException ** O Timestream não conseguiu processar totalmente essa solicitação devido a um erro interno do servidor. Código de status HTTP: 500 ** InvalidEndpointException ** O endpoint solicitado não era válido. Código de status HTTP: 400 ** ResourceNotFoundException ** A operação tentou acessar um recurso inexistente. O recurso pode não estar especificado corretamente ou seu status pode não ser ATIVO. Código de status HTTP: 400 ** ServiceQuotaExceededException ** A cota de instância do recurso foi excedida para essa conta. Código de status HTTP: 400 ** ThrottlingException ** Muitas solicitações foram feitas por um usuário e elas excederam as cotas de serviço. A solicitação foi acelerada. Código de status HTTP: 400 ** ValidationException ** Uma solicitação inválida ou malformada. Código de status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask)