前提條件

• 如果要使用RAM用戶進(jìn)行操作，請確保已創(chuàng)建RAM用戶，并為RAM用戶授予所有SQL操作權(quán)限，即在自定義權(quán)限策略中配置"Action": "ots:SQL*"。具體操作，請參見通過RAM Policy為RAM用戶授權(quán)。

• 已創(chuàng)建數(shù)據(jù)表。

注意事項

目前支持SQL查詢功能的地域包括華東1（杭州）、華東2（上海）、華北2（北京）、華北3（張家口）、華北6（烏蘭察布）、華南1（深圳）、西南1（成都）、中國香港、日本（東京）、新加坡、馬來西亞（吉隆坡）、印度尼西亞（雅加達(dá)）、德國（法蘭克福）、英國（倫敦）、美國（硅谷）、美國（弗吉尼亞）。

步驟一：創(chuàng)建映射關(guān)系

1. 登錄表格存儲控制臺。

2. 在頁面上方，選擇資源組和地域。

3. 在概覽頁面，單擊實例名稱或在操作列單擊實例管理。

4. 在SQL查詢頁簽，創(chuàng)建映射關(guān)系。

   說明

   您也可以直接手動編寫創(chuàng)建映射關(guān)系的SQL語句。更多信息，請參見創(chuàng)建表的映射關(guān)系和創(chuàng)建多元索引的映射關(guān)系。

   1. 單擊圖標(biāo)。

      說明

      當(dāng)不存在映射表時，單擊SQL查詢頁簽，系統(tǒng)會自動彈出創(chuàng)建映射表對話框。

      

   2. 在創(chuàng)建映射表對話框中，根據(jù)下表說明配置參數(shù)。

      參數(shù)	描述
      表類型	表類型。取值范圍如下： 普通表（默認(rèn)）：在為數(shù)據(jù)表創(chuàng)建映射關(guān)系時，選擇此項。 時序表：在為時序表創(chuàng)建映射關(guān)系時，選擇此項。
      表名	表名稱。
      映射模式	創(chuàng)建映射關(guān)系的模式。只有當(dāng)表類型選擇為普通表時才能配置。取值范圍如下： 表映射（默認(rèn)）：為已存在的數(shù)據(jù)表創(chuàng)建映射關(guān)系。 多元索引映射：為已存在的多元索引創(chuàng)建映射關(guān)系。
      高級選項	用于配置映射表的一致性模式和是否使用不準(zhǔn)確的聚合。打開高級選項開關(guān)，即可進(jìn)行配置。只有當(dāng)映射模式選擇為表映射時才能進(jìn)行配置。
      一致性模式	執(zhí)行引擎支持的一致性模式。只有打開了高級選項開關(guān)后才能配置。取值范圍如下： 最終一致（默認(rèn)）：執(zhí)行的查詢結(jié)果滿足最終一致。此時新數(shù)據(jù)寫入后會在幾秒后影響到查詢結(jié)果。 強(qiáng)一致性：執(zhí)行的查詢結(jié)果滿足強(qiáng)一致性。此時新數(shù)據(jù)寫入后立刻影響到查詢結(jié)果。
      不準(zhǔn)確的聚合	是否允許通過犧牲聚合操作的精準(zhǔn)度提升查詢性能。只有打開了高級選項開關(guān)后才能配置。取值范圍如下： 是（默認(rèn)）：允許通過犧牲聚合操作的精度來提升查詢性能。 否：不允許通過犧牲聚合操作的精度提升查詢性能
      多元索引表	映射表綁定的多元索引名稱。只有當(dāng)映射模式選擇為多元索引映射時才能配置。
      映射表表名	映射表名稱。 如果表類型選擇為普通表，當(dāng)映射模式選擇為表映射時，映射表表名與數(shù)據(jù)表名稱相同，不能更改；當(dāng)映射模式選擇為多元索引映射時，需要填寫映射表名稱。 如果表類型選擇為時序表，請根據(jù)實際填寫映射表名稱。時序表映射關(guān)系創(chuàng)建成功后，系統(tǒng)會自動在映射表名前添加時序表名稱::前綴。
      使用分析存儲查詢	分析存儲功能主要用于時序數(shù)據(jù)長期存儲和分析場景。使用分析存儲（Analytical Store）功能，您可以低成本存儲時序數(shù)據(jù)以及快速查詢和分析時序數(shù)據(jù)。更多信息，請參見時序分析存儲概述。 只有當(dāng)表類型選擇為時序表時才能配置。系統(tǒng)默認(rèn)關(guān)閉使用分析存儲查詢開關(guān)，請根據(jù)實際業(yè)務(wù)場景進(jìn)行相應(yīng)配置。 如果不需要使用分析存儲來存儲與分析時序數(shù)據(jù)，使用分析存儲查詢保持默認(rèn)配置即可。 如果需要低成本存儲時序數(shù)據(jù)以及快速查詢和分析時序數(shù)據(jù)，請確保已創(chuàng)建分析存儲并打開使用分析存儲查詢開關(guān)。 重要 如果創(chuàng)建了使用分析存儲查詢的SQL映射表，則在刪除分析存儲時，您需要同時刪除分析存儲SQL映射表。否則會導(dǎo)致刪除分析存儲失敗。

   3. 單擊生成SQL。

      系統(tǒng)會自動生成創(chuàng)建映射表的SQL語句。SQL示例如下：

      CREATE TABLE `exampletable` (
          `id` BIGINT(20),
          `colvalue` MEDIUMTEXT,
          `content` MEDIUMTEXT,
          PRIMARY KEY(`id`)
      );

      重要

      請確保映射關(guān)系中字段數(shù)據(jù)類型和數(shù)據(jù)表中字段數(shù)據(jù)類型相匹配。關(guān)于數(shù)據(jù)類型映射的更多信息，請參見SQL數(shù)據(jù)類型映射。

   4. 根據(jù)實際需要修改映射表的Schema后，按住鼠標(biāo)左鍵拖動選中一條SQL語句并單擊執(zhí)行SQL(F8)。

      執(zhí)行成功后，在執(zhí)行結(jié)果區(qū)域會顯示執(zhí)行結(jié)果。

      重要

      • 創(chuàng)建映射表時設(shè)置的Schema中需要包括后續(xù)查詢數(shù)據(jù)所需的列。

      • 執(zhí)行SQL語句時，請選中一條所需SQL語句，否則系統(tǒng)默認(rèn)執(zhí)行第一條SQL語句。

      • 執(zhí)行SQL語句時，一次只能選中一條SQL語句，否則系統(tǒng)會報錯。

      

步驟二：查詢數(shù)據(jù)

創(chuàng)建映射表后，在SQL查詢頁簽，執(zhí)行SELECT語句查詢所需數(shù)據(jù)。更多信息，請參見查詢數(shù)據(jù)。

查詢到數(shù)據(jù)后，您可以單擊數(shù)據(jù)導(dǎo)出，導(dǎo)出最多2000條數(shù)據(jù)到本地文件（CSV格式）。

常見問題

• 使用SQL查詢數(shù)據(jù)時如何選擇查詢方式

• SQL查詢常見錯誤排查

• 使用SQL查詢數(shù)據(jù)時報錯The sql scanned rows of main table exceeds the quota, main table rows quota is 100000