Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información [aquí](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # CreateBatchLoadTask Crea una tarea nueva de carga por lotes de Timestream. Una tarea de carga por lotes procesa los datos de un origen CSV en una ubicación de S3 y los escribe en una tabla de Timestream. En una tarea de carga por lotes se define un mapeo del origen al destino. Los errores y los eventos se escriben en un informe en una ubicación de S3. En el caso del informe, si no se especifica la AWS KMS clave, el informe se cifrará con una clave gestionada por S3 cuando `SSE_S3` sea posible. De lo contrario, se genera un error. Para obtener más información, consulte [Claves administradas de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk). [Se aplican cuotas de servicio](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html). Para obtener más información, consulte el [ejemplo de código](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html). ## Sintaxis de la solicitud ``` { "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 de la solicitud Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64. Obligatorio: no ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: objeto [DataModelConfiguration](API_DataModelConfiguration.md) Obligatorio: no ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Define la información de configuración del origen de datos de una tarea de carga por lotes. Tipo: objeto [DataSourceConfiguration](API_DataSourceConfiguration.md) Obligatorio: sí ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** Tipo: largo Obligatorio: no ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** Informe de la configuración de una tarea de carga por lotes. Contiene información sobre dónde se almacenan los informes de errores. Tipo: objeto [ReportConfiguration](API_ReportConfiguration.md) Obligatorio: sí ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** Base de datos de Timestream de destino para una tarea de carga por lotes. Tipo: cadena Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: sí ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** Tabla de Timestream de destino para una tarea de carga por lotes. Tipo: cadena Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: sí ## Sintaxis de la respuesta ``` { "TaskId": "string" } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** El ID de la tarea de carga por lotes. Tipo: cadena Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 32 caracteres. Patrón: `[A-Z0-9]+` ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md). ** AccessDeniedException ** No tiene autorización para realizar esta acción. Código de estado HTTP: 400 ** ConflictException ** Timestream no pudo procesar esta solicitud porque contiene un recurso que ya existe. Código de estado HTTP: 400 ** InternalServerException ** Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor. Código de estado HTTP: 500 ** InvalidEndpointException ** El punto de conexión solicitado no era válido. Código de estado HTTP: 400 ** ResourceNotFoundException ** La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO. Código de estado HTTP: 400 ** ServiceQuotaExceededException ** Se superó la cuota de recursos de la instancia para esta cuenta. Código de estado HTTP: 400 ** ThrottlingException ** Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado. Código de estado HTTP: 400 ** ValidationException ** Solicitud no válida o con formato incorrecto. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)