SQL Mapping

更新时间: 2023-10-25 17:20:23

ADAM的SQL Mapping可以自动捕捉PolarDB O引擎侧不符合PolarDB O语法规范的SQL,即错误的SQL,并自动完成SQL智能转换(将错误的SQL映射为正确的SQL),若存在不能智能转换的SQL,还可以通过手动配置映射方式转换SQL,避免错误SQL影响应用程序返回正确结果。本文介绍创建SQL Mapping任务的操作步骤。

前提条件

  • 目标数据库实例为PolarDB O引擎。

  • 目标数据库实例已创建polar_sql_mapping插件,关于polar_sql_mapping的详细信息,请参见polar_sql_mapping

  • 目标数据库已通过数据库管理功能添加至ADAM。添加数据库实例的具体步骤,请参见添加PolarDB O引擎数据库

功能说明

SQL Mapping任务不仅支持捕捉应用程序中存量SQL的错误SQL,还支持捕捉应用程序运行一段时间后产生的增量SQL的错误SQL,此时,您需要再次启动智能转换,捕捉增量错误SQL,并自动完成转换。

应用场景

当应用程序出现错误SQL,且无法立即修改时,可以通过SQL Mapping功能,将错误的SQL映射为正确的SQL。

操作步骤

  1. 登录ADAM控制台

  2. 创建SQL Mapping任务。

    1. 在左侧导航栏中,选择SQL Mapping

    2. 单击新建SQL-Mapping任务

    3. 新建SQL-Mapping任务对话框中,配置如下信息。

      配置项

      说明

      任务名

      请输入明确、清晰的任务名,方便后续查询。

      PoalrDB_O数据库实例

      选择目标PolarDB O引擎数据库实例。

      源库类型

      当前仅支持选择Oracle类型。

    4. 单击创建

      任务创建成功后,页面自动跳转至SQL Mapping任务列表,此时,任务状态待执行,您需要等待(3秒左右)系统完成执行任务,再刷新页面,任务状态更新为执行成功

      说明

      在系统执行SQL Mapping任务阶段,会自动完成捕捉错误的SQL动作和SQL智能转换(将错误的SQL映射为正确的SQL)。

  3. 待任务已执行成功后,您可单击目标任务行操作列下的详情,查看错误SQL和映射的详细信息。

  4. 可选:单击错误SQL列表页签,查看错误SQL错误信息和SQL调用次数信息。

  5. 单击SQL映射信息列表页签。

  6. SQL映射。

    1. 在该页面,单击启动智能转换,转换结果将会展示该页面,并对已转换的SQL进行标记。

      说明

      智能转换可自动将SQL中不兼容的部分转换为目标库兼容的SQL,并自动构建映射信息。

    2. 可选:若错误SQL中包含不支持智能转换的SQL,您需要手动配置映射来转换错误SQL。

      1. 单击操作列下的配置映射

      2. 配置映射信息对话框中,将错误SQL调整为正确的SQL。

      3. 单击提交

添加PolarDB O引擎数据库

  1. 登录ADAM控制台

  2. 在左侧的菜单栏中选择数据库管理

  3. 单击创建数据库

  4. 新建数据库档案面板中配置如下信息。

    类别

    配置项

    是否必填

    说明

    档案名

    请输入明确、清晰的名称,方便后续查询。

    数据库类型

    在下拉框中选择PolarDB O引擎。

    目标库信息

    POLARDB-O实例区域

    选择您的PolarDB O引擎所属的地域。

    实例类型

    当实例地域选择例如华北1(青岛)、华北5(呼和浩特)等时,会出现该配置项。目前仅支持选择有公网IP数据库

    POLARDB-O数据库联通的VPC

    选择您的PolarDB O引擎的VPC。您可前往PolarDB控制台,在实例的基本信息页查看VPC。

    POLARDB-O数据库实例

    选择数据库实例。在您已选择POLARDB-O数据库联通的VPC,系统会自动为您匹配到对应的实例。

    POLARDB-O主机IP

    无需填写。在您选择数据库实例后,系统将为您自动获取IP。

    数据库名

    输入目标数据库名。

    编码方式

    选择与数据库字符集对应的编码方式。

    端口

    无需填写,在您选择数据库实例后,系统会为您自动获取。

    用户名

    填写数据库账号。

    口令

    填写数据库密码。

  5. 单击测试连接

  6. 测试连接成功后,单击创建

阿里云首页 数据传输服务 DTS 相关技术圈