全部產品
Search
文件中心

Tablestore:建立映射關係

更新時間:Oct 23, 2026

通過 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

CREATE TABLE 語句,用於定義映射表名稱、欄位、主鍵和執行引擎。資料表映射和多元索引映射使用不同的文法。

樣本

說明

本文以建立表的映射關係為例介紹。如果要建立多元索引的映射關係,您只需將樣本中的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 語句修改。

相關文檔