SQL Relay学习笔记（5）

SQL Relay运行

启动

使用sqlr-start开启SQL Relay服务器进程

sqlr-start[-id ID][-config CONFIGFILE][-localstatedir LOCALSTATEDIR]

带参数-id执行时，会为配置文件中名为ID的instance启动一个sqlr-listener实例，一个sqlr-scaler实例和一定数量的sqlr-connection。
不带参数-id执行执行时，会为每一个enabled参数为“yes”的instance启动适当数量的sqlr-listener，sqlr-scaler，sqlr-connection。
-config参数指定要使用的配置文件的文件名，或多个配置文件所在的文件夹，或远程配置文件的URL，或者上述三者的集合（每一项之间逗号隔开）。
-localstatedir参数用于将本地情况目录传递给由sqlr-start启动的程序。

---

停止

使用sqlr-stop停止正在运行的SQL Relay服务器。

sqlr-stop[-id ID]

带参数-id执行时，停止指定ID的SQL Relay服务器进程，
不带参数-id执行时，停止所有的SQL Relay服务器进程。

---

使用命令行接口

SQL Relay提供多种命令行使用方法，常见的命令有sqlrsh，sqlr-export，sqlr-import，其语法为：

sqlrsh -host HOST -port PORT -socket SOCKET -user USER -password PASSWORD [-script SCRIPT | -command COMMAND] [-quiet] [-format plain|csv] [-resultsetbuffersize rows]

sqlr-export -host HOST -port PORT -socket SOCKET -user USER -password PASSWORD (-table TABLE | -sequence SEQUENCE) > exportfile.xml

sqlr-import -host HOST -port PORT -socket SOCKET -user USER -password PASSWORD -file exportfile.xml

如果有客户端能读到的配置文件则命令中的-host,-port,-socket,-user,-password可以省略，并用-id ID [-config CONFIGFILE]替代：

sqlrsh -id ID [-config CONFIGFILE] [-script SCRIPT | -command COMMAND] [-quiet] [-format plain|csv] [-resultsetbuffersize rows]

sqlr-export -id ID [-config CONFIGFILE] (-table TABLE | -sequence SEQUENCE) > exportfile.xml

sqlr-import -id ID [-config CONFIGFILE] -file exportfile.xml

sqlrsh是一个交互请求工具，类似于splplus，mysql，psql等等，help;指令可以获取帮助和细节用法。sqlrsh读取并执行两个rc文件，分别为系统rc(通常位于 /usr/local/firstworks/etc/sqlrshrc) 和私有rc(通常位于home目录下，后缀为.sqlrshrc)，这些文件应当包含sqlrsh指令并以花括号分隔，分号结尾。
-script参数会运行脚本并结束sqlrsh。
-command参数会执行命令（或命令序列，分号隔开）并结束sqlrsh。
sqlr-export将指定的表和序列导入文件。
sqlr-import读取指定的文件并导入数据。该命令不创建表或序列，只是将数据导入已有的。
sqlr-export和sqlr-import命令可以搭配使用，即使两个数据库类别不相同，只要表结构相匹配，就完成数据从一个数据库到另一个数据库的迁移。

Windows环境下，将”安装目录/Firstworks/bin”添加到环境变量即可。

---

使用状态监视器

使用sqlr-status命令可以显示正在运行的SQL Relay服务器的状态。

sqlr-status -id ID

输出样式通常如下：

Open   Database Connections:  0  Opened Database Connections:  394  Open   Database Cursors:      0  Opened Database Cursors:      2286  Open   Client Connections:    0  Opened Client Connections:    394  Times  New Cursor Used:       267  Times  Cursor Reused:         2571  Total  Queries:               3542  Total  Errors:                1  Forked Listeners:             0Scaler's view:  Connections:                  0  Connected Clients:            0Mutexes:  Connection Announce               : acquired     (1)  Shared Memory Access              : acquired     (1)  Connection Count                  : acquired     (1)  Session Count                     : acquired     (1)  Open Connections/Forked Listeners : acquired     (1)Triggers:  Accept Available Connection (l-w, c-s)         : not triggered (0)  Done Accepting Available Connection (c-w, l-s) : not triggered (0)  Evaluate Connection Count (s-w, l-s)           : not triggered (0)  Done Evaluating Connection Count (l-w, s-s)    : not triggered (0)  Connection Has Started (s-w, c-s)              : not triggered (0)Counts:  Busy Listener Count : 0Raw Semaphores:  +---------------------------------------------+  | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 |  10 |  +---+---+---+---+---+---+---+---+---+---+-----+  | 1 | 1 | 0 | 0 | 1 | 1 | 0 | 0 | 0 | 1 |   0 |  +---------------------------------------------+

Open Database Connections: 当前开启的数据库连接数
Opened Database Connections: 自此instance启动以来，已经开启过的数据库连接数总额
Open Database Cursors: 当前开启的数据库光标
Opened Database Cursors: 自此instance启动以来，已经开启过的数据库光标数总额
Open Client Connections: 当前被SQL Relay服务器端链接的客户端总数
Opened Server Connections: 自此instance启动以来，已经连接过此instance的SQL Relay客户端总额
Times New Cursor Used: 既有光标不可被重用的次数
Times Cursor Reused: 既有光标可被重用的次数
Total Queries: 此instance已经处理过的请求总数
Total Errors: 报错的请求数
Forked Listeners: 正在运行的自监听器进程总数，与等待连接数据库的客户端数目有关