Todos os produtos
Search
Central de documentação

Tablestore:Query data by executing SQL statements

Última atualização: Sep 29, 2026

Este tópico descreve como usar o Tablestore SDK for PHP para consultar dados executando instruções SQL.

Notas de uso

A consulta SQL é compatível com o Tablestore SDK for PHP V5.1.0 e versões posteriores. Verifique se uma versão compatível está instalada.

Para o histórico de versões do Tablestore SDK for PHP, consulte Version history of Tablestore SDK for PHP .

Pré-requisitos

Parâmetros

SQLQueryRequest contém o seguinte parâmetro.

Name

Type

Description

query (required)

String

A instrução CREATE TABLE que define o nome da tabela de mapeamento, os campos, a chave primária e o mecanismo de consulta. Os mapeamentos de tabela de dados e os mapeamentos de índice de pesquisa utilizam sintaxes diferentes.

Exemplo

O exemplo a seguir demonstra como usar a instrução SELECT para consultar dados na tabela tableName e retornar no máximo 10 linhas. O sistema retorna o tipo de solicitação da instrução de consulta, o schema do valor de retorno e os resultados obtidos.

$request = array(
    'query' => 'SELECT `PK0`, `boolean`, `long`, `geo` FROM `tableName` LIMIT 10;',
);
$response = $this->otsClient->sqlQuery($request);
$sqlRows = $response['sql_rows'];

// print all data metrix
$lines = '';
for ($i = 0; $i < $sqlRows->rowCount; $i++) {
    $line = '';
    for ($j = 0; $j < $sqlRows->columnCount; $j++) {
        $line = $line . (is_null($sqlRows->get($j, $i)) ? "null" : $sqlRows->get($j, $i)) . "\t";
    }
    $lines = $lines . $line . "\n";
}
print $lines;
$sqlRows = $response['sql_rows'];

Perguntas frequentes

Referências