ADAM SQL Adapter是基于PostgreSQL通迅协议的SQL转发代理服务。本文介绍如何使用SQL Adapter实现不兼容SQL的转换。

功能介绍

SQL Adapter目前支持Oracle到PolarDB O或PolarDB PostgreSQL的SQL改造。主要功能有:
  • 实时转换从Oracle迁移到PolarDB O或PolarDB PostgreSQL不完全兼容的SQL。
  • 异步记录所有需要改造的SQL。
  • 您可以对无法自动转换的SQL进行自定义修改。

前提条件

  • 已完成结构迁移
  • 您的应用需要部署在VPC环境内,SQL Adapter功能暂不支持通过公网使用。
  • Adapter实例当前仅支持杭州和北京地域。
  • 已开通AliyunAdamAccessingDatabaseRole角色。

操作步骤

  1. 申请ADAM SQL Adapter权限。
    1. 登录数据管理DMS 5.0
    2. 在顶部菜单栏中,选择集成与开发(DTS) > 异构数据库迁移(ADAM) > 迁移实验室
    3. ADAM SQL Adapter区域,单击申请
    4. 在申请页面填写公司名称联系电话申请原因等信息,单击提交,完成申请。
  2. 创建Adapter实例。
    1. 登录数据管理DMS 5.0
    2. 在顶部菜单栏中,选择集成与开发(DTS) > 异构数据库迁移(ADAM) > 迁移实验室
    3. ADAM SQL Adapter区域,单击详情
    4. ADAM Adapter页面,单击申请adapter实例
    5. 填写参数,创建Adapter实例。
      创建Adapter实例
      参数取值及含义
      VPC网络所在区域表示创建Adapter实例的VPC所在地域。
      取值范围:
      • cn-hangzhou
      • cn-beijing
      VPC可用区表示创建Adapter实例的VPC所在可用区。
      取值范围:
      • 如果地域选择cn-hangzhou,可用区为cn-hangzhou-b。
      • 如果地域选择cn-beijing,可用区为cn-beijing-b。
      说明 Adapter当前仅支持B可用区。
      交换机名称表示所选VPC地域及可用区下已创建的交换机。如无可用交换机,请前往专有网络管理控制台创建,具体方法,请参见创建和管理交换机
      源库画像选择源库画像。如果没有源库画像,请参见数据库画像
    6. 单击创建实例按钮。
  3. 配置目标库。
    1. ADAM Adapter页面单击配置目标库
      配置目标库
    2. 单击左上角配置目标库按钮,填写目标库相关参数。
      配置目标库
      参数取值及含义
      实例区域不可修改,与创建Adapter实例时取值相同。
      数据库连通的VPC选择目标PolarDB实例的VPC。
      数据库实例选择目标PolarDB实例的实例ID。
      主机IP不可修改,无需配置,自动获取。
      端口无需配置,自动获取。
      数据库名填写PolarDB实例中的目标数据库名称。
      用户名填写目标数据库的用户名。
      口令填写目标数据库的密码。
      CurrentSchema填写当前用户对应的Schema。
    3. 单击测试链接按钮。在提示测试连接成功后,单击创建按钮。
  4. 获取ADAM Adapter实例的IP和端口。
    1. 登录数据管理DMS 5.0
    2. 在顶部菜单栏中,选择集成与开发(DTS) > 异构数据库迁移(ADAM) > 迁移实验室
    3. ADAM SQL Adapter区域,单击详情
    4. 查看ADAM Adapter实例的IP和端口。
      获取Ip和端口
  5. 修改应用连接数据库的URL。
    jdbc:polardb://172.18.100.6:8888/polardb_test
    参数示例说明
    URL前缀jdbc:polardb://URL统一使用jdbc:polardb://作为前缀
    连接地址(IP)172.18.100.6ADAM Adapter实例的IP。获取方法请参见获取ADAM Adapter实例的IP和端口。
    端口(Port)8888ADAM Adapter实例的端口。获取方法请参见获取ADAM Adapter实例的IP和端口。
    数据库名称polardb_test连接的数据库名称。
    说明 用户名及密码无需修改。
  6. 查看ADAM Adapter对SQL的兼容性以及SQL转换情况。
    1. ADAM Adapter页面单击查看详情
      查看详情
    2. 查看ADAM Adapter对SQL的兼容性以及SQL转换情况。
      兼容性
  7. 配置自定义SQL转换规则。
    对于ADAM Adapter不兼容无法转换的SQL,请单击左上角自定义配置规则自定义配置规则
    参数取值及说明
    自定义规则类型表示自定义规则转换的规则类型。
    取值范围:
    • 文本替换。
    • 正则替换。
    说明 如果使用正则替换,请谨慎配置正则规则,恶意的正则规则可能导致Adapter实例资源耗尽,目前Adapter暂不提供高可用保证。
    匹配文本填写待匹配替换的文本或正则表达式。
    替换文本填写替换的文本或正则表达式。
    规则生效范围表示配置的替换规则生效的范围。
    取值范围:
    • 全局生效。
    • 指定SQL替换。
    不兼容SQL选择该参数仅当规则生效范围选择为指定SQL替换时出现。填写替换规则生效的指定SQL。