查询数据

前提条件

• 已初始化Client。具体操作，请参见初始化OTSClient。

• 已创建映射关系。具体操作，请参见创建表的映射关系。

注意事项

表格存储PHP SDK从5.1.0版本开始支持SQL查询功能。使用SQL查询功能时，请确保获取了正确的PHP SDK版本。关于PHP SDK历史迭代版本的更多信息，请参见PHP SDK历史迭代版本。

参数

示例

以下示例用于使用SELECT `PK0`, `boolean`, `long`, `geo` FROM `tableName` LIMIT 10;语句查询tableName表中数据且最多返回10行数据。系统会返回查询语句的请求类型、返回值Schema、返回结果等信息。

$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'];

常见问题

• SQL查询常见错误排查

• 使用SQL查询数据时报错The sql scanned rows of main table exceeds the quota, main table rows quota is 100000

相关文档

• 如果要加速SQL数据查询和计算，您可以通过创建二级索引或者多元索引实现。更多信息，请参见索引选择策略和计算下推。

• 如果数据表的属性列有增加或删除，您可以通过ALTER TABLE语句同步修改映射表。更多信息，请参见更新映射表属性列。

• 如果需要查询表的描述信息，您可以通过DESCRIBE语句实现。更多信息，请参见查询表描述信息。

• 如果不再需要使用表或者多元索引的映射关系，您可以通过DROP MAPPING TABLE语句删除映射关系。更多信息，请参见删除映射关系。

• 如果需要查看表的索引信息，您可以通过SHOW INDEX语句实现。更多信息，请参见查询索引描述信息。

• 如果需要列出当前数据库中的表名称列表，您可以通过SHOW TABLES语句实现。更多信息，请参见列出表名称列表。

• 您还可以通过MaxCompute、Spark、Hive或者HadoopMR、函数计算、Flink、PrestoDB等计算引擎实现表中数据的计算与分析。具体操作，请参见计算与分析。

说明

除了SQl引擎，表格存储还提供了表引擎、二级索引和多元索引用于数据查询，您需要根据实际查询场景选择合适的查询方式。更多信息，请参见索引介绍和索引选择。