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

Exporta datos de forma masiva.

Sintaxis de la solicitud

message BulkExportRequest {
    required string table_name = 1;
    repeated string columns_to_get = 2;
    required bytes inclusive_start_primary_key = 3;
    required bytes exclusive_end_primary_key = 4;
    optional bytes filter = 5;
    optional DataBlockType data_block_type_hint = 6 [default = DBT_SIMPLE_ROW_MATRIX];
}

Parámetro	Tipo	Obligatorio	Descripción
table_name	string	Sí	Nombre de la tabla de datos.
columns_to_get	string	No	Columnas que desea exportar. Si no especifica este parámetro, se exportan todas las columnas.
inclusive_start_primary_key	bytes	Sí	Clave principal inicial codificada en formato PlainBuffer. Para obtener más información, consulte PlainBuffer. Si la fila existe, se incluye en la respuesta.
exclusive_end_primary_key	bytes	Sí	Clave principal final codificada en formato PlainBuffer. Para obtener más información, consulte PlainBuffer. La fila no se incluye en la respuesta, exista o no.
filter	bytes	No	Condición de filtro codificada en formato PlainBuffer. Para obtener más información, consulte PlainBuffer.
data_block_type_hint	DataBlockType	No	Tipo de bloque de datos del resultado devuelto.

Sintaxis de la respuesta

message BulkExportResponse {
     required ConsumedCapacity consumed = 1;
     required bytes rows = 2;
     optional bytes next_start_primary_key = 3;
     optional DataBlockType data_block_type = 4;
}

Parámetro	Tipo	Obligatorio	Descripción
consumed	ConsumedCapacity	Sí	Número de unidades de capacidad (CU) que consume la operación. Para obtener más información, consulte CU consumption.
rows	bytes	Sí	Datos de fila exportados, que incluyen la clave principal y las columnas de atributos. Estos datos están codificados en formato PlainBuffer. Para obtener más información, consulte PlainBuffer.
next_start_primary_key	bytes	No	Clave principal inicial para la siguiente operación de lectura. Esta clave está codificada en formato PlainBuffer. Para obtener más información, consulte PlainBuffer. Si el valor devuelto está vacío, se leyeron todos los datos.
data_block_type	DataBlockType	No	Tipo de bloque de datos del resultado devuelto.

Uso de los SDK de Tablestore

Tablestore SDK for Java: Batch read offline data

Consumo de CU:

Si la fila solicitada no existe, se consume una CU de lectura.
Si la fila solicitada existe, el número de CU de lectura consumidas se redondea hacia arriba según la siguiente fórmula: Número de CU de lectura consumidas = (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 leídas) / 4 KB. Para obtener más información sobre cómo calcular el tamaño de los datos, consulte Storage usage.
Si la solicitud supera el tiempo de espera y los resultados quedan indefinidos, es posible que se consuman CU o no.
Si se devuelve un código de estado HTTP 5xx, lo cual indica que ocurrió un error interno, la operación no consume CU. Si se devuelven otros errores, se consume una CU de lectura.