BulkImport - Tablestore - Centro de documentación de Alibaba Cloud

Escribe varias filas de datos simultáneamente. Llame a esta operación para insertar, modifique o elimine una fila de datos.

Sintaxis de la solicitud

message BulkImportRequest {
    required string table_name = 1;
    repeated RowInBulkImportRequest rows = 2;
}

Parámetro	Tipo	Obligatorio	Descripción
table_name	string	Sí	Nombre de la tabla de datos.
rows	repeated RowInBulkImportRequest	Sí	Fila de datos que desea gestione.

Sintaxis de la respuesta

message BulkImportResponse {
    required string table_name = 1;
    repeated RowInBulkImportResponse rows = 2;
}

Parámetro	Tipo	Obligatorio	Descripción
table_name	string	Sí	Nombre de la tabla de datos.
rows	repeated RowInBulkImportResponse	Sí	Indica si la operación de escritura fue exitosa, el mensaje de error y las unidades de capacidad consumidas (CU). Para obtener más información, consulte Read and write throughput.

Uso de los SDK de Tablestore

SDK de Tablestore para Java: Batch write data offline

Consumo de CU

Si la operación falla, no se consumen CU.
Si la solicitud supera el tiempo de espera y los resultados son indefinidos, es posible que se consuman CU o no.
Si ocurre un error interno y se devuelve el código de estado HTTP 5xx, la operación no consume CU. Si ocurren otros errores, se consume una CU.
En otros casos, RowInBulkImportRequest especifica las operaciones de inserción, actualice y eliminación; la CU consumida se calcula de forma independiente según la operación realizada. A continuación se describen los métodos de cálculo de las CU consumidas al ejecutar operaciones de inserción, actualice y eliminación en filas de datos.
- Al insertar una fila de datos, el número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: (Tamaño de los datos en todas las columnas de clave principal de la fila + Tamaño de los datos en las columnas de atributos insertadas) / 4 KB.
- Al actualice una fila de datos, el número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: (Tamaño de los datos en todas las columnas de clave principal de la fila + Tamaño de los datos en las columnas de atributos actualizadas) / 4 KB. Si desea elimine una columna de atributos al actualice una fila de datos, solo se incluye la longitud del nombre de la columna en el tamaño de datos de dicha columna.
- Al elimine una fila de datos, el número de CU de escritura consumidas se redondea hacia arriba a partir del valor calculado con la siguiente fórmula: Tamaño de los datos en todas las columnas de clave principal de la fila / 4 KB.
Para obtener más información sobre cómo calcular el tamaño de los datos, consulte Storage usage.