全部產品
Search
文件中心

Tablestore:建立映射關係

更新時間:Oct 23, 2026

通過create table語句為已存在的表或者多元索引建立映射關係。建立映射關係時需要配置表的欄位名稱、欄位類型和主鍵資訊以及根據需要配置查詢資料時的執行引擎。

說明

Tablestore 不會自動為資料表建立 SQL 映射表。要通過 SQL 訪問資料表,需要先執行 CREATE TABLE 建立映射關係。

關於 CREATE TABLE 語句的文法和欄位類型映射規則,請參見建立表的映射關係和建立多元索引的映射關係。

前提條件

參數

參數

說明

query

SQL 陳述式。填寫 CREATE TABLE 語句,列類型須與資料表中對應列的資料類型匹配。

樣本

說明

以下樣本以資料表的映射關係為例。如需建立多元索引的映射關係,將樣本中的 SQL 陳述式替換為對應的多元索引 CREATE TABLE 語句即可。

與關係型資料庫不同,Tablestore 的 CREATE TABLE 語句不會建立表,而是為已有的 NoSQL 資料表建立 SQL 映射,使其支援 SQL 查詢。

以下樣本使用語句create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))建立 test_table 資料表的映射關係。

const params = {
  // CREATE TABLE 語句,為已有資料表建立 SQL 映射關係。
  // 列類型須與資料表中對應列的資料類型匹配,SQL 文法詳見 CREATE TABLE 文法說明。
  query: "create table test_table (pk varchar(1024), long_value bigint, double_value double, string_value mediumtext, bool_value bool, primary key(pk))",
}

client.sqlQuery(params, function (err, data) {
  if (err) {
    console.log('sqlQuery error:', err.toString());
  } else {
    console.log('sqlQuery success:', data);
  }
});

常見問題

建立映射關係時提示 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 語句修改。

相關文檔