Hologres：串連HoloWeb

操作步驟

1. 登入Hologres管理主控台。

2. 在頂部功能表列左側，選擇相應的地區。

3. 單擊前往HoloWeb，進入HoloWeb開發頁面。

4. 登入Hologres執行個體。

   1. 單擊元數據管理頁簽的連接實例。

   2. 配置連接實例對話方塊的參數，單擊確定。

      參數	描述	是否必選
      網路類型	公網：支援華東2（上海）、華南1（深圳）、華北2（北京）、華東1（杭州）、華北3（張家口）、新加坡、中國（香港）、馬來西亞（吉隆坡）、印尼（雅加達）及美國（矽谷）等地區。 表徵圖的為公網類型的執行個體。 VPC：僅支援配置為HoloWeb所登入的地區。 表徵圖的為VPC類型的執行個體，該執行個體不支援編輯詳細資料和刪除。	否
      執行個體名	選擇當前帳號已建立的執行個體。 說明 購買執行個體後，HoloWeb頁面需載入執行個體資訊，可能會出現延遲顯示執行個體名稱的情況。此時，您可通過手動設定網域名稱等資訊串連目標執行個體。	否
      名稱	選擇實例名後，名稱預設顯示為所選執行個體的名稱。您也可以重新自訂串連名稱。	是
      描述	串連的描述資訊。	否
      網域名稱	Hologres執行個體的網路網域名稱。 您可以進入Hologres管理主控台的執行個體詳情頁，從網絡資訊中擷取網域名稱。 如果您配置了實例名稱，則系統自動為您匹配該執行個體的網域名稱。您也可以選擇手動輸入欄位名。	是
      連接埠	Hologres執行個體的網路連接埠。 您可以進入Hologres管理主控台的執行個體詳情頁，從網絡資訊擷取連接埠。 如果您配置了實例名稱，則系統自動為您匹配該執行個體的端口。您也可以選擇手動輸入連接埠地址。	是
      登入方式	當前賬戶免密登錄：無需輸入帳號及密碼，直接使用當前賬戶登入。 賬戶密碼登錄：您可以輸入自己或其他賬戶的帳號及密碼，並登入。	是
      帳號	登入方式配置為賬戶密碼登入時，需要配置該參數。 當前帳號的AccessKey ID。 您可以單擊AccessKey 管理，擷取AccessKey ID。	否
      密碼	登入方式配置為賬戶密碼登入時，需要配置該參數。 當前帳號的AccessKey Secret。	否
      測試連通性	檢測串連是否成功： 顯示測試通過表示串連成功。 顯示測試不通過表示串連失敗。	否
      串連後登入	您可以選擇是否登入該執行個體。 是：該執行個體會登入並展示在左側已登入執行個體列表中。 否：該執行個體會展示在左側未登入執行個體列表中。	是

5. （可選）建立資料庫。

   開通Hologres執行個體後，系統自動建立postgres資料庫。該資料庫分配到的資源較少，僅用於管理，開發實際業務需要建立資料庫。

   說明

   如果您已經建立資料庫，請跳過該步驟，直接建立SQL查詢。

   1. 單擊元數據管理 > 資料庫。

      您也可以在元數據管理介面的已登入執行個體列表。滑鼠右擊目標串連，選擇新建數據庫。

   2. 在新建數據庫對話方塊中，填寫配置參數，單擊確認。

      參數	說明
      執行個體名	預設展示當前資料庫所在的已登入執行個體的名稱。
      資料庫名稱	您可以命名當前資料庫的名稱。 說明 配置的資料庫名稱必須唯一。
      權限原則	您可以根據業務需求為資料庫配置對應許可權。更多關於權限原則的說明，請參見： SPM SLPM 專家許可權模型
      立即登入	是：登入後您就可以直接使用建立的資料庫。 否：登入資料庫之後才可以進行使用。

6. 建立SQL查詢。

   成功串連Hologres執行個體後，您可以在SQL編輯器模組，使用標準的PostgreSQL語言進行開發。

   1. 在SQL編輯器頁面，單擊表徵圖。

      您也可以在左側導覽列，滑鼠右鍵單擊我的SQL查詢，選擇新建SQL查詢。具體操作請參見SQL視窗。

   2. 在新增的臨時Query查詢頁面，選擇已建立的實例名和資料庫後，您可以在SQL查詢的編輯框輸入如下樣本語句，單擊運行。

      BEGIN;
      CREATE TABLE nation (
       n_nationkey bigint NOT NULL,
       n_name text NOT NULL,
       n_regionkey bigint NOT NULL,
       n_comment text NOT NULL,
      PRIMARY KEY (n_nationkey)
      );
      CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey');
      CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment');
      CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000');
      COMMIT;
      
      INSERT INTO nation VALUES
      (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'),
      (22,'RUSSIA', 3  ,'requests against the platelets use never according to the quickly regular pint'),
      (2,'BRAZIL',  1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '),
      (5,'ETHIOPIA',  0 ,'ven packages wake quickly. regu'),
      (9,'INDONESIA', 2  ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'),
      (14,'KENYA',  0  ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'),
      (3,'CANADA',  1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'),
      (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'),
      (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'),
      (20 ,'SAUDI ARABIA',  4 ,'ts. silent requests haggle. closely express packages sleep across the blithely');
      
      SELECT * FROM nation;

      說明

      SQL查詢對錶名稱和欄位名稱的大小寫不敏感。如果您需要精確查詢名稱大小寫完全一致的表，則需要對錶名稱加上雙引號。

   3. 在SQL編輯頁面下方的結果[1]地區，查看當前語句的執行結果。

      

7. 建立外部表格，以加速查詢MaxCompute資料為例。

   Hologres與MaxCompute底層資源無縫連通，支援使用建立外部表格的方式加速查詢MaxCompute資料。HoloWeb使用可視化的方式建立外部表格的步驟如下：

   說明

   • 確認您已建立MaxCompute專案，並完成原表的建立和資料寫入。具體操作，請參見以下兩種途徑：

     1. 通過使用DataWorks平台，綁定MaxCompute資料來源後，再執行表的建立和資料寫入。

     2. 通過本地用戶端使用MaxCompute執行表的建立和資料寫入。

   • 您需要在HoloWeb登入資料庫後，方可使用MaxCompute加速和OSS資料湖加速功能。

   1. 單擊元數據管理 > MaxCompute加速 > 創建外部表。

   2. 配置新建外部表的各項參數，根據您的需求選擇對應的加速方式，單擊提交。

      整庫加速

      分類	參數	描述
      加速方式	選擇加速方式	Hologres支援三種加速方式： 整庫加速 部分加速 單錶加速 選擇整庫加速。
      MaxCompute資料來源	項目名	MaxCompute的專案（Project）名稱。
      	Schema Name	MaxCompute的Schema名稱。 對於已開啟Schema的MaxCompute專案，此處可配置當前專案下有許可權的所有Schema名稱；未開啟Schema的專案，無需配置此參數。關於Schema詳情，請參見Schema操作。
      目標表位置	Holo Schema	模式名稱。 您可以選擇預設建立的public模式，也可以選擇建立的模式名稱。
      高級選項	表名衝突	三種表名衝突解決方式： 忽略，繼續建立其他表 更新，修改同名表 報錯，不再重複建立
      	數據類型不支持	兩種資料類型不支援處理方式： 報錯，匯入失敗 忽略,跳過不支持字段所在表

      部分加速

      分類	參數	描述
      加速方式	選擇加速方式	Hologres支援三種加速方式： 整庫加速 部分加速 單錶加速 選擇部分加速。
      MaxCompute資料來源	項目名	MaxCompute的專案（Project）名稱。
      	Schema Name	MaxCompute的Schema名稱。 對於已開啟Schema的MaxCompute專案，此處可配置當前專案下有許可權的所有Schema名稱；未開啟Schema的專案，無需配置此參數。關於Schema詳情，請參見Schema操作。
      目標表位置	Holo Schema	模式名稱。 您可以選擇預設建立的public模式，也可以選擇建立的模式名稱。
      高級選項	表名衝突	三種表名衝突解決方式： 忽略，繼續建立其他表 更新，修改同名表 報錯，不再重複建立
      	數據類型不支持	兩種資料類型不支援處理方式： 報錯，匯入失敗 忽略,跳過不支持字段所在表
      	搜索	通過表名模糊搜尋，最多支援200張表，超出將不再顯示。

      單表加速

      分類	參數	描述
      加速方式	選擇加速方式	Hologres支援三種加速方式： 整庫加速 部分加速 單錶加速 選擇單錶加速。
      MaxCompute資料來源	項目名	MaxCompute的專案（Project）名稱。
      	Schema Name	MaxCompute的Schema名稱。 對於已開啟Schema的MaxCompute專案，此處可配置當前專案下有許可權的所有Schema名稱；未開啟Schema的專案，無需配置此參數。關於Schema詳情，請參見Schema操作。
      	表名	MaxCompute的對應Schema下的資料表。支援基於表首碼模糊搜尋。
      Hologres 目標表	Schema	模式名稱。 您可以選擇預設建立的public模式，也可以選擇建立的模式名稱。
      	表名	Hologres需要加速的單表表名。
      	目標表描述	Hologres需要加速的單表描述。

   3. 成功建立外部表格後，選擇左側導覽列元數據管理 > 已登入執行個體。雙擊目標外部表格，在外部表格的編輯介面單擊數據預覽，加速查詢MaxCompute資料。