本文將為您介紹幾款常見用戶端工具的接入說明,除此之外,原則上支援PostgresSQL的工具都可以通過Lightning來對接訪問MaxCompute。

阿里雲Quick BI

  1. 登入Quick BI控制台,單擊左側導覽列中的資料來源
  2. 單擊資料來源管理頁面右上方的建立資料來源
  3. 選擇雲資料庫或自建資料來源中的PostgeSQL資料庫類型添加資料來源。
  4. 填寫對話方塊中的MaxCompute Lightning的串連資訊並測試連接連通狀態。
    參數 說明
    資料庫地址 MaxCompute Lightning對應地區的Endpoint,可使用公網訪問的Endpoint,也可以使用傳統網路及VPC網路訪問的Endpoint。
    資料庫 需要訪問的MaxCompute項目的名稱加?ssl=true,如上圖中的lightning?ssl=true
    Schema MaxCompute項目名稱。
    使用者名/密碼 使用者的Access Key ID/Access Key Secret。

SQL Workbench/J

SQL Workbench/J是一款流行的免費、跨平台SQL查詢分析工具,使用SQL Workbench/J可以通過PostgreSQL驅動串連MaxCompute Lightning服務。

  1. 下載並安裝SQL Workbench/J 。
  2. 啟動SQL Workbench/J,建立資料庫連接。

    選擇PostgreSQL驅動,串連MaxCompute項目所對應的Lightning URL地址,同時輸入訪問使用者的使用者名和密碼,即Access Key ID和Access Key Secret。

    您也可通過擴充屬性(Extended Properities)設定ssl取值為true。
  3. 串連後,在Workbench工作區查看MaxCompute項目的表資料、查詢分析。

psql工具串連

psql是PostgreSQL的一個命令列互動式用戶端工具,在本機安裝PostgreSQL資料庫將預設安裝psql用戶端。

通過psql在命令列下可以串連MaxCompute Lightning,文法與串連PostgreSQL資料庫一致。
psql -h <endpoint> -U <userid> -d <databasename> -p <port>
參數說明:
  • <endpoint>:MaxCompute Lightning的Endpoint,詳情請參見訪問網域名稱
  • <userid>:訪問使用者Access Key ID。
  • <databasename>:Maxcompute項目名。
  • <port>:443

執行後,在psql密碼提示符處,輸入<userid>使用者的密碼,即訪問使用者的Access Key Secret。

樣本如下:
说明 psql預設優先通過ssl方式串連。

Tableau Desktop

使用BI工具,選擇PostgreSQL資料來源,配置串連。

配置串連時,需勾選需要SSL

登入後,通過Tableau建立工作表進行可視化分析。

说明 為了獲得更好的效能和體驗,建議您使用Tableau支援的TDC檔案方式,對Lightning資料來源進行串連定製最佳化。具體操作如下:
  1. 將如下xml內容儲存為postgresql.tdc檔案。
    <?xml version='1.0' encoding='utf-8' ?>
    <connection-customization class='postgres' enabled='true' version='8.10'>
    <vendor name='postgres'/>
    <driver name='postgres'/>
    <customizations>
    <customization name='CAP_CREATE_TEMP_TABLES' value='no' />
    <customization name='CAP_STORED_PROCEDURE_TEMP_TABLE_FROM_BUFFER' value='no' />
    <customization name='CAP_CONNECT_STORED_PROCEDURE' value='no' />
    <customization name='CAP_SELECT_INTO' value='no' />
    <customization name='CAP_SELECT_TOP_INTO' value='no' />
    <customization name='CAP_ISOLATION_LEVEL_SERIALIZABLE' value='yes' />
    <customization name='CAP_SUPPRESS_DISCOVERY_QUERIES' value='yes' />
    <customization name='CAP_SKIP_CONNECT_VALIDATION' value='yes' />
    <customization name='CAP_ODBC_TRANSACTIONS_SUPPRESS_EXPLICIT_COMMIT' value='yes' />
    <customization name='CAP_ODBC_TRANSACTIONS_SUPPRESS_AUTO_COMMIT' value='yes' />
    <customization name='CAP_ODBC_REBIND_SKIP_UNBIND' value='yes' />
    <customization name='CAP_FAST_METADATA' value='no' />
    <customization name='CAP_ODBC_METADATA_SUPPRESS_SELECT_STAR' value='yes' />
    <customization name='CAP_ODBC_METADATA_SUPPRESS_EXECUTED_QUERY' value='yes' />
    <customization name='CAP_ODBC_UNBIND_AUTO' value='yes' />
    <customization name='SQL_TXN_CAPABLE' value='0' />
    <customization name='CAP_ODBC_CURSOR_FORWARD_ONLY' value='yes' />
    <customization name='CAP_ODBC_TRANSACTIONS_COMMIT_INVALIDATES_PREPARED_QUERY' value='yes' />
    </customizations>
    </connection-customization>
    
  2. 將檔案儲存到\My Documents\My Tableau Repository\Datasources目錄下。如果是Tableau Server,Windows下請儲存在C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Datasources,Linux下請儲存在/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/
  3. 重新開啟Tableau,使用PostgreSQL資料來源串連MaxCompute Lightning服務。關於tdc檔案定製資料來源的更多內容,請參見Tableau官方協助文檔

帆軟Report

  1. 開啟帆軟Report,選擇伺服器 > 定義資料庫連接
  2. 添加JDBC串連。
    參數說明如下:
    參數 說明
    資料庫 Postgre
    磁碟機 帆軟Report內建的org.postgresql.Driver
    URL

    jdbc:postgresql://<MaxCompute Lightning Endpoint>:443/<Project_Name>?ssl=true&prepareThreshold=0

    例如:jdbc:postgresql://lightning.cn-shanghai.maxcompute.aliyun.com:443/lightning_demo?ssl=true&prepareThreshold=0

    使用者名/密碼 訪問使用者的Access Key ID和Access Key Secret