通過 PHP SDK 為已有資料表或多元索引建立映射關係,以便通過 SQL 訪問資料。
Tablestore 不會自動為資料表建立 SQL 映射表。要通過 SQL 訪問資料表,需要先執行 CREATE TABLE 建立映射關係。
關於 CREATE TABLE 語句的文法和欄位類型映射規則,請參見建立表的映射關係和建立多元索引的映射關係。
注意事項
Table StorePHP SDK從5.1.0版本開始支援SQL查詢功能,使用SQL查詢功能時,請確保安裝了正確的PHP SDK版本。
關於PHP SDK歷史迭代版本的更多資訊,請參見PHP SDK歷史迭代版本。
前提條件
如需建立多元索引的映射關係,必須首先建立多元索引。
參數說明
SQLQueryRequest 包含以下參數。
名稱 | 類型 | 說明 |
query(必選) | String |
|
樣本
本文以建立表的映射關係為例介紹。如果要建立多元索引的映射關係,您只需將樣本中的SQL語句替換為建立多元索引映射關係的SQL語句即可。
以下樣本用於使用CREATE TABLE `tableName` (`PK0` BIGINT(20),`PK1` VARCHAR(1024),`geo` MEDIUMTEXT,`boolean` BOOL,`array` MEDIUMTEXT,`double` DOUBLE,`text` MEDIUMTEXT,`keyword` MEDIUMTEXT,`nested` MEDIUMTEXT,`long` BIGINT(20),PRIMARY KEY(`PK0`,`PK1`));語句建立tableName表的映射關係。
$request = array(
'query' => 'CREATE TABLE `tableName` (`PK0` BIGINT(20),`PK1` VARCHAR(1024),`geo` MEDIUMTEXT,`boolean` BOOL,`array` MEDIUMTEXT,`double` DOUBLE,`text` MEDIUMTEXT,`keyword` MEDIUMTEXT,`nested` MEDIUMTEXT,`long` BIGINT(20),PRIMARY KEY(`PK0`,`PK1`));',
);
$response = $otsClient->sqlQuery($request);
print json_encode($response, JSON_PRETTY_PRINT);常見問題
建立映射關係時提示 Table 'instance.table' doesn't exist
原因:指定的資料表或多元索引不存在。CREATE TABLE 語句僅為已有資料表或多元索引建立映射關係,不會建立實際的資料表或多元索引。
解決方案:檢查資料表或多元索引名稱是否正確,並確保相應的資料表或多元索引已建立,然後重新執行 CREATE TABLE 語句。
建立映射關係時提示 Table 'instance.table' already exists
原因:映射關係已存在。該映射關係由 CREATE TABLE 語句建立。
解決方案:
如果只需避免重複建立報錯,請在
CREATE TABLE語句中使用IF NOT EXISTS。如果需要調整映射關係的結構,請先使用
DESCRIBE語句查看映射關係,再使用ALTER TABLE語句修改。