6. 扫描白名单功能

由于静态扫描的局限性，某些特殊用法无法避免存在一定的误扫情况。故本工具提供白名单功能，将确定误扫的sql加入白名单，可跳过兼容性检查。

白名单功能影响包含离线扫描、在线扫描在内的所有扫描报告。

使用白名单功能需要以下两步操作即可。

6.1. 指定白名单文件

• 新建白名单文件，文件类型为 .sql。

• 在application.yaml文件中配置 whiteListPath 字段为白名单文件的绝对路径。

• 配置项 whiteListPath 为可选项，留空时表示不使用白名单。

例：
    whiteListPath: F:\\LightDB1.0-migrate-assist-V202402-00-000-jar\\whiteList.sql

6.2. 编辑白名单

• 将需要跳过兼容性检查的sql语句加入白名单文件。

• 工具在读取白名单时是以分号（ ; ）断句的，编辑时需要注意每句以分号结束。

• 工具在确认白名单时会统一将sql格式化，去掉多余的换行和空格后再去确认待扫描的sql是否存在于白名单，编辑时可忽略这些格式上的限制。

小技巧

快速配置白名单

将扫描报告的中括号（【】）里完整的原sql复制到白名单文件中，加上分号结尾。