1.3.7. 转义字符处理

统一SQL支持对Oracle、MySQL源库的字符串转义字符进行规范化转换处理。根据源库类型、目标库类型以及sql_mode配置（是否包含NO_BACKSLASH_ESCAPES），统一SQL会自动处理反斜杠等转义字符的转换。

1.3.7.1. 概述

MySQL数据库支持使用反斜杠（）作为转义字符，而Oracle数据库中反斜杠被视为普通字符。当进行跨库转换时，需要正确处理这些转义字符，以确保SQL语句在目标库中能够正确执行。

统一SQL通过以下配置项控制转义字符的转换行为：

当源库为MySQL时，根据源库和目标库的sql_mode配置（是否包含NO_BACKSLASH_ESCAPES），转换规则如下：

MySQL源库转义转换规则
源库NBES	目标库类型	目标库NBES	处理方式	说明
有	MySQL系	无	反斜杠double处理	将 `\` 转为 `\\`
有	MySQL系	有	透传	直接透传，不做处理
有	Oracle系/PG系	—	透传	直接透传，不做处理
无	MySQL系	无	透传	直接透传，不做处理
无	MySQL系	有	转义序列消费	将 `\t` 等转义序列解析为实际字符
无	Oracle系/PG系	—	转义序列消费	将 `\t` 等转义序列解析为实际字符

当源库为Oracle时，Oracle中反斜杠始终为普通字符，转换规则如下：

Oracle源库转义转换规则
目标库类型	目标库NBES	处理方式	说明
MySQL系	无	反斜杠double处理	将 `\` 转为 `\\`
MySQL系	有	透传	直接透传，不做处理
Oracle系/PG系	—	透传	直接透传，不做处理

当需要进行转义序列消费处理时，统一SQL支持以下MySQL标准转义序列：

以下数据库属于MySQL系，支持反斜杠转义：

以下数据库属于Oracle系或PG系，反斜杠为普通字符：

控制配置文件版本：

0 （默认值）：旧版本行为，使用 unisql.mysql.backslash.escapes 作为源端的反斜杠转义控制， unisql.target.mysql.sqlmode 控制目标端的转义
20250400007 ：20250400007版本开始行为，使用 unisql.mysql.sqlmode 作为源端的反斜杠转义控制， unisql.target.mysql.sqlmode 控制目标端的转义

源MySQL库的sql_mode配置字符串。当包含 NO_BACKSLASH_ESCAPES 时，表示源库反斜杠为普通字符。

示例：

unisql.mysql.sqlmode=PIPES_AS_CONCAT,IGNORE_SPACE,BACK_QUOTES,ANSI_QUOTES,NO_BACKSLASH_ESCAPES

目标MySQL库的sql_mode配置字符串。当包含 NO_BACKSLASH_ESCAPES 时，表示目标库反斜杠为普通字符。

注意：该参数已废弃，仅在 unisql.conf.version=0 时生效。

源SQL：

INSERT INTO t1 VALUES (1, 'C:\\Users\\test')

转换后（反斜杠double处理）：

INSERT INTO t1 VALUES (1, 'C:\\Users\\test')

源SQL：

INSERT INTO t1 VALUES (1, 'C:\\Users\\test')

转换后（反斜杠double处理）：

INSERT INTO t1 VALUES (1, 'C:\\\\Users\\\\test')

源SQL：

INSERT INTO t1 VALUES (1, 'Line1\\nLine2')

转换后（转义序列消费）：

INSERT INTO t1 VALUES (1, 'Line1
Line2')

源SQL：

INSERT INTO t1 VALUES (1, 'C:\\Users\\test')

转换后（反斜杠double处理）：

INSERT INTO t1 VALUES (1, 'C:\\\\Users\\\\test')

LIKE正则匹配：对于MySQL中LIKE正则对于字符串的两层解析特殊情况，统一SQL不统一处理，每个库自行特殊处理。
LIKE正则匹配：对于MySQL中LIKE正则对于字符串中反斜杠在末尾的特殊处理，统一SQL不进行特殊处理。
DML2DQL：dml 转dql 时，由于正常都是同库不需要转义处理。只对于需要使用源库SQL转换目标库SQL,再转换为DQL的场景需要按上述规则处理转义。