全部產品
Search
文件中心

MaxCompute:DBeaver串連MaxCompute

更新時間:Apr 24, 2025

MaxCompute支援您通過資料庫管理工具DBeaver訪問MaxCompute專案,進行資料管理操作。本文為您介紹如何通過MaxCompute JDBC驅動,串連DBeaver和MaxCompute專案並管理資料。

背景資訊

DBeaver是一款免費的多平台資料庫工具,適用於開發人員、資料庫管理員、分析師和所有需要使用資料庫的人員。更多DBeaver資訊,請參見DBeaver

前提條件

在執行操作前,請確認您已滿足如下條件:

  • 已建立MaxCompute專案。

    更多建立MaxCompute專案操作,請參見建立MaxCompute專案

  • 已擷取可訪問MaxCompute專案的AccessKey ID和AccessKey Secret。

    詳情請參見建立存取金鑰AccessKey

  • 已下載包含完整依賴jar-with-dependenciesJAR包。

    您可以直接單擊odps-jdbc-3.9.0.jar進行下載,也可以通過GitHubMaven庫擷取MaxCompute最新版本的JAR包。本文中的MaxCompute JDBC驅動樣本版本為v3.9.0。

  • 已下載並安裝DBeaver

    更多安裝DBeaver操作,請參見Install。本文中的DBeaver樣本版本為Community Edition 24.3.1。

步驟一:串連DBeaver和MaxCompute

  1. 啟動DBeaver,進入DBeaver介面。

  2. 選擇要串連的資料庫類型。

    在頂部功能表列單擊建立表徵圖後,在選擇您的資料庫對話方塊選擇SQL > SQLite,單擊下一步,進入通用JDBC串連設定對話方塊。

  3. 編輯驅動設定。

    1. 通用JDBC串連設定主要頁簽單擊編輯驅動設定

    2. 設定類名和URL模板。

      編輯驅動'SQLite'對話方塊的設定頁簽,填寫類名com.aliyun.odps.jdbc.OdpsDriverURL模板jdbc:odps:{file}image

    3. 添加JDBC驅動JAR包。

      編輯驅動'SQLite'對話方塊的頁簽,通過添加檔案方式將MaxCompute JDBC驅動JAR包odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar關聯到資料來源的驅動庫(Libraries)中。image

    4. 單擊確定

  4. 填寫JDBC URL資訊。

    通用JDBC串連設定對話方塊的主要頁簽填寫如下JDBC URL資訊。

    參數

    說明

    串連方式

    選擇URL

    JDBC URL

    串連MaxCompute專案的URL。

    • 樣本:jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xx

    • URL格式:jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<access_id>&accessKey=<access_key>[&interactiveMode={true|false}]。配置時刪除<>符號。

      • <maxCompute_endpoint>:必填。MaxCompute專案所屬地區的Endpoint。詳情請參見Endpoint

      • <maxCompute_project_name>:必填。待串連的目標MaxCompute專案名稱。

      • access_id:必填。具備目標MaxCompute專案存取權限的AccessKey ID。您可以進入AccessKey管理頁面擷取AccessKey ID。

      • access_key:必填。AccessKey ID對應的AccessKey Secret。

      • interactiveMode:可選。查詢加速功能開關。

        如果您需要啟用查詢加速功能,在URL後追加&interactiveMode=true配置即可。更多查詢加速功能資訊,請參見查詢加速

  5. 單擊測試連結,若彈出的串連測試對話方塊中顯示已串連,則表示DBeaver和MaxCompute串連成功。P6

步驟二:使用DBeaver查詢及分析資料

串連DBeaver和MaxCompute後,您可以在DBeaver左側查看到建立的MaxCompute串連,並通過SQL管理MaxCompute專案。您可以執行如下操作,更多操作,請參見DBeaver協助

  • 查看所有表

    您可以在建立的MaxCompute串連下查看所有表的資訊。

    P7

  • 查看錶結構

    您可以在建立的MaxCompute串連下,在目標表處單擊右鍵,選擇查看錶,即可查看錶結構資訊。

    P8

  • 查看錶資料

    • 您可以在建立的MaxCompute串連下,單擊SQL編輯器 > 建立SQL編輯器,在編輯器頁面輸入目標表查詢SQL進行查詢,即可查看錶資料資訊。

      p9

    • 若您的專案並未開啟Schema文法開關,詳情請參見Schema文法開關。您也可以在建立的MaxCompute串連下,在目標表處單擊右鍵,選擇查看錶後,在資料頁簽即可查看錶資料資訊。image