通過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語句修改。