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: Jul 03, 2026

    Use o SDK do PHP para ler uma única linha de dados de uma tabela do Tablestore especificando sua chave primária.

    Observações de uso

    Ao ler dados, forneça o valor completo da chave primária, incluindo o valor da coluna de chave primária com incremento automático.

    Antes de começar

    Inicializar o cliente do Tablestore

    Descrição do método

    public function getRow(array $request)

    Descrição do parâmetro $request

    Nome

    Tipo

    Descrição

    table_name (Obrigatório)

    string

    Nome da tabela de dados.

    primary_key (Obrigatório)

    array

    Chave primária da linha, incluindo nomes e valores das colunas.

    • 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 aos definidos na tabela de dados.

    max_versions (Opcional)

    int

    Número máximo de versões a retornar.

    • Defina max_versions ou time_range.

    • Se o número de versões correspondentes exceder esse valor, as versões serão retornadas da mais recente para a mais antiga até atingir o limite especificado.

    time_range (Opcional)

    array

    Intervalo de versões dos dados a ler.

    • Defina max_versions ou time_range.

    • Cada coluna de atributo pode conter múltiplas versões. Somente as versões dentro do intervalo especificado são retornadas.

    columns_to_get (Opcional)

    array

    Colunas a ler. Você pode especificar colunas de chave primária e colunas de atributo.

    • Se não definido, a linha inteira é retornada.

    • Se definido, mas a linha não contiver nenhuma das colunas especificadas, null é retornado.

    column_filter (Opcional)

    array

    Condição de filtro a aplicar. Para mais informações, consulte Filtro.

    • Quando columns_to_get e column_filter estão definidos, o Tablestore recupera primeiro as colunas especificadas e depois aplica o filtro aos resultados.

    transaction_id (Opcional)

    string

    ID da transação local. Para mais informações, consulte Transações locais.

    Código de exemplo

    O exemplo abaixo lê uma linha cujo valor de chave primária é row1.

    $request = array (
    'table_name' => 'test_table',
    // Construct primary key
    'primary_key' => array (
        array ('id', 'row1')
    ),
    'max_versions' => 1
);

try {
    // Call the getRow method to read row data
    $response = $client->getRow ($request);
    echo "* Read CU Cost: " . $response['consumed']['capacity_unit']['read'] . "\n";
    echo "* Write CU Cost: " . $response['consumed']['capacity_unit']['write'] . "\n";
    echo "* Row Data: " . "\n";
    echo "Primary Key: ". json_encode($response['primary_key']) . "\n";
    echo "Attribute Columns: ". json_encode($response['attribute_columns']) . "\n";
} catch (Exception $e){
    echo "Get Row failed.";
}

    • Defina um intervalo de versões para retornar apenas os dados nesse período.

      // Set the query data version range to one day before the current time
$request['time_range'] = array (
    'start_time' => intval(microtime(true) * 1000) - 86400 * 1000,
    'end_time' => intval(microtime(true) * 1000)
);

    • Especifique as colunas de atributo a ler.

      $request['columns_to_get'] = array('col2');

    Referências