自定义 SQL 语句规范化程序

配置 Introscope SQL 代理 › SQL 语句规范化 › SQL 语句规范化选项 › 自定义 SQL 语句规范化程序

自定义 SQL 语句规范化程序

SQL 代理允许您添加扩展来执行自定义规范化。为此，请创建一个 JAR 文件，其中包含由 SQL 代理实施的规范化方案。

应用 SQL 语句规范化程序扩展

创建扩展 JAR 文件。
注意：SQL 规范化程序扩展文件的入口点类必须实现 com.wily.introscope.agent.trace.ISqlNormalizer 接口。

创建 JAR 扩展文件包括创建清单文件，该清单文件包含下面步骤 2 中详细介绍的 SQL 规范化程序扩展的特定键。然而，要使扩展能够正常运行，还需要其他常规键。这些键是您将要用来构建任意扩展文件的类型。创建的扩展文件与数据库 SQL 语句文本规范化相关，例如 Backends|{backendName}|SQL|{sqlType}|{actualSQLStatement} 节点下的度量标准。 {actualSQLStatement} 由 SQL 规范化程序进行规范化。
将以下键放置在所创建扩展的清单中：
- com-wily-Extension-Plugins-List:testNormalizer1
  注意：此键的值可为任意值。在本例中，testNormalizer1 用作示例。无论您为此键指定何值，请在以下键中使用该值。
- com-wily-Extension-Plugin-testNormalizer1-Type: sqlnormalizer
- com-wily-Extension-Plugin-testNormalizer1-Version: 1
- com-wily-Extension-Plugin-testNormalizer1-Name: normalizer1
  应当包含规范化程序的唯一名称，例如 normalizer1。
- com-wily-Extension-Plugin-testNormalizer1-Entry-Point-Class: <Thefully-qualified classname of your implementation of ISQLNormalizer>
将创建的扩展文件放在 <Agent_Home>/wily/core/ext 目录中。
在 IntroscopeAgent.profile 中，找到以下属性并进行设置：
```
introscope.agent.sqlagent.normalizer.extension
```
从所创建扩展的清单文件中，将属性设置为 com-wily-Extension-Plugin-{plugin}-Name。此属性的值不区分大小写。例如：
```
introscope.agent.sqlagent.normalizer.extension=normalizer1
```
重要信息！ 这是一个热属性。更改扩展名称将导致重新注册扩展。
在 IntroscopeAgent.profile 中，您可以选择性地添加以下属性来设置错误限制计数：
```
introscope.agent.sqlagent.normalizer.extension.errorCount
```
有关错误和异常的更多信息，请参阅异常。

注意：如果自定义规范化程序扩展抛出的错误超过了错误限制计数，将禁用扩展。
保存 IntroscopeAgent.profile。
重新启动应用程序。