创建AnalyticDB for PostgreSQL数据源

前提条件

若您需在Dataphin中创建基于阿里云产品的数据源，创建数据源前，需确保Dataphin的IP已添加至数据库白名单（或安全组）中，使数据源与Dataphin网络互通。具体操作，请参见数据源白名单配置。

背景信息

AnalyticDB for PostgreSQL即阿里云的云原生数仓AnalyticDB PostgreSQL，是一款兼容ANSI SQL 2003、兼容PostgreSQL/Oracle数据库生态的MPP数据库。它具备完整的事务处理、高吞吐写入和流批一体引擎，通过全自研计算引擎及行列混合存储提供高性能数据处理和在线分析能力。如果您使用的是云原生数仓AnalyticDB PostgreSQL，在对接Dataphin进行数据开发时，您需要先完成AnalyticDB for PostgreSQL数据源的创建。

权限说明

仅支持拥有新建数据源权限点的自定义全局角色和超级管理员、数据源管理员、板块架构师、项目管理员系统角色创建数据源。

操作步骤

1. 在Dataphin首页，单击顶部菜单栏管理中心 > 数据源管理。

2. 在数据源页面，单击+新建数据源。

3. 在新建数据源对话框的关系型数据库区域，选择AnalyticDB for PostgreSQL。

   如果您最近使用过AnalyticDB for PostgreSQL，也可以在最近使用区域选择AnalyticDB for PostgreSQL。同时，您也可以在搜索框中，输入AnalyticDB for PostgreSQL的关键词，快速搜索。

4. 在新建AnalyticDB for PostgreSQL数据源对话框中，配置连接数据源参数。

   1. 配置数据源的基本信息。

      参数	描述
      数据源名称	命名规则如下： 只能包含中文、英文字母大小写、数字、下划线（_）或短划线（-）。 长度不能超过64个字符。
      数据源编码	配置数据源编码后，您可以在Flink_SQL任务中通过数据源编码.表名称或数据源编码.schema.表名称的格式引用数据源中的表；如果需要根据所处环境自动访问对应环境的数据源，请通过${数据源编码}.table或${数据源编码}.schema.table的变量格式访问。更多信息，请参见Flink_SQL任务开发方式。 重要 数据源编码配置成功后不支持修改。
      数据源描述	对数据源的简单描述。不得超过128个字符。
      数据源配置	选择需要配置的数据源： 如果业务数据源区分生产数据源和开发数据源，则选择生产+开发数据源。 如果业务数据源不区分生产数据源和开发数据源，则选择生产数据源。
      标签	您可根据标签给数据源进行分类打标，如何创建标签，请参见管理数据源标签。

   2. 配置数据源与Dataphin的连接参数。

      若您的数据源配置选择生产+开发数据源，则需配置生产+开发数据源的连接信息。如果您的数据源配置为生产数据源，仅需配置生产数据源的连接信息。

      说明

      通常情况下，生产数据源和开发数据源需配置为非同一个数据源，以实现开发数据源与生产数据源的环境隔离，降低开发数据源对生产数据源的影响。但Dataphin也支持配置成同一个数据源，即相同参数值。

      参数	描述
      JDBC URL	链接地址的格式为jdbc:postgresql//host:port/dbname。
      Schema	填写计算引擎数据库对应的Schema连接信息。如不指定，将设置为该用户的默认Schema。
      用户名、密码	数据库的用户名和密码。
      访问方式	选择对应的访问方式： 数据源所在网络环境为公网，则访问方式选择为公网IP。 数据源所在网络环境为阿里云VPC网络，则访问方式选择为VPC网络。VPC网络访问数据库需配置以下信息： 区域：数据库所在Region。仅支持与Dataphin实例相同区域的数据库。如您的Dataphin实例位于华东2（上海），仅支持选择华东2（上海）区域。 VPC ID：填写数据库所在VPC网络的VPC ID。 集群 ID：填写AnalyticDB for PostgreSQL集群ID。 在云数据仓库AnalyticDB PostgreSQL实例列表页面，查看实例ID和VPC ID。

   3. 配置数据源的高级设置。

      参数	描述
      connectTimeout	数据库的connectTimeout时长（单位：秒），默认900秒（15分钟）。 说明 若您在JDBC URL中带有connectTimeout配置，则connectTimeout为JDBC URL中配置的超时时间。 Dataphin V3.11版本之前的创建数据源，connectTimeout默认为-1，表示无超时限制。
      socketTimeout	数据库的socketTimeout时长（单位：秒），默认1800秒（30分钟）。 说明 若您在JDBC URL中带有socketTimeout配置，则socketTimeout为JDBC URL中配置的超时时间。 Dataphin V3.11版本之前的创建数据源，socketTimeout默认为-1，表示无超时限制。
      连接重试次数	数据库连接超时，将自动重试连接直到完成设定的重试次数。若达到最大重试次数仍未连接成功，则连接失败。 说明 默认重试次数为1次，支持配置0～10之间参数。 连接重试次数将默认应用于离线集成任务与全域质量（需开通资产质量功能模块），离线集成任务中支持单独配置任务级别的重试次数。

5. 单击测试连接，测试数据源是否可以和Dataphin进行正常的连通。

   重要

   如果连接测试失败，您可以根据网络连通常见问题进行排查。详细内容，请参见网络连通解决方案。

6. 测试成功后，单击确定，完成AnalyticDB for PostgreSQL数据源的创建。