Todos los productos
Search

Este producto

    Tablestore:Lectura de una sola fila de datos

    Centro de documentos

    Tablestore:Lectura de una sola fila de datos

    Última actualización: Sep 03, 2026

    Utilice el SDK de PHP para leer una sola fila de datos de una tabla de Tablestore mediante la especificación de su clave principal.

    Notas de uso

    Al leer datos, proporcione el valor completo de la clave principal, incluido el valor de la columna de clave principal con incremento automático.

    Antes de empezar

    Initialize the Tablestore Client

    Descripción del método

    public function getRow(array $request)

    Descripción del parámetro $request

    Nombre

    Tipo

    Descripción

    table_name (obligatorio)

    string

    El nombre de la tabla de datos.

    primary_key (obligatorio)

    array

    La clave principal de la fila, que incluye los nombres y valores de las columnas.

    • Tipos de datos compatibles para columnas de clave principal: STRING, INTEGER y BINARY.

    • El número y los tipos de columnas de clave principal deben coincidir con los definidos en la tabla de datos.

    max_versions (opcional)

    int

    El número máximo de versiones a devolver.

    • Debe establecer max_versions o time_range.

    • Si el número de versiones coincidentes supera este valor, se devuelven las versiones desde la más reciente hasta la más antigua, hasta alcanzar el límite especificado.

    time_range (opcional)

    array

    El rango de versiones de los datos a leer.

    • Debe establecer max_versions o time_range.

    • Cada columna de atributo puede contener varias versiones. Solo se devuelven las versiones dentro del rango especificado.

    columns_to_get (opcional)

    array

    Las columnas a leer. Puede especificar tanto columnas de clave principal como columnas de atributos.

    • Si no se establece, se devuelve la fila completa.

    • Si se establece pero la fila no contiene ninguna de las columnas especificadas, se devuelve null.

    column_filter (opcional)

    array

    La condición de filtro a aplicar. Para obtener más información, consulte Filter.

    • Si se establecen tanto columns_to_get como column_filter, Tablestore primero recupera las columnas especificadas y luego aplica el filtro a los resultados.

    transaction_id (opcional)

    string

    El ID de la transacción local. Para obtener más información, consulte Local transactions.

    Código de ejemplo

    A continuación se muestra un ejemplo que lee una fila cuyo valor de clave principal es 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.";
}

    • Establezca un rango de versiones para devolver solo los datos dentro de ese rango.

      // 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 las columnas de atributos a leer.

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

    Referencias