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進行下載，也可以通過GitHub或Maven庫擷取MaxCompute最新版本的JAR包。本文中的MaxCompute JDBC驅動樣本版本為v3.9.0。
已下載並安裝DBeaver。
更多安裝DBeaver操作，請參見Install。本文中的DBeaver樣本版本為Community Edition 24.3.1。
步驟一：串連DBeaver和MaxCompute
啟動DBeaver，進入DBeaver介面。
選擇要串連的資料庫類型。
在頂部功能表列單擊
表徵圖後，在選擇您的資料庫對話方塊選擇，單擊下一步，進入通用JDBC串連設定對話方塊。編輯驅動設定。
在通用JDBC串連設定的主要頁簽單擊編輯驅動設定。
設定類名和URL模板。
在編輯驅動'SQLite'對話方塊的设置頁簽，填寫類名為com.aliyun.odps.jdbc.OdpsDriver，URL模板為jdbc:odps:{file}。
添加JDBC驅動JAR包。
在編輯驅動'SQLite'對話方塊的庫頁簽，通過添加檔案方式將MaxCompute JDBC驅動JAR包
odps-jdbc-3.9.0-rc4-jar-with-dependencies.jar關聯到資料來源的驅動庫（Libraries）中。單擊确定。
填寫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配置即可。更多查詢加速功能資訊，請參見查詢加速。
單擊測試連結，若彈出的串連測試對話方塊中顯示已串連，則表示DBeaver和MaxCompute串連成功。確認串連成功後，單擊確定關閉測試對話方塊，再單擊完成(F)完成資料庫連接配置。
步驟二：使用DBeaver查詢及分析資料
串連DBeaver和MaxCompute後，您可以在DBeaver左側查看到建立的MaxCompute串連，並通過SQL管理MaxCompute專案。您可以執行如下操作，更多操作，請參見DBeaver協助。
查看所有表
您可以在建立的MaxCompute串連下查看所有表的資訊。
在左側資料庫導航面板中，依次展開 MaxCompute 串連節點 > 資料庫名稱 > default > 表，即可展開表列表。頂部搜尋方塊支援輸入表名關鍵字進行篩選。
查看錶結構
您可以在建立的MaxCompute串連下，在目標表處單擊右鍵，選擇查看錶，即可查看錶結構資訊。
以 sale_detail 表為例，其表結構包含
shop_name(STRING)、customer_id(STRING)、total_price(DOUBLE)、sale_date(STRING)、region(STRING) 共 5 列。查看錶資料
您可以在建立的MaxCompute串連下，單擊，在編輯器頁面輸入目標表查詢SQL進行查詢，即可查看錶資料資訊。
例如，輸入查詢語句
SELECT * FROM pyodps_ml_100k_lens;。若您的專案並未開啟Schema文法開關，詳情請參見Schema文法開關。您也可以在建立的MaxCompute串連下，在目標表處單擊右鍵，選擇查看錶後，在資料頁簽即可查看錶資料資訊。
常見問題
使用 DBeaver 串連 MaxCompute 時報錯 Internal error connecting to SQLite 或串連失敗怎麼辦？
情境一：報錯"Internal error connecting to SQLite"
該報錯通常為 DBeaver 用戶端配置或驅動缺失導致，並非 MaxCompute 服務端問題。建議按以下方式排查：
檢查並下載缺失的 sqlite-jdbc 驅動。
嚴格按照本文檔「步驟一：串連 DBeaver 和 MaxCompute」重新核對類名、URL 範本及 JAR 包配置。
情境二：DBeaver 串連 MaxCompute 失敗（無具體報錯或報其他相容性問題）
串連失敗可能由 DBeaver 版本相容性導致。建議使用本文檔推薦的 DBeaver Community Edition 24.3.1 版本進行串連，避免使用過新（如 26.x）或未經驗證的版本。