SQL Mapping
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。
操作步骤
登录ADAM控制台。
创建SQL Mapping任务。
在左侧导航栏中,选择SQL Mapping。
单击新建SQL-Mapping任务。
在新建SQL-Mapping任务对话框中,配置如下信息。
配置项
说明
任务名
请输入明确、清晰的任务名,方便后续查询。
PoalrDB_O数据库实例
选择目标PolarDB O引擎数据库实例。
源库类型
当前仅支持选择Oracle类型。
单击创建。
任务创建成功后,页面自动跳转至SQL Mapping任务列表,此时,任务状态为待执行,您需要等待(3秒左右)系统完成执行任务,再刷新页面,任务状态更新为执行成功。
说明在系统执行SQL Mapping任务阶段,会自动完成捕捉错误的SQL动作和SQL智能转换(将错误的SQL映射为正确的SQL)。
待任务已执行成功后,您可单击目标任务行操作列下的详情,查看错误SQL和映射的详细信息。
可选:单击错误SQL列表页签,查看错误SQL、错误信息和SQL调用次数信息。
单击SQL映射信息列表页签。
SQL映射。
在该页面,单击启动智能转换,转换结果将会展示该页面,并对已转换的SQL进行标记。
说明智能转换可自动将SQL中不兼容的部分转换为目标库兼容的SQL,并自动构建映射信息。
可选:若错误SQL中包含不支持智能转换的SQL,您需要手动配置映射来转换错误SQL。
单击操作列下的配置映射。
在配置映射信息对话框中,将错误SQL调整为正确的SQL。
单击提交。
添加PolarDB O引擎数据库
登录ADAM控制台。
在左侧的菜单栏中选择数据库管理。
单击创建数据库。
在新建数据库档案面板中配置如下信息。
类别
配置项
是否必填
说明
无
档案名
是
请输入明确、清晰的名称,方便后续查询。
数据库类型
是
在下拉框中选择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。
数据库名
是
输入目标数据库名。
编码方式
否
选择与数据库字符集对应的编码方式。
端口
是
无需填写,在您选择数据库实例后,系统会为您自动获取。
用户名
是
填写数据库账号。
口令
是
填写数据库密码。
单击测试连接。
测试连接成功后,单击创建。