通過create table語句為已存在的表或者多元索引建立映射關係。建立映射關係時需要配置表的欄位名稱、欄位類型和主鍵資訊以及根據需要配置查詢資料時的執行引擎。
Tablestore 不會自動為資料表建立 SQL 映射表。要通過 SQL 訪問資料表,需要先執行 CREATE TABLE 建立映射關係。
有關 CREATE TABLE 語句的文法、欄位類型和參數說明,請參見DDL 操作。
注意事項
Table Store.NET SDK從5.0.0版本開始支援SQL查詢功能,使用SQL查詢功能時,請確保安裝了正確的.NET SDK版本。
關於.NET SDK歷史迭代版本的更多資訊,請參見.NET SDK歷史迭代版本。
前提條件
-
如需建立多元索引的映射關係,必須首先建立多元索引。
參數
|
參數 |
說明 |
|
query |
SQL語句,請根據所需功能進行設定。 |
樣本
以下樣本以資料表的映射關係為例。如需建立多元索引的映射關係,將樣本中的 SQL 陳述式替換為對應的多元索引 CREATE TABLE 語句即可。
以下樣本用於使用CREATE TABLE `test_table` (`pk0` VARCHAR(1024), `pk1` BIGINT(20), `col0` MEDIUMTEXT, `col1` BIGINT(20), `col2` DOUBLE, `col3` BOOL, `col4` MEDIUMBLOB, `date_col` MEDIUMTEXT, `geo_col` MEDIUMTEXT, `col0_v1` MEDIUMTEXT, `col0_v2` MEDIUMTEXT, PRIMARY KEY(`pk0`,`pk1`));語句建立test_table表的映射關係。
/// <summary>
/// 建立資料表的映射關係。
/// </summary>
/// <param name="otsClient"></param>
public static void CreateMappingTable(OTSClient otsClient)
{
string sqlCommand = @"CREATE TABLE `test_table` (
`pk0` VARCHAR(1024),
`pk1` BIGINT(20),
`col0` MEDIUMTEXT,
`col1` BIGINT(20),
`col2` DOUBLE,
`col3` BOOL,
`col4` MEDIUMBLOB,
`date_col` MEDIUMTEXT,
`geo_col` MEDIUMTEXT,
`col0_v1` MEDIUMTEXT,
`col0_v2` MEDIUMTEXT,
PRIMARY KEY(`pk0`,`pk1`)
);";
SQLQueryRequest sqlQueryRequest = new SQLQueryRequest(sqlCommand);
SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);
}
常見問題
建立映射關係時出現Table 'instancename.tablename' doesn't exist ?
-
出現此問題的可能原因如下:
建立映射關係時,指定的表不存在。
-
解決方案:
SQL中的Create Table語句只能為已存在的表或者多元索引建立映射關係。請確保要建立映射關係的表或者多元索引存在。
建立映射關係時出現Table 'instancename.tablename' already exist ?
-
出現此問題的原因如下:
該表已通過 CREATE TABLE 語句建立映射關係。
-
解決方案:
您可以通過
DESCRIBE語句查看現有映射表的表結構,如果不符合業務查詢要求,您可以DDL 操作。
更多關於 SQL 查詢功能的常見錯誤及其解決方案,請參見SQL查詢常見錯誤排查。