全部产品
Search

搜索本产品

    数据传输服务 DTS：SQL Adapter

    文档中心

    数据传输服务 DTS：SQL Adapter

    更新时间：Sep 30, 2024

    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. 在顶部菜单栏中，选择集成与开发 > 异构数据库迁移（ADAM） > 迁移实验室。
      3. 在ADAM SQL Adapter区域，单击申请。
      4. 在申请页面填写公司名称、联系电话、申请原因等信息，单击提交，完成申请。
    2. 创建Adapter实例。
      1. 登录数据管理DMS 5.0。
      2. 在顶部菜单栏中，选择集成与开发 > 异构数据库迁移（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. 在顶部菜单栏中，选择集成与开发 > 异构数据库迁移（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。