Tablestore：接入到DataWorks

進入資料分析頁面。

1. 以專案系統管理員身份登入DataWorks控制台。

2. 在左側導覽列，選擇資料分析 > SQL查詢。

3. 在SQL查詢頁面，選擇地區後，選擇目標工作空間並單擊進入SQL查詢。

建立SQL查詢檔案。

1. 將滑鼠移動到我的檔案目錄後的加號表徵圖上，選擇建立檔案。

2. 在建立檔案對話方塊中，填寫檔案名稱，然後單擊確定。

   建立後的檔案會顯示在左側地區欄中。

開啟建立的檔案後，配置要查詢的資料來源資訊。

1. 在檔案介面右上方單擊表徵圖。

2. 在懸浮框中根據下表說明配置資料來源資訊。

   參數	說明
   工作空間	工作空間名稱，請根據實際選擇。
   資料來源類型	要查詢的資料來源類型，請選擇為Tablestore。
   資料來源名稱	資料來源名稱，請選擇要查詢的表所在執行個體對應的資料來源名稱。 重要 資料來源名稱列表中僅展示您有許可權使用的資料來源，如需更多資料來源，請聯絡管理員在資訊安全中心進行設定。具體操作，請參見資料查詢與分析管控。

3. 單擊確定。

為表建立映射關係並運行SQL語句。

如果已為表建立了SQL映射關係，請跳過此操作。

1. 在檔案中編寫建立SQL映射關係的SQL語句。具體操作，請參見建立表的映射關係。

   為資料表建立映射關係時，SQL映射表名稱必須與資料表名稱相同，且SQL的主鍵列必須與資料表的主鍵列相同。

   說明

   如果已為資料表建立多元索引，您還可以選擇為多元索引建立映射關係來實現通過指定多元索引查詢資料。具體操作，請參見建立多元索引的映射關係。

   以下樣本用於建立test_table表的SQL映射關係。

   CREATE TABLE `test_table` (
       `pk` VARCHAR(1024), 
       `long_value` BIGINT(20), 
       `double_value` DOUBLE, 
       `string_value` MEDIUMTEXT, 
       `bool_value` BOOL, 
       PRIMARY KEY(`pk`)
   );

2. 單擊SQL語句所在位置後，單擊運行。

   運行結果會顯示在相應結果頁簽中。

使用SQL查詢表中資料。

1. 在檔案中編寫SELECT語句查詢資料。具體操作，請參見查詢資料。

   以下樣本用於查詢test_table表中資料，並且最多返回20行資料。

   SELECT `pk`, `long_value`, `double_value`, `string_value`, `bool_value` FROM test_table LIMIT 20;

2. 單擊SQL語句所在位置後，單擊運行。

   運行結果會顯示在相應結果頁簽中。

進入資料分析頁面。

1. 以專案系統管理員身份登入DataWorks控制台。

2. 在左側導覽列，選擇資料分析 > SQL查詢。

3. 在SQL查詢頁面，選擇地區後，選擇目標工作空間並單擊進入SQL查詢。

建立SQL查詢檔案。

1. 將滑鼠移動到我的檔案目錄後的加號表徵圖上，選擇建立檔案。

2. 在建立檔案對話方塊中，填寫檔案名稱，然後單擊確定。

   建立後的檔案會顯示在左側地區欄中。

開啟建立的檔案後，配置要查詢的資料來源資訊。

1. 在檔案介面右上方單擊表徵圖。

2. 在懸浮框中根據下表說明配置資料來源資訊。

   參數	說明
   工作空間	工作空間名稱，請根據實際選擇。
   資料來源類型	要查詢的資料來源類型，請選擇為Tablestore。
   資料來源名稱	資料來源名稱，請選擇要查詢的表所在執行個體對應的資料來源名稱。 重要 資料來源名稱列表中僅展示您有許可權使用的資料來源，如需更多資料來源，請聯絡管理員在資訊安全中心進行設定。具體操作，請參見資料查詢與分析管控。

3. 單擊確定。

為表建立映射關係並運行SQL語句。

建立時序表後，系統會自動為表建立單值模型映射關係和時間軸中繼資料映射關係，無需手動建立。在SQL中單值模型映射關係的名稱與時序表名相同，時間軸中繼資料映射關係的表名為時序表名稱後拼接::meta。

如果要以多值模型查詢時序資料，您需要手動建立多值模型映射關係。否則請跳過此操作。

1. 在檔案中編寫SQL語句建立SQL映射關係。更多資訊，請參見時序表的SQL映射關係。

   假設測量的屬性同時包含了cpu、memory、disktop三種度量，此處以建立多實值型別映射表timeseries_table::muti_model為例介紹。SQL樣本如下：

   CREATE TABLE `timeseries_table::muti_model` (
     `_m_name` VARCHAR(1024), 
     `_data_source` VARCHAR(1024), 
     `_tags` VARCHAR(1024),
     `_time` BIGINT(20),
     `cpu` DOUBLE(10),
     `memory` DOUBLE(10),
     `disktop` DOUBLE(10),
     PRIMARY KEY(`_m_name`,`_data_source`,`_tags`,`_time`)
   );

2. 單擊SQL語句所在位置後，單擊運行。

   運行結果會顯示在相應結果頁簽中。

使用SQL查詢表中資料。

1. 在檔案中編寫SELECT語句查詢資料。更多資訊，請參見SQL樣本。

   • 使用單值模型映射關係查詢資料

     以下樣本用於查詢時序資料表中basic_metric度量類型的資料。

     SELECT * FROM timeseries_table WHERE _m_name = "basic_metric" LIMIT 10;

   • 使用時間線中繼資料映射關係查詢資料

     以下用於查詢時序中繼資料表中basic_metric度量類型下的時間軸。

     SELECT * FROM  `timeseries_table::meta` WHERE _m_name = "basic_metric" LIMIT 100;

   • 使用多值模型映射關係查詢資料

     以下樣本用於查詢多值模型映射表中cpu大於20.0的所有度量資訊。

     SELECT cpu,memory,disktop FROM `timeseries_table::muti_model` WHERE cpu > 20.0 LIMIT 10;

2. 單擊SQL語句所在位置後，單擊運行。

   運行結果會顯示在相應結果頁簽中。