前提條件

• 已初始化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引擎，表格存儲還提供了表引擎、二級索引和多元索引用于數據查詢，您需要根據實際查詢場景選擇合適的查詢方式。更多信息，請參見索引介紹和索引選擇。