Todos os produtos
Search
Central de documentação

Tablestore:Delete a single row of data

Última atualização: Jun 30, 2026

Exclua uma única linha de uma tabela de dados do Tablestore ao especificar o nome da tabela e a chave primária da linha.

Antes de começar

Inicializar o cliente do Tablestore

Método

public function deleteRow(array $request)

Parâmetros de $request

Nome

Tipo

Descrição

table_name (Obrigatório)

string

Nome da tabela de dados.

primary_key (Obrigatório)

array

Chave primária da linha a excluir, com nomes e valores das colunas.

  • Os tipos de dados das colunas de chave primária podem ser STRING, INTEGER ou BINARY.

  • A quantidade e os tipos das colunas de chave primária devem corresponder aos definidos na tabela de dados.

condition (Obrigatório)

array

Condição para a operação de exclusão. Para mais informações, consulte Atualização condicional.

transaction_id (Opcional)

string

ID que identifica exclusivamente uma transação local. Para mais informações, consulte Transações locais.

Exemplo

Exclua a linha com valor de chave primária row1 da tabela test_table:

try{
    $response = $client->deleteRow(array (
        'table_name' => 'test_table',
        'primary_key' => array (
            array ('id', 'row1')
        ),
        // A condition is required to delete a row. RowExistenceExpectationConst::CONST_IGNORE specifies that the existence of the row is not checked.
        'condition' => RowExistenceExpectationConst::CONST_IGNORE
    ));

    echo "Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Delete Row failed.";
}

Referências

Atualizar dados em lote