Excluir uma linha - Tablestore SDK for Python - Tablestore: Central de Documentação do Alibaba Cloud

Use o Tablestore SDK for Python para excluir uma linha pela chave primária. Opcionalmente, especifique uma condição de exclusão ou uma transação local.

Pré-requisitos

Instale o Tablestore SDK for Python e inicialize um cliente.

Descrição da função

Chame delete_row para excluir uma linha inteira com base na chave primária.

def delete_row(
    self,
    table_name,
    row=None,
    condition=None,
    return_type=None,
    transaction_id=None,
    **kwargs,
)

O exemplo a seguir exclui a linha cuja chave primária é ("device", 1) da tabela example_table.

primary_key = [("partition", "device"), ("id", 1)]
row = Row(primary_key)
condition = Condition(RowExistenceExpectation.EXPECT_EXIST)

consumed, return_row = client.delete_row(
    "example_table",
    row,
    condition,
)
print("Write CU: %s" % consumed.write)

Parâmetros

O método delete_row tem os seguintes parâmetros.

Nome	Tipo	Descrição
table_name (obrigatório)	`str`	Nome da tabela.
row (obrigatório)	`Row`	Chave primária da linha a excluir. `Row.primary_key` deve conter todas as colunas da chave primária. Os nomes, a ordem, a quantidade e os tipos devem corresponder ao esquema de chave primária da tabela.
condition (opcional)	`Condition`	Condição de exclusão. Por padrão, o sistema não verifica a existência da linha. Para mais informações, consulte Use conditional updates.
return_type (opcional)	`ReturnType`	Tipo de retorno. `RT_NONE`, valor padrão, não retorna dados. `RT_PK` retorna a chave primária.
transaction_id (opcional)	`str`	ID da transação local. Especifique este parâmetro apenas para exclusões em uma transação local. Para mais informações, consulte Use local transactions.

Resposta

delete_row retorna os seguintes valores.

Campo	Tipo	Descrição
consumed	`CapacityUnit`	CUs de leitura e gravação consumidas pela operação.
return_row	`Row`	Linha retornada. Se `return_type` for `RT_PK`, o sistema retorna a chave primária. Caso contrário, este valor é `None`.