Read a single row of data by using the Tablestore .NET SDK - Tablestore: Central de Documentação do Alibaba Cloud

Este tópico descreve como ler uma única linha de dados de uma tabela do Tablestore com o .NET SDK.

Observações de uso

Na leitura de dados, forneça o valor completo da chave primária, inclusive o valor de qualquer coluna de chave primária com incremento automático.

Pré-requisitos

Inicializar o cliente do Tablestore

Método

public GetRowResponse GetRow(GetRowRequest request)

Método assíncrono:

public Task<GetRowResponse> GetRowAsync(GetRowRequest request)

Parâmetros de GetRowRequest

Parâmetro	Tipo	Descrição
tableName (Obrigatório)	string	Nome da tabela de dados.
primaryKey (Obrigatório)	PrimaryKey	Informações da chave primária, incluindo nomes e valores das colunas correspondentes. Tipos de dados compatíveis com colunas de chave primária: STRING, INTEGER e BINARY. A quantidade e os tipos das colunas de chave primária devem corresponder exatamente aos definidos na tabela de dados.
maxVersion (Opcional)	int	Número máximo de versões a retornar. Valor padrão: 1. Não defina `maxVersion` e `timeRange` simultaneamente. Se o número de versões que atendem à condição de consulta exceder o máximo especificado, o resultado conterá apenas a quantidade definida de versões, ordenadas da mais recente para a mais antiga.
timeRange (Opcional)	TimeRange	Intervalo de versões dos dados. Não defina `maxVersion` e `timeRange` simultaneamente. Cada coluna de atributo em uma tabela do Tablestore pode ter múltiplas versões. Ao especificar um intervalo de versões, o método retorna apenas os dados dentro desse intervalo.
columnsToGet (Opcional)	HashSet<string>	Colunas de dados a ler. Podem ser colunas de chave primária ou de atributo. Sem a especificação de `columnsToGet`, o método retorna a linha inteira. Se `columnsToGet` for especificado e a linha não contiver nenhuma das colunas indicadas, a operação retorna `null`.
condition (Opcional)	IColumnCondition	Condição de filtro. Para mais informações, consulte Filtro. Ao definir `columnsToGet` e `condition` simultaneamente, o sistema aplica primeiro a `condition` para filtrar os dados. Se a condição for atendida, o método retorna apenas os dados das colunas especificadas em `columnsToGet`.

Exemplo de código

Este exemplo lê uma única linha com o valor de chave primária 'row1'.

try
{
    // Construct the primary key.
    PrimaryKey primaryKey = new PrimaryKey
    {
        { "id", new ColumnValue("row1") }
    };

    // Call the GetRow method to read the row.
    GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey);
    GetRowResponse getRowResponse = client.GetRow(getRowRequest);

    Console.WriteLine($"RequestId: {getRowResponse.RequestID}");
    Console.WriteLine($"Read CU Cost: {getRowResponse.ConsumedCapacityUnit.Read}");
    Console.WriteLine($"Write CU Cost: {getRowResponse.ConsumedCapacityUnit.Write}");
    Console.WriteLine($"Row Data: {getRowResponse.Row}");
}
catch (Exception ex)
{
    Console.WriteLine($"Get row failed, exception: {ex.Message}");
}

Especifique um intervalo de versões para os dados a ler. O método retorna apenas os dados dentro do intervalo especificado.

TimeRange timeRange = new TimeRange
{
    StartTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds() - 86400 * 1000,
    EndTime = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds()
};

// Call the GetRow method to read the row.
GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, null, null, timeRange);

Defina as colunas de atributo a ler.

HashSet<string> columnsToGet = new HashSet<string> { "col2" };

// Call the GetRow method to read the row.
GetRowRequest getRowRequest = new GetRowRequest("test_table", primaryKey, columnsToGet);