创建Oracle数据源

权限说明

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

操作步骤

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

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

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

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

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

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

      参数	说明
      数据源名称	填写数据源的名称。命名规则如下： 只能包含中文、英文字母大小写、数字、下划线（_）或短划线（-）。 长度不能超过64个字符。
      数据源编码	配置数据源编码后，您可以在Flink_SQL任务或使用Dataphin JDBC客户端中，通过数据源编码.表名称或数据源编码.schema.表名称的格式直接访问Dataphin数据源表，实现快捷消费；如果需要根据任务执行环境自动切换数据源，请通过${数据源编码}.table或${数据源编码}.schema.table的变量格式访问。更多信息，请参见Dataphin数据源表开发方式。 重要 数据源编码配置成功后不支持修改。
      版本	选择需要新建的Oracle数据源版本。版本支持Oracle11g、Oracle12c、Oracle18c、Oracle19c、Oracle21c、Oracle23c。
      数据源描述	对数据源的简单描述。不得超过128个字符。
      数据源配置	选择需要配置的数据源： 如果业务数据源区分生产数据源和开发数据源，则选择生产+开发数据源。 如果业务数据源不区分生产数据源和开发数据源，则选择生产数据源。
      标签	您可根据标签给数据源进行分类打标，如何创建标签，请参见数据源管理标签。

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

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

      说明

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

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

      JDBC URL配置方式

      参数	说明
      JDBC URL	链接地址的格式为jdbc:oracle:thin:@//host:port/dbname。例如，jdbc:oracle:thin:@//192.168.*.1:1521/dataphin。
      Schema	即Oracle实例下的数据库名称。
      用户名、密码	登录Oracle实例的用户名和密码。

      主机配置方式

      • 主机配置方式

        参数	描述
        服务器地址	输入服务器的IP地址和端口号，仅能添加一组。
        服务类型	可选择服务名或SID（System Identifier）。
        dbname	输入数据库名称。

      • 参数配置

        参数	描述
        参数	参数名称：支持选择已有参数名称或输入自定义参数名称。 自定义参数名称仅支持英文字母大小写、数字、半角句号（.）、下划线（_）和短划线（-）。 参数值：当已选择参数名称时，参数值为必填。仅支持英文字母大小写、数字、半角句号（.）、下划线（_）和短划线（-），长度不超过256个字符。 说明 支持通过单击+添加参数新增多个参数，单击图标删除多余参数，至多可添加30个参数。
        Schema（非必填）	如果仅用于实时整库迁移则无需填写Schema，如果用于离线集成或实时计算则需填写Schema（Schema信息区分大小写）。
        用户名、密码	登录Oracle实例的用户名和密码。

      说明

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

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

      参数	说明
      连接重试次数	数据库连接超时，将自动重试连接直到完成设定的重试次数。若达到最大重试次数仍未连接成功，则连接失败。 说明 默认重试次数为1次，支持配置0～10之间参数。 连接重试次数将默认应用于离线集成任务与全域质量（需开通资产质量功能模块），离线集成任务中支持单独配置任务级别的重试次数。

   说明

   重复参数的取值规则：

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

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

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

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

   完成数据源的上述信息配置后，您可以单击操作列的测试连接针对默认集群或已经在Dataphin注册且正常使用的自定义集群进行连接测试。默认集群为系统默认选中，不支持取消选中。自定义集群下不存在资源组时，不支持进行连接测试，需先创建资源组后再进行测试连接。

   • 所选集群只用于测试与当前数据源的网络连通，不用于后续相关任务的运行。

   • 测试连接时长通常在2分钟内，若超时，您可以单击图标查看具体原因并重试。

   • 无论测试结果为连接失败、连接成功或成功有风险，系统都将为您记录最终结果的生成时间。

   • 测试结果为连接失败时，您可以单击图标查看具体失败原因。

   • 测试结果为成功有风险时，代表应用集群连接成功、调度集群连接失败，当前数据源无法用于数据开发和集成。您可以单击图标查看日志信息。

     说明

     仅默认集群的测试结果包含成功有风险、连接成功、连接失败三种连接状态；在Dataphin注册的自定义集群的测试结果仅包含连接成功、连接失败两种连接状态。

   • 请确保至少存在一个集群可以与数据源连通，否则不支持保存数据源信息。

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