Todos os produtos
Search
Central de documentação

Tablestore:BulkExport

Última atualização: Jul 03, 2026

Exporta dados em lote.

Sintaxe da solicitação

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

Obrigatório

Descrição

table_name

string

Sim

Nome da tabela de dados.

columns_to_get

string

Não

Colunas que você deseja exportar. Caso não especifique este parâmetro, todas as colunas serão exportadas.

inclusive_start_primary_key

bytes

Sim

Chave primária inicial codificada no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

Se a linha existir, ela será incluída na resposta.

exclusive_end_primary_key

bytes

Sim

Chave primária final codificada no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

A linha não é incluída na resposta, independentemente de sua existência.

filter

bytes

Não

Condição de filtro codificada no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

data_block_type_hint

DataBlockType

Não

Tipo de bloco de dados do resultado retornado.

Sintaxe da resposta

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

Obrigatório

Descrição

consumed

ConsumedCapacity

Sim

Quantidade de unidades de capacidade (CUs) consumidas pela operação. Para mais informações, consulte Consumo de CU.

rows

bytes

Sim

Dados das linhas exportadas, incluindo a chave primária e as colunas de atributos. Os dados da linha são codificados no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

next_start_primary_key

bytes

Não

Chave primária inicial para a próxima operação de leitura, codificada no formato PlainBuffer. Para mais informações, consulte PlainBuffer.

Se o valor de retorno estiver vazio, todos os dados foram lidos.

data_block_type

DataBlockType

Não

Tipo de bloco de dados do resultado retornado.

Usar SDKs do Tablestore

SDK do Tablestore para Java: Leitura de dados offline em lote

Consumo de CU:

  • Quando a linha solicitada não existe, uma CU de leitura é consumida.

  • Se a linha solicitada existir, o número de CUs de leitura consumidas é arredondado para cima com base na seguinte fórmula: CUs de leitura consumidas = (Tamanho dos dados em todas as colunas de chave primária da linha + Tamanho dos dados nas colunas de atributos lidas) / 4 KB. Para saber como calcular o tamanho dos dados, consulte Uso de armazenamento.

  • Em caso de timeout da solicitação com resultados indefinidos, as CUs podem ou não ser consumidas.

  • O retorno de um código de status HTTP 5xx indica erro interno e a operação não consome CUs. Para outros erros retornados, uma CU de leitura é consumida.