创建GBase 8a数据源

通过创建GBase 8a数据源能够实现Dataphin读取GBase 8a的业务数据或向GBase 8a写入数据。本文为您介绍如何创建GBase 8a数据源。

使用限制

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

操作步骤

  1. 在Dataphin首页,在顶部菜单栏选择管理中心 > 数据源管理

  2. 数据源页面,单击+新建数据源

  3. 新建数据源对话框的关系型数据库区域,选择GBase 8a

    如果您最近使用过GBase 8a,也可以在最近使用区域选择GBase 8a。同时,您也可以在搜索框中,输入GBase 8a的关键词,快速筛选。

  4. 新建GBase 8a数据源对话框中,配置连接数据源的参数。

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

      参数

      描述

      数据源名称

      命名规则如下:

      • 只能包含中文、英文字母大小写、数字、下划线(_)或短划线(-)。

      • 长度不能超过64个字符。

      数据源编码

      配置数据源编码后,您可以在Flink_SQL任务中通过数据源编码.表名称数据源编码.schema.表名称的格式引用数据源中的表;如果需要根据所处环境自动访问对应环境的数据源,请通过${数据源编码}.table${数据源编码}.schema.table的变量格式访问。更多信息,请参见Flink_SQL任务开发方式

      重要
      • 目前仅支持MySQLHologresMaxCompute数据源。

      • 数据源编码配置成功后不支持修改。

      数据源描述

      对GBase 8a数据源的描述。不超过128个字符。

      数据源配置

      基于业务数据源是否区分生产数据源和开发数据源:

      • 如果业务数据源区分生产数据源和开发数据源,则选择生产+开发数据源

      • 如果业务数据源不区分生产数据源和开发数据源,则选择生产数据源

      标签

      您可根据标签给数据源进行分类打标,如何创建标签,请参见管理数据源标签

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

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

      说明

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

      配置方式可选择JDBC URL主机两种方式,默认选择为JDBC URL。

      JDBC URL配置方式

      参数

      描述

      JDBC URL

      链接地址的格式为 jdbc:gbase://hosy:port/dbname。例如:jdbc:gbase://192.168.*.212:5258/dataphin。

      用户名和密码

      数据库对应的用户名和密码。

      主机配置方式
      • 主机配置方式

        参数

        描述

        服务器地址

        输入服务器的IP地址和端口号。

        支持单击+新增来添加多组IP地址和端口号,单击image图标删除多余的IP地址和端口号,但需至少保留一组。

        dbname

        输入数据库名称。

      • 参数配置

        参数

        描述

        参数

        • 参数名称:仅支持选择已有参数名称。

        • 参数值:当已选择参数名称时,参数值为必填。仅支持英文字母大小写、数字、半角句号(.)、下划线(_)和短划线(-),长度不超过256个字符。

        说明

        支持通过单击+添加参数新增多个参数,单击image图标删除多余参数,至多可添加30个参数。

        用户名密码

        登录GBase 8a数据库的用户名和密码。

      说明

      当配置方式选择为主机并完成新建数据源后,若需要切换为JDBC URL配置方式,系统会将服务器的IP地址和端口号拼接为JDBC URL进行填充。

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

      参数

      描述

      socketTimeout

      数据库的socketTimeout时长(单位:毫秒),默认1800000毫秒(30分钟)。

      说明
      • 若您在JDBC URL中带有socketTimeout配置,则socketTimeout为JDBC URL中配置的超时时间。

      • Dataphin V3.11版本之前的创建数据源,socketTimeout默认为-1,表示无超时限制。

      connectTimeout

      数据库的connectTimeout时长(单位:毫秒),默认900000毫秒(15分钟)。

      说明
      • 若您在JDBC URL中带有connectTimeout配置,则connectTimeout为JDBC URL中配置的超时时间。

      • Dataphin V3.11版本之前的创建数据源,connectTimeout默认为-1,表示无超时限制。

      连接重试次数

      数据库连接超时,将自动重试连接直到完成设定的重试次数。若达到最大重试次数仍未连接成功,则连接失败。

      说明
      • 默认重试次数为1次,支持配置0~10之间参数。

      • 连接重试次数将默认应用于离线集成任务全域质量(需开通资产质量功能模块),离线集成任务中支持单独配置任务级别的重试次数。

    说明

    重复参数的取值规则:

    • 若某一参数同时存在于JDBC URL高级设置的参数和主机配置方式的参数配置中时,则以JDBC URL中该参数的取值为准。

    • 若某一参数同时存在于JDBC URL高级设置的参数中时,则以JDBC URL中该参数的取值为准。

    • 若某一参数同时存在于高级设置的参数和主机配置方式的参数配置中时,则以高级设置的参数配置中该参数的取值为准。

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

    重要

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

  6. 测试成功后,单击确定,完成GBase 8a数据源的创建。