步驟一：使用PrestoDB對接Tablestore

安裝PrestoDB后，您需要進行PrestoDB的Catalog配置和Schema配置來完成PrestoDB和Tablestore的對接，其中Catalog配置文件的存放路徑為etc/catalog/tablestore.properties。

步驟二：運行Presto的SQL CLI

對接完成后，您可以啟動Presto Server并運行SQL。

1. 獲取client可執行程序。

   1. 下載PrestoDB客戶端。

      此處以presto-cli-0.280-executable.jar為例介紹。

   2. 將PrestoDB客戶端保存到PrestoDB安裝目錄下的bin目錄中。

   3. 在PrestoDB安裝目錄下的bin目錄中執行如下命令獲取client可執行程序。

      # 將PrestoDB客戶端文件重命名為presto。其中presto-cli-0.280-executable.jar請替換為實際所用的客戶端版本名稱。
      mv presto-cli-0.280-executable.jar presto
      # 為用戶授予操作presto文件的權限。
      chmod +x presto

      client可執行程序的所處目錄如下圖所示。

      

2. 在PrestoDB安裝目錄下的bin目錄中執行命令啟動Presto Server。

   重要

   啟動Presto Server時，您必須分別啟動Coordinator和至少一個Worker。

   # 支持前臺運行和后臺運行兩種啟動方式，其中前臺運行方式更方便查看運行日志。
   # 方式一：后臺運行
   ./launcher start
   # 方式二：前臺運行
   ./launcher run

3. 在PrestoDB安裝目錄下的bin目錄中執行如下命令啟動SQL CLI。

   說明

   • PrestoDB默認運行在8080端口。如果要修改端口配置，請修改etc/config.properties中的http-server.http.port配置。

   • 修改部分config配置后需要重啟服務器使配置生效。

   • 命令中的./presto為client可執行程序在PrestoDB安裝目錄下的bin目錄中的相對路徑。

   ./presto --server localhost:8080 --catalog tablestore --schema default

   配置項說明請參見下表。

   配置項	示例	是否必選	說明
   --server	localhost:8080	是	Presto Server的URI，請根據實際替換。此項的配置必須與PrestoDB安裝目錄下etc/config.properties文件中的discovery.uri參數的配置相同。
   --catalog	tablestore	是	Catalog配置文件的名稱，此處配置為tablestore，與創建的Catalog配置文件名稱相同。
   --schema	default	是	Schema配置，保持default配置即可。

步驟三：創建Schema和映射表

使用Meta表動態配置的Schema配置模式時，您需要手動創建并使用Schema用于配置對接的Tablestore實例和進行用戶鑒權，然后再創建Tablestore表的映射表用于數據查詢和分析。

1. 執行如下命令創建Schema。

   創建一個訪問Tablestore myinstance實例的Schema，Schema名稱為testdb。

   CREATE SCHEMA tablestore.testdb
   WITH (
     endpoint = 'https://myinstance.cn-hangzhou.ots.aliyuncs.com',
     instance_name = 'myinstance',
     access_id = '************************',
     access_key = '********************************'
   );

   具體參數配置說明請參見下表。

   參數	示例	是否必選	說明
   endpoint	https://myinstance.cn-hangzhou.ots.aliyuncs.com	是	Tablestore實例的訪問地址。更多信息，請參見服務地址。
   instance_name	myinstance	是	Tablestore實例名稱。更多信息，請參見實例。
   access_id	************************	是	阿里云賬號或者RAM用戶的AccessKey ID。
   access_key	********************************	是	阿里云賬號或者RAM用戶的AccessKey Secret。

2. 執行use <SCHEMA_NAME>;命令使用創建的Schema。

   其中<SCHEMA_NAME>請替換為實際創建的Schema名稱。您可以執行show schemas;命令獲取Schema列表。

3. 執行如下命令Tablestore數據表的映射表。

   重要

   創建映射表時，請注意如下事項：

   • 請確保映射表中的字段類型和表格Tablestore數據表中的字段類型相匹配更多信息，請參見字段類型映射。

   • 映射表名稱必須與Tablestore中實際的表名稱相同。

   • SQL語句CREATE TABLE中的table_name用于映射到Tablestore中實際的表。您可以為Tablestore中的同一個數據表創建多個不同的映射表。

   • 映射表中必須包括數據表的所有主鍵列，但是支持只包括部分屬性列。

   • 映射表中主鍵列的名稱和順序必須與Tablestore數據表中主鍵列的名稱和順序保持一致。映射表中每一個屬性列可通過指定 origin_name參數來映射到Tablestore中實際表內的列名。

   假設數據表名為main_table，包括gid和uid兩個主鍵列以及col1、col2和col3三個屬性列。

   以下SQL示例用于為Tablestore數據表main_table創建一個同名映射表。

   CREATE TABLE if not exists main_table
   (
      gid bigint,
      uid bigint,
      c1 boolean with (origin_name = 'col1'),
      c2 bigint with (origin_name = 'col2'),
      c3 varchar with (origin_name = 'col3')
   ) WITH (
      table_name = 'main_table'
   );

步驟四：使用SQL操作數據

使用SQL語句查詢Schema配置、表的元數據以及讀寫Tablestore表中數據。更多SQL示例，請參見常用SQL示例。

1. 查詢Schema配置。

   • 獲取Schema列表

     show schemas;

   • 獲取指定Schema中表列表

     show tables;

2. 查看指定表的元數據

   其中<TABLE_NAME>請替換為實際的表名稱。

   describe <TABLE_NAME>;

3. 數據操作。

   讀寫Tablestore數據。

   • 寫入數據

     • 插入一行數據

       以下示例用于在main_table中插入一行數據。

       insert into main_table values(10001,10001,true,100,'hangzhou');

     • 批量導入數據

       重要

       批量導入數據前，請確保已創建目標表，且目標表的表結構與源數據表的表結構保持一致。

       以下示例用于將main_table表中gid大于0且uid小于10000的gid、uid、c1、c2和c3列數據批量導入到sampletable表中。

       insert into sampletable select gid, uid, c1, c2, c3 from main_table where gid > 0 and uid < 100000;

   • 讀取數據

     以下示例用于查詢sampletable表中gid列值大于0，uid列值小于10且c1等于true的行數據。

     select * from sampletable where gid > 0 and uid < 10 and c1 = true;