Excluir uma linha de dados - Tablestore: Central de Documentação do Alibaba Cloud

Sintaxe da solicitação

message DeleteRowRequest {
    required string table_name = 1;
    required bytes primary_key = 2; // The primary key is encoded as binary data in the PlainBuffer format. 
    required Condition condition = 3;
    optional ReturnContent return_content = 4;
    optional string transaction_id = 5;
}

Parâmetro	Tipo	Obrigatório	Descrição
table_name	string	Sim	Nome da tabela de dados.
primary_key	bytes	Sim	Chave primária da linha a ser excluída. A chave primária é codificada no formato PlainBuffer. Para obter mais informações sobre o PlainBuffer, consulte PlainBuffer.
condition	Condition	Sim	Especifique se a verificação de existência da linha deve ocorrer antes da operação de dados. Valor padrão: IGNORE. Valores válidos: IGNORE: Não há verificação de existência da linha. Se você definir o parâmetro condition como IGNORE, a operação será bem-sucedida independentemente da existência da linha. EXPECT_EXIST: A linha deve existir. Se você definir o parâmetro condition como EXPECT_EXIST, a exclusão terá êxito apenas se a linha existir. Caso contrário, a operação falhará e um erro será relatado.
return_content	ReturnContent	Não	Tipo de dado retornado após a gravação bem-sucedida da linha. Apenas a chave primária pode ser retornada. Geralmente, esse parâmetro é utilizado pelo recurso de coluna de chave primária com incremento automático.
transaction_id	string	Não	ID da transação local. Este parâmetro é obrigatório para excluir dados usando uma transação local.

Sintaxe da resposta

message DeleteRowResponse {
    required ConsumedCapacity consumed = 1;
    optional bytes row = 2;
}

Parâmetro

Tipo

Descrição

consumed

ConsumedCapacity

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

row

bytes

Dados retornados quando um valor é especificado para return_content. Se nenhum valor for definido para return_content ou não houver valor de retorno, NULL será retornado.

Os dados retornados são codificados no formato PlainBuffer. Para saber mais sobre o PlainBuffer, veja PlainBuffer.

Usar SDKs do Tablestore

Use os seguintes SDKs do Tablestore para excluir uma única linha de dados:

Tablestore SDK for Java: Excluir uma única linha de dados
Tablestore SDK for Go: Excluir uma única linha de dados
Tablestore SDK for Python: Excluir uma única linha de dados
Tablestore SDK for Node.js: Excluir uma única linha de dados
Tablestore SDK for .NET: Excluir uma única linha de dados
Tablestore SDK for PHP: Excluir uma única linha de dados

Consumo de CU

Se a linha a ser excluída não existir, o consumo de CUs dependerá do valor definido no parâmetro condition.
- Se o parâmetro condition for IGNORE, o número de CUs de escrita consumidas corresponderá ao arredondamento para cima do valor calculado pela fórmula: CUs de escrita consumidas = Tamanho dos dados em todas as colunas de chave primária da linha / 4 KB.
- Se o parâmetro condition for EXPECT_EXIST, a exclusão da linha falhará. Uma CU de escrita e uma CU de leitura serão consumidas.
Se a linha a ser excluída existir, o consumo de CUs variará conforme o valor definido no parâmetro condition.
- Se o parâmetro condition for IGNORE, o número de CUs de escrita consumidas corresponderá ao arredondamento para cima do valor calculado pela fórmula: CUs de escrita consumidas = Tamanho dos dados em todas as colunas de chave primária da linha / 4 KB.
- Se o parâmetro condition for EXPECT_EXIST, haverá consumo de CUs de escrita e de leitura. O número de CUs de escrita consumidas corresponderá ao arredondamento para cima do valor calculado pela fórmula: CUs de escrita consumidas = Tamanho dos dados em todas as colunas de chave primária da linha / 4 KB. O número de CUs de leitura consumidas corresponderá ao arredondamento para cima do valor calculado pela fórmula: CUs de leitura consumidas = Tamanho dos dados em todas as colunas de chave primária da linha / 4 KB.
Para obter mais informações sobre como calcular o tamanho dos dados, consulte Visão geral do faturamento.
Se a solicitação atingir o tempo limite e os resultados forem indefinidos, as CUs poderão ou não ser consumidas.
Se um código de status HTTP 5xx for retornado, indicando erro interno, a operação não consumirá CUs. Se outros erros forem retornados, uma CU de escrita será consumida.