本文将为您介绍几款常见客户端工具的接入说明,除此之外,原则上支持PostgresSQL的工具都可以通过Lightning来对接访问MaxCompute。

阿里云Quick BI

  1. 登录Quick BI控制台,单击左侧导航栏中的数据源
  2. 单击数据源管理页面右上角的新建数据源

  3. 选择云数据库或自建数据源中的PostgeSQL数据库类型添加数据源。

  4. 填写对话框中的MaxCompute Lightning的连接信息并测试连接连通状态。

    参数 说明
    数据库地址 MaxCompute Lightning对应区域的Endpoint,可使用公网访问的Endpoint,也可以使用经典网络及VPC网络访问的Endpoint。
    数据库 需要访问的MaxCompute项目的名称。
    Schema MaxCompute项目名称。
    用户名/密码 在MaxCompute项目中用户的Access Key ID/Access Key Secret。
    ssl 请勾选
    连接测试 连通正常时添加数据源以便在QuickBI中进行分析。

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,详情请参见访问域名Endpoint
  • <userid>:访问用户Access Key ID。
  • <databasename>:Maxcompute项目名。
  • <port>:443

执行后,在psql密码提示符处,输入<userid>用户的密码,即访问用户的Access Key Secret。

示例如下:

说明 psql默认优先通过ssl方式连接。

Tableau Desktop

  1. 使用BI工具,选择PostgreSQL数据源,配置连接。配置连接时,需勾选需要SSL

  2. 登录后,通过Tableau创建工作表进行可视化分析。

说明 时间函数会默认返回UTC时区的时间。如果需要返回北京时间,则需要进行如下配置。
SET timezone = 'Asia/Shanghai';
为了获得更好的性能和体验,建议您使用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