在之前的一篇文章中，我们简要介绍了「IvorySQL的IVY_GUC框架介绍与使用指南」，除了数据类型和内置函数的兼容性外，IvorySQL还新增了一些GUC参数，以便更好地对数据库变量进行设置和对数据库进行控制。
接下来，本文将详细介绍IvorySQL支持多种SQL语句，并且可以与多种数据库进行交互。在IvorySQL中，新增命令和配置参数可以帮助优化查询性能和查询灵活性。
01 初始化指定模式命令
为了满足PG模式和兼容Oracle模式，IvorySQL特别设计了PG和Oracle两种模式，并且可以在initdb时指定所需模式。
相关文档链接：
https://docs.ivorysql.org/cn/ivorysql-doc/v3.0/v3.0/17
具体命令如下：
1.1 初始化PG模式
(1)./initdb -D ../data -m pg
(2)要检查是否已成功指定模式，请启动数据库。运行命令：./pg_ctl -D ../data start。如果显示以下信息，则表示已成功指定PG模式：
2023-12-01 15:02:22.327 CST [41358] LOG: listening on IPv4 address "127.0.0.1", port 5432
2023-12-01 15:02:22.338 CST [41358] LOG: listening on Unix socket "/tmp/.s.PGSQL.5432"2023-12-01 15:02:22.362 CST [41361] LOG: database system was shut down at 2023-12-01 15:01:47 CST
2023-12-01 15:02:22.394 CST [41358] LOG: database system is ready to accept connections
done
server started1.2 初始化oracle兼容模式
(1)执行初始化数据库命令：./initdb -D ../data -m oracle
(2)验证初始化是否成功，并通过./pg_ctl -D ../data start启动数据库。启动后会显示以下内容
2023-12-01 15:14:10.357 CST [42280] LOG: listening on IPv4 address "127.0.0.1", port 5432
2023-12-01 15:14:10.362 CST [42280] LOG: listening on IPv4 address "127.0.0.1", port 1521
2023-12-01 15:14:10.368 CST [42280] LOG: listening on Unix socket "/tmp/.s.PGSQL.5432"
2023-12-01 15:14:10.379 CST [42280] LOG: listening on Unix socket "/tmp/.s.PGSQL.1521"
2023-12-01 15:14:10.410 CST [42283] LOG: database system was shut down at 2023-12-01 15:14:02 CST
2023-12-01 15:14:10.446 CST [42280] LOG: database system is ready to accept connections
done
server started1.3 如果不添加-m参数，则默认为oralce兼容模式
(1)执行初始化数据库命令：/initdb -D ../data
(2)通过./pg_ctl -D ../data start启动数据库。启动后会显示以下内容
2023-12-01 15:14:10.357 CST [42280] LOG: listening on IPv4 address "127.0.0.1", port 5432
2023-12-01 15:14:10.362 CST [42280] LOG: listening on IPv4 address "127.0.0.1", port 1521
2023-12-01 15:14:10.368 CST [42280] LOG: listening on Unix socket "/tmp/.s.PGSQL.5432"
2023-12-01 15:14:10.379 CST [42280] LOG: listening on Unix socket "/tmp/.s.PGSQL.1521"
2023-12-01 15:14:10.410 CST [42283] LOG: database system was shut down at 2023-12-01 15:14:02 CST
2023-12-01 15:14:10.446 CST [42280] LOG: database system is ready to accept connections
done
server started02 -C参数命令设置大小写转换
为了确保PG和Oracle在引用标识符大小写兼容方面的良好体验，IvorySQL提供了三种引用标识符的大小写转换模式以适应不同的场景。
在初始化数据库时，可以通过initdb命令的-C选项来设置大小写转换模式。该选项可以接受的值包括“normal”、“interchange”和“lowercase”。
相关文档链接：
https://docs.ivorysql.org/cn/ivorysql-doc/v3.0/v3.0/16
以下是具体命令的示例：
(1)设置正常大小写转换模式：./initdb -D ../data -C normal 标识符转换模式与原生PG相同。
(2)设置交互大小写转换模式：./initdb -D ../data -C interchange
(3)设置全部转换为小写模式：./initdb -D ../data -C lowercase
如果双引号所引用的标识符中的字母全部为大写，则将大写转换为小写。
测试如下
SET ivorysql.enable_case_switch = true;
SET ivorysql.identifier_case_switch = interchange;
CREATE TABLE "ABD"(c1 int, c2 int);
SELECT * FROM "ABD";
c1 | c2
----+----
(0 rows)
SELECT * FROM "Abd"; -- ERROR
SELECT * FROM "abd"; -- ERROR
DROP TABLE abd;如果双引号所引用的标识符中的字母全部为小写，则将小写转换为大写。
测试如下
SET ivorysql.enable_case_switch = true;
SET ivorysql.identifier_case_switch = interchange;
CREATE TABLE "abd"(c1 int, c2 int);
SELECT * FROM "ABD";-- ERROR
SELECT * FROM "Abd"; -- ERROR
SELECT * FROM "abd";
c1 | c2
----+----
(0 rows)
DROP TABLE abd;如果用双引号引起来的标识符中字母是大小写混合的，则保持标识符不变。
测试如下
SET ivorysql.enable_case_switch = true;
SET ivorysql.identifier_case_switch = interchange;
CREATE TABLE "Abd"(c1 int, c2 int);
SELECT * FROM "ABD"; -- ERROR
SELECT * FROM ABD; -- ERROR
SELECT * FROM abd; -- ERROR
SELECT * FROM Abd; -- ERROR
SELECT * FROM "Abd";
c1 | c2
----+----
(0 rows)
DROP TABLE "Abd";/initdb -D ../data -C lowercase 将所有标识符转换为小写字母。
测试如下
SET ivorysql.enable_case_switch = true;
SET identifier_case_switch = lowercase;
CREATE TABLE "Abd"(c1 int, c2 int);
SELECT * FROM "Abd";
c1 | c2
----+----
(0 rows)
SELECT * FROM ABD; -- ERROR
SELECT * FROM abd; -- ERROR
SELECT * FROM Abd; -- ERROR
DROP TABLE "Abd";
03 \parser命令
在成功连接数据库后，您可以输入SQL语句\parser来查看当前数据库parser信息。具体实例如下：
1、输入\parser后，如果显示Oracle parser，则表明当前处于Oracle parser。
如果想要切换为PG，则输入命令：set ivorysql.comatible_mode=PG，此时客户端仍然处于Oralce parser，需要再次输入命令\parser，此时才能更新parser为PG parser;
2、输入\parser后，如果显示PG parser，则表明当前处于PG parser。
如果想要切换为Oracle，则输入命令：set ivorysql.comatible_mode=Oracle，此时客户端仍然处于PG parser，需要再次输入命令\parser，此时才能更新parser为PG parser;
04 --with-oraport命令
在执行configure时可以加上--with-oraport=number命令，将number设置为服务器和客户端的默认端口。这个端口可以在后续进行修改，但如果在此处声明，则服务器和客户端将具有相同的编译好的默认值，这样会更加方便。
相关文档链接:
https://docs.ivorysql.org/cn/ivorysql-doc/v3.0/v3.0/22
具体示例如下：
./configure CFLAGS="-O0 -g" \
--prefix=$PWD/inst \
--with-oraport=1521 \
......
执行命令：
./initdb -D ../data
./pg_ctl -D ../data start
./psql -d postgres -p 152105 有关配置参数介绍
| 变量名 | 描述 |
| ivorysql.compatible_mode | 表示当前兼容的数据库类型（如PG或Oracle）。您可以通过show命令查看当前的兼容模式。使用set命令更改该变量。使用reset命令重置为连接时的数据库模式。注意reset all可能会影响该变量。 |
| ivorysql.database_mode | 表示当前兼容的数据库类型（如PG或Oracle）。您可以通过show命令查看当前的兼容模式。set、reset、reset all命令并不影响该变量。 |
| ivorysql.datetime_ignore_nls_mask | 表示日期格式是否会受NLS参数影响。默认该变量的值为0，表示日期格式不受NLS参数的影响。您可以通过set命令来设置，reset 命令为重置，reset all命令可能会重置该变量的值。 |
| ivorysql.enable_emptystring_to_NULL | 可以取值为on或off。当该变量设置为on时，插入的空字符串将转为NULL值并存储。 |
| ivorysql.identifier_case_switch | 该变量具有三种模式：“normal”，“interchange”以及“lowercase”，默认设置为“interchange”。该变量用于设置字符大小写转换的模式。 |
| ivorysql.listen_address | 表示兼容模式监听的地址。在初始化数据库时，将从ivorysql.conf文件中读取该配置。如果在配置文件中修改该值，需要重启数据库才能生效。您可以通过show命令查看当前的监听地址。 |
| ivorysql.port | 表示兼容模式下连接的端口号。在初始化数据库时，将从ivorysql.conf文件中读取该配置。如果在配置文件中修改该值，需要重启数据库才能生效。您可以通过show命令查看当前的链接端口号。 |
| nls_date_format | 表示默认的日期格式，您可以通过show命令查看当前的默认日期格式，默认为‘YYYY-MM-DD’。您可以通过set命令设置默认日期格式，通过reset命令重置回默认值，reset all 命令可能会重置该变量。 |
| nls_length_semantic | 表示兼容oracle的同名参数，控制一个字符所占内存的大小。 |
| nls_timestamp_format | 表示兼容oracle的同名参数，控制带时间的日期格式。 |
| nls_timestamp_tz_format | 表示兼容oracle的同名参数，控制带时区的日期格式。 |
| shared_preload_libraries | 在初始化数据库时从ivorysql.conf文件中读取，您可以通过show命令查看其设置。该参数主要作用是对liboracle_parser和ivorysql_ora进行预加载。 |
官方网址：
https://www.ivorysql.org
社区仓库：
https://github.com/IvorySQL/IvorySQL
IvorySQL社区欢迎并赞赏所有类型的贡献，期待您的加入！
记得在GitHub给我们一个 ⭐奥~
