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 |
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 |
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 |
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.