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

阿里云Quick BI

  1. Quick BI控制台，单击左侧导航栏中的数据源。
  2. 单击数据源管理页面右上角的新建数据源。
  3. 选择云数据库或自建数据源中的PostgreSQL数据库类型添加数据源。
  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。