Todos os produtos
Search
Central de documentação

Tablestore:Write a single row

Última atualização: Jun 30, 2026

Grave uma única linha de dados em uma tabela do Tablestore com o .NET SDK.

Pré-requisitos

Inicializar um cliente do Tablestore

Método

public PutRowResponse PutRow(PutRowRequest request)

Método assíncrono:

public Task<PutRowResponse> PutRowAsync(PutRowRequest request)

Parâmetros de PutRowRequest

Parâmetro

Tipo

Descrição

tableName (Obrigatório)

string

Nome da tabela.

primaryKey (Obrigatório)

PrimaryKey

Nomes e valores das colunas de chave primária da linha.

  • Tipos de dados válidos para colunas de chave primária: STRING, INTEGER e BINARY.

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

columns (Opcional)

AttributeColumns

Colunas de atributo, incluindo nomes, valores e versões de dados.

  • Tipos de dados válidos para colunas de atributo: STRING, INTEGER, BINARY, DOUBLE e BOOLEAN.

  • O Tablestore gera uma versão de dados automaticamente, mas você pode especificar uma versão personalizada. Para mais informações, consulte Versão de dados e tempo de vida.

condition (Obrigatório)

Condition

Condição para a operação de gravação. Para mais informações, consulte gravações condicionais.

Código de exemplo

O exemplo a seguir grava uma linha com valor de chave primária "row1" na tabela "test_table".

try
{
    // Construct the primary key.
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };
    // Specify a condition for the write operation. 
    // RowExistenceExpectation.IGNORE skips the row existence check.
    Condition condition = new Condition(RowExistenceExpectation.IGNORE);

    // Call the PutRow method to write the row.
    PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, null);
    PutRowResponse putRowResponse = client.PutRow(putRowRequest);
    Console.WriteLine($"* RequestId: {putRowResponse.RequestID}");
    Console.WriteLine($"* Read CU Cost: {putRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"* Write CU Cost: {putRowResponse.ConsumedCapacityUnit.Write}");
}
catch (Exception ex)
{
    Console.WriteLine($"Put row failed, exception: {ex.Message}");
}
  • Adicione colunas de atributo.

    AttributeColumns columns = new AttributeColumns
    {
        { "col1", new ColumnValue("val1") }
    };
    
    // Create a PutRowRequest.
    PutRowRequest putRowRequest = new PutRowRequest("test_table", condition, primaryKey, columns);

Tópicos relacionados

Gravar dados em lote