Todos os produtos
Search
Central de documentação

Tablestore:Excluir uma linha

Última atualização: Jul 08, 2026

Localize uma linha pela chave primária e remova-a da tabela de dados. Use uma condição para restringir a exclusão caso o estado da linha precise atender a um critério específico antes da remoção.

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize o cliente.

Descrição

public DeleteRowResponse deleteRow(DeleteRowRequest deleteRowRequest) throws TableStoreException, ClientException

Exclua uma única linha identificada pela chave primária. Especifique a chave primária em RowDeleteChange. A resposta retorna as unidades de capacidade consumidas (CUs) por meio de response.getConsumedCapacity().

O exemplo a seguir exclui a linha com chave primária row1 da tabela de dados delete_row_demo.

String tableName = "delete_row_demo";

PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
PrimaryKey primaryKey = primaryKeyBuilder.build();

RowDeleteChange rowDeleteChange = new RowDeleteChange(tableName, primaryKey);

DeleteRowResponse response = client.deleteRow(new DeleteRowRequest(rowDeleteChange));
System.out.println("RequestId: " + response.getRequestId());
System.out.println("Write CU: " + response.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());

Parâmetros principais:

  • tableName (Obrigatório): Nome da tabela de dados de destino.

  • primaryKey (Obrigatório): Chave primária. Deve incluir todas as colunas de chave primária.

Parâmetros

Forneça os detalhes da exclusão de linha única em RowDeleteChange com os seguintes parâmetros:

Nome

Tipo

Descrição

tableName (Obrigatório)

String

Nome da tabela de dados de destino.

primaryKey (Obrigatório)

PrimaryKey

Chave primária da linha, incluindo nomes e valores das colunas.

  • Tipos de coluna de chave primária compatíveis: STRING, INTEGER e BINARY.

  • A quantidade e os tipos de colunas de chave primária devem corresponder ao esquema de chave primária da tabela de dados.

condition (Opcional)

Condition

Condição que restringe a exclusão. Para mais informações, consulte Atualização condicional.

Referências