全部產品
Search
文件中心

MaxCompute:SQL Workbench/J串連MaxCompute

更新時間:Jun 19, 2024

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

背景資訊

SQL Workbench/J是一個免費的、獨立於DBMS(Database Management System)的、跨平台的SQL查詢工具。SQL Workbench/J採用Java語言編寫,可以在任何提供Java運行環境的作業系統上運行。

前提條件

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

  • 已建立MaxCompute專案。

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

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

    您可以進入AccessKey管理頁面擷取AccessKey ID和AccessKey Secret。

  • 已下載包含完整依賴JAR包jar-with-dependenciesMaxCompute JDBC驅動(v3.0.1及以上版本)

    本文中的MaxCompute JDBC驅動樣本版本為v3.2.9。

  • 已下載並安裝SQL Workbench/J。

    本文中的SQL Workbench/J樣本版本為Build 127,2020-08-22。

  • 已安裝Java 8及以上版本Java。

操作流程

SQL Workbench/J串連MaxCompute的操作流程如下:

  1. 步驟一:建立驅動

    將MaxCompute JDBC驅動JAR包上傳至SQL Workbench/J,後續SQL Workbench/J可通過該驅動訪問MaxCompute專案。

  2. 步驟二:串連SQL Workbench/J和MaxCompute

    通過配置串連參數,串連SQL Workbench/J及MaxCompute專案。

  3. 步驟三:使用SQL Workbench/J管理MaxCompute專案

    在SQL Workbench/J上基於建立好的資料連線管理MaxCompute專案。

步驟一:建立驅動

  1. 啟動SQL Workbench,進入SQL Workbench介面。

    進入SQL Workbench介面時,系統會自動彈出Select Connection Profile對話方塊。

  2. Select Connection Profile對話方塊左下角,單擊Manage Drivers後建立驅動,自訂驅動名稱並上傳MaxCompute JDBC驅動JAR包後,單擊OK,完成驅動配置。

    建立驅動

    上傳MaxCompute JDBC驅動後,Classname會自動設定為com.aliyun.odps.jdbc.OdpsDriver

步驟二:串連SQL Workbench/J和MaxCompute

  1. Select Connection Profile對話方塊右側的Profile配置介面,填寫串連名稱(例如MCtoSQL)後配置下表所列參數資訊。

    配置串連參數

    參數

    說明

    Driver

    用於串連MaxCompute專案的驅動程式,即步驟一中建立的驅動MaxCompute(com.aliyun.odps.jdbc.OdpsDriver)。

    URL

    串連MaxCompute專案的URL。格式為jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]。配置時刪除<>符號。參數說明如下:

    • <MaxCompute_endpoint>:必填。MaxCompute專案所屬地區的Endpoint。

      各地區的Endpoint資訊,請參見Endpoint

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

      此處為MaxCompute專案名稱,非工作空間名稱。您可以登入MaxCompute控制台,左上方切換地區後,即可在專案管理頁面查看到具體的MaxCompute專案名稱。

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

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

    Username

    具備目標MaxCompute專案存取權限的AccessKey ID。

    您可以進入AccessKey管理頁面擷取AccessKey ID。

    Password

    AccessKey ID對應的AccessKey Secret。

    您可以進入AccessKey管理頁面擷取AccessKey Secret。

  2. 單擊Test,串連成功後單擊OK,建立SQL Workbench/J和MaxCompute資料連線。

    串連測試

步驟三:使用SQL Workbench/J管理MaxCompute專案

在SQL Workbench/J操作介面,您可以基於新建立的資料連線,通過執行MaxCompute SQL命令來管理MaxCompute專案。

  • 查看所有表

    建立SQL Workbench/J和MaxCompute資料連線後,SQL Workbench/J會自動跳轉到SQL執行介面,您可以直接執行show tables;命令查看所有表資訊。

    查看所有表

  • 查看錶結構

    建立SQL Workbench/J和MaxCompute資料連線後,SQL Workbench/J會自動跳轉到SQL執行介面,您可以直接執行desc <table_name>;命令查看錶結構資訊。

    查看錶結構

  • 查看錶資料

    建立SQL Workbench/J和MaxCompute資料連線後,SQL Workbench/J會自動跳轉到SQL執行介面,您可以直接執行SELECT查詢語句查看錶資料資訊。

    查看錶資料