Todos os produtos
Search

Este produto

    Tablestore:Read a single row of data

    Central de documentação

    Tablestore:Read a single row of data

    Última atualização: Jun 30, 2026

    Use o SDK do Python para ler uma única linha de dados de uma tabela do Tablestore.

    Observações de uso

    Forneça a chave primária completa, incluindo os valores das colunas de chave primária com incremento automático.

    Pré-requisitos

    Inicializar o cliente do Tablestore

    Método

    def get_row(self, table_name, primary_key, columns_to_get=None,
            column_filter=None, max_version=1, time_range=None,
            start_column=None, end_column=None, token=None,
            transaction_id=None):

    Parâmetros

    Parâmetro

    Tipo

    Descrição

    table_name (Obrigatório)

    str

    Nome da tabela de dados.

    primary_key (Obrigatório)

    List[Tuple]

    Chave primária. Inclui os nomes e valores de todas as colunas de chave primária.

    • Tipos de dados compatíveis: STRING, INTEGER e BINARY.

    • A quantidade de colunas e os tipos de dados devem corresponder ao esquema da tabela.

    max_version (Opcional)

    int

    Número máximo de versões a retornar. Valor padrão: 1.

    • Especifique o parâmetro max_version ou time_range.

    • Se houver mais versões correspondentes, apenas as mais recentes até esse limite serão retornadas, em ordem decrescente de timestamp.

    time_range (Opcional)

    Tuple

    Intervalo de versões para consulta.

    • Especifique o parâmetro max_version ou time_range.

    • Colunas de atributo podem ter múltiplas versões. Apenas as versões dentro do intervalo especificado são retornadas.

    columns_to_get (Opcional)

    List[str]

    Colunas a ler. Podem incluir colunas de chave primária e de atributo.

    • Se omitido, todas as colunas são retornadas.

    • Se a linha não contiver nenhuma das colunas especificadas, a resposta incluirá apenas a chave primária.

    column_filter (Opcional)

    ColumnCondition

    Condição de filtro. Filtro.

    • Ao especificar columns_to_get e column_filter simultaneamente, o sistema recupera primeiro as colunas indicadas e depois aplica o filtro.

    transaction_id (Opcional)

    str

    ID de uma transação local. Transações locais.

    Exemplos

    Leia uma linha com valor de chave primária row1:

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

    # Call the get_row method to read the row data.
    consumed, return_row, next_token = client.get_row('test_table', primary_key)
    print('Read CU Cost: %s' % consumed.read)
    print('Write CU Cost: %s' % consumed.write)
    print('Row Data: %s %s' % (return_row.primary_key, return_row.attribute_columns))
except Exception as e:
    print("Get row failed with error: %s" % e)

    • Para retornar apenas dados dentro de um intervalo de versões específico, especifique o parâmetro time_range.

      # Set the version range for the query to the last 24 hours.
time_range = (int(time.time() * 1000 - 86400 * 1000), int(time.time() * 1000))

# Call the get_row method to read the row data.
consumed, return_row, next_token = client.get_row('test_table', primary_key, time_range=time_range)

    • Para recuperar colunas de atributo específicas, defina o parâmetro columns_to_get.

      columns_to_get = ['col2']

# Call the get_row method to read the row data.
consumed, return_row, next_token = client.get_row('test_table', primary_key, columns_to_get=columns_to_get)

    Referências