Grava várias linhas de dados simultaneamente. Use esta operação para inserir, modifique ou exclua uma linha de dados.
Sintaxe da solicitação
message BulkImportRequest {
required string table_name = 1;
repeated RowInBulkImportRequest rows = 2;
}|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
table_name |
string |
Sim |
Nome da tabela de dados. |
|
rows |
repeated RowInBulkImportRequest |
Sim |
Linha de dados a ser gerencie. |
Sintaxe da resposta
message BulkImportResponse {
required string table_name = 1;
repeated RowInBulkImportResponse rows = 2;
}|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
table_name |
string |
Sim |
Nome da tabela de dados. |
|
rows |
repeated RowInBulkImportResponse |
Sim |
Indica se a operação de gravação foi bem-sucedida, a mensagem de erro e as unidades de capacidade (CUs) consumidas. Para mais informações, consulte Throughput de leitura e gravação. |
Usar SDKs do Tablestore
Tablestore SDK for Java: Gravar dados em lote offline
Consumo de CU
A operação não consome CUs em caso de falha.
Se a solicitação atingir o tempo limite com resultados indefinidos, o consumo de CUs pode ou não ocorrer.
Erros internos que retornam código de status HTTP 5xx não consomem CUs. Outros erros consomem uma CU.
-
Nos demais casos, o RowInBulkImportRequest especifica as operações de inserção, atualize e exclusão. O cálculo das CUs consumidas ocorre de forma independente para cada operação executada. Os itens a seguir descrevem os métodos de cálculo de CUs para essas operações em linhas de dados.
Na inserção de uma linha de dados, arredonde para cima o número de CUs de gravação consumidas conforme a fórmula: (Tamanho dos dados em todas as colunas de chave primária da linha + Tamanho dos dados nas colunas de atributo inseridas) / 4 KB.
Na atualização de uma linha de dados, arredonde para cima o número de CUs de gravação consumidas conforme a fórmula: (Tamanho dos dados em todas as colunas de chave primária da linha + Tamanho dos dados nas colunas de atributo atualizadas) / 4 KB. Se a atualização incluir a exclusão de uma coluna de atributo, considere apenas o comprimento do nome da coluna no tamanho dos dados dessa coluna.
Na exclusão de uma linha de dados, arredonde para cima o número de CUs de gravação consumidas conforme a fórmula: Tamanho dos dados em todas as colunas de chave primária da linha / 4 KB.
Para mais informações sobre o cálculo do tamanho dos dados, consulte Uso de armazenamento.