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

Antes de começar

Descrição do método

public function putRow(array $request)

Descrição dos parâmetros de $request

Nome	Tipo	Descrição
table_name (obrigatório)	string	Nome da tabela.
primary_key (obrigatório)	array	Chave primária, incluindo nomes e valores das colunas. Os tipos de coluna de chave primária incluem STRING, INTEGER e BINARY. A quantidade e os tipos de chaves primárias na linha devem corresponder aos definidos para a tabela. 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 Coluna de chave primária de incremento automático.
attribute_columns (opcional)	array	Colunas de atributo, contendo nomes, valores e números de versão. Os tipos de coluna de atributo incluem STRING, INTEGER, BINARY, DOUBLE e BOOLEAN. Por padrão, o número de versão é um timestamp gerado automaticamente. Para especifique manualmente um número de versão, consulte Versões de dados e ciclo de vida.
condition (opcional)	array	Condição para a operação de gravação. Consulte Atualização condicional.
return_content (opcional)	array	Dados a retornar. return_type (obrigatório)`array`: Tipo de retorno. ReturnTypeConst::CONST_NONE (padrão): Não retorna dados. ReturnTypeConst::CONST_PK: Retorna as colunas de chave primária. Use esta opção para recuperar valores de chave primária de incremento automático. ReturnTypeConst::CONST_AFTER_MODIFY: Retorna os valores atualizados das colunas. Use esta opção para contadores atômicos.
transaction_id (opcional)	string	ID que identifica exclusivamente uma transação local. Consulte Transação local.

Código de exemplo

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

$request = array (
    'table_name' => 'test_table',
    // Build the primary key
    'primary_key' => array (
        array('id', 'row1')
    )
);

try{
    // Call putRow to write the row
    $response = $client->putRow($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
} catch (Exception $e) {
    echo "Put Row failed.";
}

Adicione uma coluna de atributo.

$request['attribute_columns'] = array(
    array('col1', 'val1')
);

Especifique um número de versão. Atribua um número de versão distinto a cada coluna de atributo.

$request['attribute_columns'] = array(
    array('col1', 'val1', null, intval(microtime(true) * 1000))
);

Referências

Atualize dados em lote