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引擎所属的地域。
    POLARDB-O数据库联通的VPC选择您的PolarDB O引擎的VPC。您可前往PolarDB控制台,在实例的基本信息页查看VPC。
    POLARDB-O数据库实例选择数据库实例。在您已选择POLARDB-O数据库联通的VPC,系统会自动为您匹配到对应的实例。
    POLARDB-O主机IP无需填写。在您选择数据库实例后,系统将为您自动获取IP。
    数据库名输入目标数据库名。
    编码方式选择与数据库字符集对应的编码方式。
    端口无需填写,在您选择数据库实例后,系统会为您自动获取。
    用户名填写数据库账号。
    口令填写数据库密码。
  5. 单击测试连接
  6. 测试连接成功后,单击创建