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

功能介绍

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

前提条件

操作步骤

  1. 申请ADAM SQL Adapter权限。
    1. 登录数据库与应用迁移控制台
    2. 单击左侧导航栏中的迁移实验室
    3. 单击ADAM SQL Adapter下的申请按钮。
    4. 在申请页面填写公司名称联系电话申请原因等信息,单击提交,完成申请。
  2. 创建Adapter实例。
    1. 登录数据库与应用迁移控制台
    2. 单击左侧导航栏中的迁移实验室
    3. 单击ADAM SQL Adapter下的详情按钮,进入ADAM Adapter页面。
    4. 单击左上角申请adapter实例按钮。
    5. 填写参数,创建Adapter实例。
      创建Adapter实例
      参数 取值及含义
      VPC网络所在区域 表示创建Adapter实例的VPC所在地域。
      取值范围:
      • cn-hangzhou
      • cn-beijing
      说明 Adapter实例当前仅支持杭州和北京地域,如果您需要使用其它地域,请提交工单
      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. 单击左侧导航栏中的迁移实验室
    2. 单击ADAM SQL Adapter下的详情按钮,进入ADAM Adapter页面。
    3. 查看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.6 ADAM Adapter实例的IP。获取方法请参见获取ADAM Adapter实例的IP和端口。
    端口(Port) 8888 ADAM 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。