创建PolarDB数据源用于实现Dataphin能够读取PolarDB的业务数据，及能够向PolarDB写入数据。在引入PolarDB的业务数据至Dataphin和将Dataphin的数据写入至PolarDB的场景中，需要先创建PolarDB数据源。本文为您介绍如何创建PolarDB数据源。

背景信息

PolarDB是阿里云自主研发新一代关系型数据库，兼容MySQL、PostgreSQL语法的云托管数据库产品。如果您使用的是PolarDB，在对接Dataphin进行数据开发时，您需要先完成PolarDB数据源的创建。更多PolarDB信息，请参见什么是PolarDB。

Dataphin仅支持对接MySQL和PostgreSQL作为引擎的PolarDB数据库，支持通过VPC网络和公网连接PolarDB数据库。PolarDB支持以下三种类型的MySQL和PostgreSQL数据库作为引擎：公网数据库、阿里云数据库和ECS（VPC）自建数据库。数据库类型不同，所需的配置细节不同，如下图所示。gagaga
数据源类型 数据源类型和网络连通说明 网络连通操作指导
阿里云数据库 即阿里云PolarDB MySQL或PolarDB PostgreSQL。创建数据源过程中，需要根据业务情况选择访问方式（公网IP和VPC网络）后，再配置网络连通参数。
  1. 步骤一：添加Dataphin IP地址至数据库白名单
  2. 步骤二：创建PolarDB数据源
公网数据库 即具备公网访问能力的数据库，访问方式默认为公网IP。直接添加Dataphin IP地址至数据库白名单中即可。
ECS（VPC）自建数据源 即在阿里云ECS上自建的数据库且访问方式为VPC网络。直接配置网络连通参数即可。
为避免因数据源白名单限制导致数据对接访问失败，您需将Dataphin不同网络环境下的IP地址段添加到数据源的白名单中。

使用限制

  • 仅支持超级管理员和项目管理员角色创建数据源。

    如何添加项目成员并授予项目管理员角色，请参见添加项目成员。

  • 当业务数据源（PolarDB）使用VPC网络时，则仅支持创建与Dataphin实例在同一地域PolarDB数据源。

步骤一：添加Dataphin IP地址至数据库白名单

基于PolarDB数据源引擎（MySQL或PostgreSQL）所在的网络环境，添加对应环境下的Dataphin IP地址至数据库白名单中。以阿里云数据库为例为您介绍如何添加白名单，请参见设置白名单。
  • 公网数据库、阿里云数据库且访问方式为公网访问，则需要添加公网下Dataphin IP地址至数据库白名单中。
    表 1. 公网下Dataphin的IP地址
    地域 IP地址
    华东2（上海） 47.102.151.182
    华南1（深圳） 119.23.173.65
    华北2（北京） 123.56.104.202
    华东1（杭州） 47.96.75.100
  • ECS（VPC）自建数据源、阿里云数据库且访问方式为VPC网络，则需要添加VPC网络下Dataphin IP地址至数据库白名单中。ECS（VPC）自建数据源如何添加白名单请参见添加安全组规则。
    表 2. VPC网络下Dataphin的IP地址
    地域 （推荐）通用IP地址 地域IP地址
    华东2（上海） 100.104.0.0/16 100.104.228.128/26、100.104.115.192/26
    华南1（深圳） 100.104.48.128/26
    华北2（北京） 100.104.238.64/26
    华东1（杭州） 100.104.45.0/26

步骤二：创建PolarDB数据源

  1. 请参见入口介绍，进入数仓规划页面。
  2. 按照下图指引，进入新建数据源页面。
    gaga
  3. 在新建数据源对话框的关系型数据库区域，选择PolarDB。
    如果您最近使用过PolarDB，也可以在最近使用区域选择PolarDB。同时，您也可以在快搜索框中，输入PolarDB的关键词，快速筛选。fahgah
  4. 在新建PolarDB数据源对话框中，配置连接数据源参数后，单击确定。
    1. 配置数据源的基本信息。
      gagag
      参数 描述
      数据源名称 命名规则如下：
      • 只能包含字母、数字或下划线（_）。
      • 长度不能超过64字符。
      数据源描述 对PolarDB数据源的简单描述。
      数据库类型 基于PolarDB底层的引擎类型，选择对应的数据库类型：
      • 如果PolarDB底层的引擎为MySQL，则选择MySQL。
      • 如果PolarDB底层的引擎为PostgreSQL，则选择PostgreSQL。
      数据源配置 基于业务数据源是否区分生产数据源和开发数据源：
      • 如果业务数据源区分生产数据源和开发数据源，则选择生产+开发数据源。
      • 如果业务数据源不区分生产数据源和开发数据源，则选择生产数据源。
    2. 配置数据源与Dataphin的连接参数。
      当上述步骤中选择了生产+开发数据源，则配置页面如下图所示。如果上述步骤中您选择了生产数据源，则仅展示生产数据源的配置页面。fagag
      说明 通常，生产数据源和开发数据源需要配置不同的参数值，但Dataphin也支持配置成相同的参数值。
      参数 描述
      JDBC URL 链接地址的格式为jdbc:{数据库类型}://{链接地址}:{端口}/{数据库名称}。其中：
      • 数据库类型：
        • 上述步骤中数据库类型选择为MySQL，则配置为mysql。
        • 上述步骤中数据库类型选择为PostgreSQL，则配置为postgresql。
      • 以数据库类型为MySQL为例，为您介绍如何获取链接地址、端口和数据库名称：
      Schema 当上述步骤中数据库类型选择为PostgreSQL，需要配置Schema。Schema即PostgreSQL实例的数据库名称。在PostgreSQL实例的数据管理页面获取数据库名称，如下图所示。gagag
      注意 当上述步骤中-`库类型选择为MySQL，则配置页面没有Schema配置项。
      用户名、密码 登录PolarDB数据源引擎MySQL或PostgreSQL的用户名和密码。
      类型 PolarDB数据源的引擎MySQL、PostgreSQL均支持选择以下几种类型：
      • 公网数据库：如果您的数据源具备公网访问能力，则可以选择公网数据库。
      • 阿里云数据库：如果您的数据源是阿里云数据库RDS，请选择库阿里云数据。阿里云数据库支持通过公网IP或VPC网络连接Dataphin。
        说明 如果您的数据源是阿里云数据库且支持公网访问，则您可以选择公网数据库，也可以选择阿里云数据库（公网IP）。
      • ECS（VPC）自建数据源：如果您的数据源是在阿里云ECS上自建的数据库，且使用的网络环境为VPC，请选择ECS（VPC）自建数据源。
      区域、VPC ID、PolarDB ID/ECS ID 当类型选择为ECS（VPC）自建数据源和阿里云数据库（VPC网络），还需配置区域、VPC ID、PolarDB ID/ECS ID这些网络参数，其中：
      • 阿里云数据库（VPC网络）：配置如下参数。
        • 区域：仅支持选择当前Dataphin实例所在的地域。
          说明 仅支持添加与Dataphin实例在同一地域的PolarDB数据源至Dataphin。
        • VPC ID：填写PolarDB实例的VPC ID。
        • PolarDB ID：填写PolarDB实例的ID。
      • ECS（VPC）自建数据源：配置如下参数。
        • 区域：仅支持选择当前Dataphin实例所在的地域。
          说明 仅支持添加与Dataphin实例在同一地域的MySQL数据源至Dataphin。
        • VPC ID：填写云服务器ECS实例的VPC ID。
        • ECS ID：填写云服务器ECS实例的ID。
      您可以在PolarDB控制台的实例基本信息页面、ECS实例控制台的实例详情页面查看VPC ID、PolarDB ID、ECS ID，如下图所示。faga
  5. 单击测试连接，测试数据源是否可以和Dataphin进行正常的连通。
    如果连接测试失败，您可以根据网络连通常见问题进行排查。详细内容，请参见网络连通的常见问题。
  6. 测试成功后，单击确定，完成PolarDB数据源的创建。

后续步骤

完成PolarDB数据源的创建后，即可将PolarDB的业务数据引入至Dataphin，或将Dataphin的数据写入至PolarDB数据源。具体操作，请参见配置离线单条管道。