SQL Adapter

功能介绍

前提条件

• 已完成结构迁移。
• 您的应用需要部署在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实例。
      

      参数	取值及含义
      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和端口。
      
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。