Write a single row of data using the Tablestore Python SDK - Tablestore: Central de Documentação do Alibaba Cloud

Pré-requisitos

Método

put_row(self, table_name, row, condition=None, return_type=None, transaction_id=None)

Parâmetros

Parâmetro	Tipo	Descrição
table_name (Obrigatório)	str	Nome da tabela de dados.
row (Obrigatório)	Row	Linha a gravar, composta por: primary_key (Obrigatório) `List[Tuple]`: nomes e valores das colunas de chave primária. Os tipos de dados das colunas de chave primária são STRING, INTEGER e BINARY. A quantidade e os tipos de dados das colunas de chave primária devem corresponder às definições da tabela de dados. Se uma coluna de chave primária for de incremento automático, defina seu valor como um espaço reservado. Para mais informações, consulte Colunas de chave primária com incremento automático. attribute_columns (Obrigatório) `List[Tuple]`: nomes, valores e versões de dados das colunas de atributo. Os tipos de dados das colunas de atributo são STRING, INTEGER, BINARY, DOUBLE e BOOLEAN. A versão dos dados é um timestamp. O Tablestore gera uma versão automaticamente por padrão, mas você pode especificar uma versão personalizada. Para mais informações, consulte Versões de dados e ciclo de vida dos dados.
condition (Opcional)	Condition	Condição da operação de gravação. Para mais informações, consulte Atualização condicional.
return_type (Opcional)	ReturnType	Tipo de dado a retornar. RT_NONE (Padrão): nenhum dado é retornado. RT_PK: retorna as colunas de chave primária. Útil para recuperar o valor gerado de uma coluna de chave primária com incremento automático.
transaction_id (Opcional)	str	ID exclusivo de uma transação local. Para mais informações, consulte Transações locais.

Exemplos

Este exemplo grava uma linha com valor de chave primária row1 na tabela test_table.

try:
    # Construct the primary key and attribute columns.
    primary_key = [('id', 'row1')]
    attribute_columns = []

    # Construct the row to write.
    row = Row(primary_key, attribute_columns)

    # Call the put_row method to write the row.
    consumed, return_row = client.put_row('test_table', row)
    print('* Read CU Cost: %s' % consumed.read)
    print('* Write CU Cost: %s' % consumed.write)
except Exception as e:
    print("Put row failed with error: %s" % e)

Para adicionar uma coluna de atributo:
```
attribute_columns = [('col1','val1')]
```
Para especificar uma versão de dados, atribua uma versão a cada coluna de atributo.
```
attribute_columns = [('col1','val1', int(time.time() * 1000))]
```

Referências

Atualize dados em lote