通过创建AnalyticDB for PostgreSQL数据源,可以实现Dataphin读取AnalyticDB for PostgreSQL的业务数据或向AnalyticDB for PostgreSQL写入数据。本文为您介绍如何创建AnalyticDB for PostgreSQL数据源。
前提条件
若您需在Dataphin中创建基于阿里云产品的数据源,创建数据源前,需确保Dataphin的IP已添加至数据库白名单(或安全组)中,使数据源与Dataphin网络互通。具体操作,请参见数据源白名单配置。
背景信息
AnalyticDB for PostgreSQL即阿里云的云原生数仓AnalyticDB PostgreSQL,是一款兼容ANSI SQL 2003、兼容PostgreSQL/Oracle数据库生态的MPP数据库。它具备完整的事务处理、高吞吐写入和流批一体引擎,通过全自研计算引擎及行列混合存储提供高性能数据处理和在线分析能力。如果您使用的是云原生数仓AnalyticDB PostgreSQL,在对接Dataphin进行数据开发时,您需要先完成AnalyticDB for PostgreSQL数据源的创建。
权限说明
仅支持拥有新建数据源权限点的自定义全局角色和超级管理员、数据源管理员、板块架构师、项目管理员系统角色创建数据源。
操作步骤
在Dataphin首页,在顶部菜单栏选择管理中心 > 数据源管理。
在数据源页面,单击+新建数据源。
在新建数据源对话框的关系型数据库区域,选择AnalyticDB for PostgreSQL。
如果您最近使用过AnalyticDB for PostgreSQL,也可以在最近使用区域选择AnalyticDB for PostgreSQL。同时,您也可以在搜索框中,输入AnalyticDB for PostgreSQL的关键词,快速搜索。
在新建AnalyticDB for PostgreSQL数据源对话框中,配置连接数据源参数。
配置数据源的基本信息。
参数
描述
数据源名称
命名规则如下:
只能包含中文、英文字母大小写、数字、下划线(_)或短划线(-)。
长度不能超过64个字符。
数据源编码
配置数据源编码后,您可以在Flink_SQL任务中通过
数据源编码.表名称
或数据源编码.schema.表名称
的格式引用数据源中的表;如果需要根据所处环境自动访问对应环境的数据源,请通过${数据源编码}.table
或${数据源编码}.schema.table
的变量格式访问。更多信息,请参见Flink_SQL任务开发方式。重要数据源编码配置成功后不支持修改。
数据源描述
对数据源的简单描述。不得超过128个字符。
数据源配置
选择需要配置的数据源:
如果业务数据源区分生产数据源和开发数据源,则选择生产+开发数据源。
如果业务数据源不区分生产数据源和开发数据源,则选择生产数据源。
标签
您可根据标签给数据源进行分类打标,如何创建标签,请参见管理数据源标签。
配置数据源与Dataphin的连接参数。
若您的数据源配置选择生产+开发数据源,则需配置生产+开发数据源的连接信息。如果您的数据源配置为生产数据源,仅需配置生产数据源的连接信息。
说明通常情况下,生产数据源和开发数据源需配置为非同一个数据源,以实现开发数据源与生产数据源的环境隔离,降低开发数据源对生产数据源的影响。但Dataphin也支持配置成同一个数据源,即相同参数值。
配置方式可选择JDBC URL或主机两种方式,默认选择为JDBC URL。
JDBC URL配置方式
参数
描述
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。
主机配置方式
主机配置方式
参数
描述
服务器地址
输入服务器的IP地址和端口号。
支持单击+新增来添加多组IP地址和端口号,单击图标删除多余的IP地址和端口号,但需至少保留一组。
dbname
输入数据库名称。
参数配置
参数
描述
参数
参数名称:仅支持选择已有参数名称。
参数值:当已选择参数名称时,参数值为必填。仅支持英文字母大小写、数字、半角句号(.)、下划线(_)和短划线(-),长度不超过256个字符。
说明支持通过单击+添加参数新增多个参数,单击图标删除多余参数,至多可添加30个参数。
Schema(非必填)
输入指定读取的Schema信息。支持跨Schema选表,请选择表所在的Schema,如不指定则默认为数据源中配置的schema。
用户名、密码
输入数据库的用户名和密码。
说明当配置方式选择为主机并完成新建数据源后,若需要切换为JDBC URL配置方式,系统会将服务器的IP地址和端口号拼接为JDBC URL进行填充。
配置数据源的高级设置。
参数
描述
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之间参数。
连接重试次数将默认应用于离线集成任务与全域质量(需开通资产质量功能模块),离线集成任务中支持单独配置任务级别的重试次数。
说明重复参数的取值规则:
若某一参数同时存在于JDBC URL、高级设置的参数和主机配置方式的参数配置中时,则以JDBC URL中该参数的取值为准。
若某一参数同时存在于JDBC URL和高级设置的参数中时,则以JDBC URL中该参数的取值为准。
若某一参数同时存在于高级设置的参数和主机配置方式的参数配置中时,则以高级设置的参数配置中该参数的取值为准。
单击测试连接,测试数据源是否可以和Dataphin进行正常的连通。
重要如果连接测试失败,您可以根据网络连通常见问题进行排查。详细内容,请参见网络连通解决方案。
测试成功后,单击确定,完成AnalyticDB for PostgreSQL数据源的创建。