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和映射的详细信息。
- 可选:单击错误SQL列表页签,查看错误SQL、错误信息和SQL调用次数信息。
- 单击SQL映射信息列表页签。
- SQL映射。
添加PolarDB O引擎数据库
- 登录ADAM控制台。
- 在左侧的菜单栏中选择数据库管理。
- 单击创建数据库。
- 在新建数据库档案面板中配置如下信息。
类别 配置项 是否必填 说明 无 档案名 是 请输入明确、清晰的名称,方便后续查询。 数据库类型 是 在下拉框中选择PolarDB O引擎。 目标库信息 POLARDB-O实例区域 是 选择您的PolarDB O引擎所属的地域。 POLARDB-O数据库联通的VPC 是 选择您的PolarDB O引擎的VPC。您可前往PolarDB控制台,在实例的基本信息页查看VPC。 POLARDB-O数据库实例 是 选择数据库实例。在您已选择POLARDB-O数据库联通的VPC,系统会自动为您匹配到对应的实例。 POLARDB-O主机IP 是 无需填写。在您选择数据库实例后,系统将为您自动获取IP。 数据库名 是 输入目标数据库名。 编码方式 否 选择与数据库字符集对应的编码方式。 端口 是 无需填写,在您选择数据库实例后,系统会为您自动获取。 用户名 是 填写数据库账号。 口令 是 填写数据库密码。 - 单击测试连接。
- 测试连接成功后,单击创建。