全部產品
Search
文件中心

Tablestore:建立映射關係

更新時間:Oct 23, 2026

通過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查詢常見錯誤排查。

相關文檔