一、功能简介
本文档主要介绍如何使用 DM 的命令行交互式工具 DIsql，以及它作为数据库访问工具所提供的功能。
DIsql 是 DM 数据库的一个命令行客户端工具，用来与 DM 数据库服务器进行交互。DIsql 是 DM 数据库自带的工具，只要安装了 DM 数据库，就可以在应用菜单和安装目录中找到。
DIsql 识别用户输入，将用户输入的 SQL 语句打包发送给 DM 数据库服务器执行，并接收服务器的执行结果，并按用户的要求将执行结果展示给用户。为了更好地与用户交互和展示执行结果，用户也可以在 DIsql 中执行 DIsql 命令，这些命令由 DIsql 工具自身进行处理，不被发送给数据库服务器。
SQL 语句在 DIsql 中执行完后都被保存在一个特定的内存区域中，用户可以通过上下键查找到这些保存在内存中的 SQL 语句（某些操作系统可能不支持此操作），并可以进行修改，然后再次执行。DIsql 命令执行完后不保存在内存区域中。
二、disql 入门
2.1 启动 disql
为了使用 DIsql，必须首先要启动 DIsql。DIsql 工具可以广泛用于各种操作系统，如 WINDOWS、LINUX 等。
启动之后，当出现 “SQL>” 符号时，用户就可以利用 DM 提供的 SQL 语句和数据库进行交互操作了，需要注意的是，在 DIsql 中 SQL 语句应以分号 “;” 结束。对于执行语句块，创建触发器、存储过程、函数、包以及模式等时需要用 “/” 结束。
2.1.1 在 windows 系统中启动 disql
windows 环境下，有两种启动 DIsql 的方式。第一种是启动安装软件后生成的程序菜单，第二种是启动安装目录下自带的 DIsql 工具。
2.1.1.1 程序菜单启动
如果在 WINDOWS 环境中安装了 DM 数据库产品，那么可以在应用菜单中找到 SQL交互式查询工具，直接双击即可启动。然后使用 LOGIN 或 CONN 命令登录到指定数据库。LOGIN 或 CONN 命令下文有详细介绍。
以 LOGIN 为例，登录到 IP 地址为 192.168.1.150 的机器上，用户名和密码为：SYSDBA/SYSDBA，端口号为 5236。其他全部敲回车，采用缺省输入。密码不会回显到屏幕上。
也可以全部直接回车，采用缺省输入，登录到本地 DM 数据库。缺省值请参考下文 LOGIN 命令。
2.1.1.2 自带 disql 工具启动
DIsql 工具位于 DM 数据库安装目录的 bin 子目录下，例如 DM 数据库的安装目录为 D:\dmdbms，则 DIsql 位于 D:\dmdbms\bin\DIsql.exe。双击启动，然后输入用户名、密码，就可登录到本地 DM 数据库实例。密码不会回显到屏幕上。也可以全部直接回车，采用缺省输入，缺省值为 SYSDBA/SYSDBA。
如果后续操作想登录到其他 DM 数据库实例，可使用 LOGIN 或 CONN 命令。
2.1.2 命令行启动 disql
命令行启动 DIsql 适用于任何操作系统平台。下面以 WINDOWS 系统为例。
2.1.2.1 命令行启动
从命令行启动 DIsql 并登录到数据库。在命令行工具中找到 DIsql 所在安装目录 D:\dmdbms\bin，输入 DIsql 和登录方式后回车。登录方式在下一节详细介绍。
登录界面如下：
2.1.2.2 disql 登录方式
DIsql 的登录方式。
语法如下：
DIsql 用法1：disql –h | help 显示disql版本信息和帮助信息 DIsql 用法2：disql [ [<option>] [<logon> |{/NOLOG}] [<start>] ] <option>::=[-L] [-S] <logon>::={{<username>[/<password>]} | /}[@<connect_identifier>][<logon_option>] [<os_auth>] <connect_identifier> ::=<svc_name> | {<host>[:<port>]} | <unixsocket_file> <logon_option>::=<option_no_esc>|<option_esc> <option_no_esc >::= #{ <extend_option>=<value>{,<extend_option>=<value>} } //此行外层{}是为了封装参数之用，书写时需要保留 <option_esc>::= # "{ <extend_option>=<value>{,<extend_option>=<value>} } " //此行外层"{}"是为了封装参数之用，书写时需要保留 <os_auth>::= AS {SYSDBA|SYSSSO|SYSAUDITOR|USERS|AUTO} <start>::=<`运行脚本>|<start运行脚本>|<直接执行语句>|<直接执行SET命令> <`运行脚本>::=`<file_path> [<PARAMETER_VALUE>{ <PARAMETER_VALUE>}] <start运行脚本>::=START <file_path> [<PARAMETER_VALUE>{ <PARAMETER_VALUE>}] <直接执行语句>::= -E "<SQL语句>{;<SQL语句>}" <直接执行设置DIsql属性命令>::= -C "<SET命令 | COLUMN命令>"
建议
文中语法符号规定：<> 内的内容是必选项；
[] 内的内容是可选项；{} 内的内容可以出现一次或多次；
| 为或者；::= 为定义符。后文语法用法与此相同。
-h|help： h 或 help 表示显示 DIsql 版本信息和帮助信息。
[-L] [-S]：-L 表示只尝试登录一次；-S 表示设置 DIsql 界面为隐藏模式，隐藏 <SQL> 标识符。
{{<username>[/<password>]} | /}：<username>[/<password>] 为用户名和密码。普通登录方式时用户名必写，密码缺省为 SYSDBA。/ 表示采用操作系统身份验证方式登录，此时无需指定用户名和密码，即使指定也会被忽略。如果 <password > 中含有特殊字符，因为特殊字符在操作系统中需要被特殊处理，因此特殊字符书写的时候需要按照要求的格式。本节末尾会针对包含特殊字符的 <password > 如何书写，进行详细介绍。
<svc_name>： 服务名。服务名在 dm_svc.conf 中配置。dm_svc.conf 的配置请参考《DM8 系统管理员手册》。例如：在 dm_svc.conf 中配置服务名 dmsvc =(192.168.1.150:5236, 192.168.1.150:5237)。然后就可以使用服务名登录了：DIsql SYSDBA/SYSDBA@dmsvc。使用服务名的好处是第一个 IP 连不通，会自动连接下一个。
<host>[:<port>]： 服务器 IP 地址和端口号。缺省情况下默认为本地服务器和端口号 LOCALHOST:5236。当服务器为本机时，SERVER:PORT 可直接写 LOCALHOST。当连接其他服务器时，SERVER:PORT 需写上 IP 地址和 PORTNUM，例如：192.168.0.248:8888。<host> 如果是 IPv6 的地址，需要用 [] 指明是 IPv6 地址，例如 [fe80::1e6f:65ff:fed1:3724%6]。
<unixsocket_file>： 专门用于在 LINUX 系统中，当服务器与客户端之间使用 UNIXSOCKET（UNIX DOMAIN SOCKET – IPC）协议通信时，指定客户端连接的 socket 文件路径。例如：
./disql SYSDBA/SYSDBA@/data/sdb/DAMENG/foo.sock#{inet_type=UNIXSOCKET}
<logon_option>：为扩展选项，包括 <option_no_esc> 和 <option_esc > 两种书写方式，两种方式除了书写封装符号 #{} 和 #”{ }” 不同，其他一样。<option_no_esc> 适用于 Window 环境和一个 Linux 环境特殊情况（只包含一个扩展选项的情况，例如：#{inet_type=tcp}）。<option_esc> 适用于 Windows 和 Linux 环境。<extend_option>=<value > 中所有 value 值不能包含空格，不能包含特殊的符号，如引号等。现支持的扩展选项 <extend_option> 如下：
| extend_option | value |
| mpp_type | MPP 登录属性，此属性的设置对非 MPP 系统没有影响。取值 GLOBAL 和 LOCAL，默认为 GLOBAL。GLOBAL 表示 MPP 环境下建立的会话为全局会话，对数据库的导入导出操作在所有节点进行；LOCAL 表示 MPP 环境下建立的会话为本地会话，对数据库的导入导出操作只在本地节点进行 |
| inet_type | 网络通信协议类型。取值 TCP/UDP/IPC/UNIXSOCKET/RDMA，缺省为 TCP。 TCP：传输控制协议，是一种面向连接的、可靠的、基于字节流的传输层通信协议； UDP：用户数据报协议，是一种面向数据报的、不可靠的、可快速传输的传输层通信协议，和 TCP 协议互为补充。若应用程序对可靠性的要求较低，对传输性能要求较高，则可以选择 UDP 通信协议。使用 UDP 通信协议时，服务器需要设置 INI 参数 ENABLE_UDP 非 0； IPC：基于共享内存的通信协议，用于同一台主机的进程间通讯。使用 IPC 协议连接数据库时会忽略 IP 地址和端口号，直接连接本机上 INI 参数 ENABLE_IPC=1 的服务器，一台机器上只能有一个服务器设置 ENABLE_IPC=1； UNIXSOCKET：与 IPC 协议类似，同样用于同一台主机的进程间通讯。仅 LINUX 环境下支持 UNIXSOCKET 通信协议。使用 UNIXSOCKET 通信协议时，无需指定 IP 地址和端口号，但服务器需要配置 INI 参数 UNIX_SOCKET_PATHNAME 指定 socket 文件路径，客户端连接服务器时也需要指定 socket 文件路径，二者必须一致； RDMA：远程直接数据存取协议，通过网络将数据从一个系统快速移动到远程系统的存储器中，大大降低计算机处理性能的损耗。使用 RDMA 协议需要安装并配置 RDMA 网卡。使用 RDMA 协议连接数据库时需要指定 RDMA 网卡配置的 IP 地址以及服务器的端口号 |
| ssl_path | 通信加密的 SSL 数字证书路径，缺省为不使用加密。数字证书路径由用户自己创建，将相应的证书需放入该文件夹中。其中服务器证书必须与 dmserver 目录同级，客户端目录可以任意设置。和 ssl_pwd 一起使用。 各用户只能使用自己的 SSL 数字证书，例如 SYSDBA 账户只能使用 \bin\CLIENT_SSL\SYSDBA 下的证书和密码，如果证书没有密码可以用缺省或任意数字代替。 例如：./disql SYSDBA/SYSDBA@192.168.1.64:5236#"{ssl_path= /home/dmdbms/bin/client_ssl/SYSDBA,ssl_pwd=12345}" |
| ssl_pwd | 通信加密的 SSL 数字证书密码。和 ssl_path 一起使用。缺省为不加密 |
| proxy_client | 被代理的用户名。 例如：现创建用户 USER1 和 USER2，其中用户 USER1 为被代理用户，其用户名和密码为 USER1/123456789。用户 USER2 为代理用户，其用户名和密码为 USER2/123456789。 CREATE USER USER1 IDENTIFIED BY 123456789; GRANT DBA TO USER1; CREATE USER USER2 IDENTIFIED BY 123456789; GRANT DBA TO USER2; 执行以下语句，赋予用户 USER2 代理用户 USER1 权限，使用户 USER2 可以认证登录用户 USER1。 ALTER USER USER1 GRANT CONNECT THROUGH USER2; 然后，使用代理用户 USER2 的用户名和密码就能登录被代理用户 USER1 的数据库，以下语句通过 proxy_client 参数给定了被代理用户的用户名。 ./disql USER2/123456789@192.168.100.174:3400#"{inet_type=tcp,proxy_client=USER1}" |
| gwdsn | 指定达梦数据库互联透明网关软件 DMGateway 代理数据源，Disql 发送的消息将通过 DMGateway 转发至远程服务器。 例如：./disql SYSDBA/SYSDBA@192.168.1.64:5236#{gwdsn=dsn_dm} SYSDBA/SYSDBA@192.168.1.64:5236 用于连接 DMGateway 服务器，dsn_dm 表示 DMGateway 将要连接的远程服务器配置项 |
| ukey_name | UKEY 登录验证的 UKEY 名 |
| ukey_pin | UKEY 登录验证时的 UKEY 密钥 |
例如，一个包含 <login_option> 扩展选项的例子。
./disql SYSDBA/SYSDBA@192.168.1.64:5236#"{mpp_type=local,inet_type=tcp}"
AS <SYSDBA|SYSSSO|SYSAUDITOR|USERS|AUTO>：操作系统身份验证。用户可以通过将操作系统用户加入到操作系统的 dmdba|dmsso|dmauditor 用户组来使用操作系统用户登录数据库，分别对应数据库的 SYSDBA|SYSSSO|SYSAUDITOR 用户。还可以通过将操作系统用户加入到操作系统的 dmusers 用户组来使用操作系统用户登录数据库，对应数据库的同名用户。AUTO 表示按顺序自动匹配数据库用户类型。操作系统身份验证无需输入用户名和密码，若输入用户名和密码将会被忽略。关于操作系统身份验证的更多详细介绍请参考手册《DM8 安全管理》。也可参考本站文章 DM 数据库本机操作系统认证登录。
/NOLOG：表示在未登录 DM 服务器的情况下启动 disql。此时可以进行 DIsql 的显示设置和本地变量操作。如果没有 / NOLOG 选项必须登录服务器，不带参数的时候提示输入用户名和密码，此时的用户名和密码用法参考 <logon>。且登录三次失败后退出 DIsql。
注意
<` 运行脚本> 既可以在 DIsql 启动时使用，也可以在进入 DIsql 界面之后使用。
而 <start> 只能在进入 DIsql 界面之后才能使用。故
bash 脚本中 disql 执行 SQL 脚本只能用 <` 运行脚本> 方式，不能用 < start>。
<` 运行脚本>：`符号运行 sql 脚本文件。在登录时运行脚本，如果运行脚本使用了参数或运行脚本路径 file_path 中有空格等特殊符号，需要给整个运行脚本加上双引号”<` 运行脚本>”，在 Linux 环境下则需要加上单引号’<` 运行脚本 >’。<file_path> 是运行的 sql 脚本文件的路径，建议使用绝对路径。例如：e:\a.sql 为包含了一条 select * from dual; 语句的脚本文件。
案例：disql 执行脚本报错：The script file is not complete,last sql has not been executed.
可能的原因：
- 文件末尾未加上符号 “/”。
- 疑似文件编码问题。有可能从 liunx 到 windows 平台之间 拷贝复制，字符转换过程，导致文件中字符编码转换识别问题。将文件从 Notepad++ 复制粘贴一下就可以解决。
注意
Disql 可使用的脚本文件大小上限为 2G。
<PARAMETER_VALUE>：传给 <file_path> 脚本文件中本地变量的参数值，将其中的参数内容传给变了 & 1，&2，&3… 以此类推。例如：e:\b.sql 为包含了一条 select name,type from V$PARAMETER where name=’&1′; 语句的脚本文件。
SQL> start E:\b.txt CTL_PATH SQL> select name,type from V$PARAMETER where name='&1';
执行结果如下：
原值 1:select name,type from V$PARAMETER where name='&1'; 新值 1:select name,type from V$PARAMETER where name='CTL_PATH'; 行号 NAME TYPE ---------- -------- --------- 1 CTL_PATH READ ONLY
<start 运行脚本>：使用 START 命令运行 sql 脚本文件。<file_path> 和 <PARAMETER_VALUE> 的用法和 <` 运行脚本 > 相同。例如：
SQL> start e:\a.sql
<直接执行语句>：使用 - E 参数，将在运行 DIsql 时直接执行后续的一条或多条 SQL 语句，查询结果不显示行号、执行时间以及执行号等信息，且不受 - C 参数控制。例如：
disql SYSDBA/SYSDBA -E "SELECT TOP 1 * FROM SYSOBJECTS; SELECT TOP 1 * FROM V$CMD_HISTORY"。
案例：
在 - E 中的 SQL，如果包含 “$” 的系统视图，需要将 “$” 进行转义才能正常执行，例如：“\$INSTANCE”。而且，如果从 root 用户直接执行 SQL 时，转义符 “\” 本身也需要转义，所以就要使用三个转义符，例如：su – dmdba -c “disql /as sysdba -E \”SELECT * FROM V\\\$INSTANCE;\””
<直接执行 SET 命令>： 使用 - C 参数，将在运行 DIsql 时直接执行后续的 SET 命令。例如：
disql SYSDBA/SYSDBA -C "SET LONG 1000 PAGESIZE 0"。
注意
<password> 比较特殊，因为 <password > 会用到各种特殊字符。特殊字符在操作系统中需要被特殊处理。不同操作系统，书写方式不同。
<password> 中特殊字符的书写规范：
1. 不同操作系统
1) WINDOWS 系统
- DIsql 的关键字符，DIsql 的要求对连接串的特殊字符需要使用双引号括起来”aaaa/aaaa”，操作系统的要求需要再在最外加双引号和转义”””aaaa/aaaa”””。例如：用户名为 user01，密码为 aaaa/aaaa，那么连接串要写成：disql user01/”””aaaa/aaaa”””。
- 空格，需要使用双引号括起来作为一个整体（这是操作系统的要求）。例如：用户名为 user01，密码为 aaaa aaaa ，那么连接串要写成：disql user01/”aaaa aaaa”。
- 双引号，DIsql 要求对双引号需要使用双引号括起来，同时双引号需要转义”aaaa””aaaa”；操作系统要求再对双引号转义和最外层加双引号”””aaaa””””aaaa”””。例如：用户名为 user01，密码为 aaaa”aaaa ，那么连接串要写成：disql user01/”””aaaa””””aaaa”””。
2) LINUX 系统
LINUX 环境下，密码中的特殊字符处理过程既要考虑操作系统的要求，又要考虑 DIsql 的要求。
首先，操作系统的要求。
bash 的引号设计为：在单引号中，所有的特殊字符都失去其特殊含义；在双引号中，特殊字符包括：美元符 ($)、反引号 (`)、转义符 (\)、感叹号 (!）。
如果密码中没有单引号，则在密码外层加单引号即可；如果密码中只有单引号，那么需要在密码外层加双引号；如果既有单引号又有美元符（$）、反引号（`）或转义符（\）特殊字符，那么需要在密码外层加双引号，同时在特殊字符前加 \ 转义；如果既有单引号又有感叹号（!），那么需要在密码外层加双引号，同时在！前加 \ 转义然后使用双引号括起来，即写为”\!”。例如：
‘aaaa\aaaa’ 传给 disql 为 aaaa\aaaa。
“aaaa’aaaa” 传给 disql 为 aaaa’aaaa。
“aaa’\$aaaa” 传给 disql 为 aaa’$aaaa。
“aaaa'”\!”aaaa” 传给 disql 为 aaaa’!aaaa。
其次，在操作系统要求的基础上，增加 DIsql 对关键字和双引号的要求。
- DIsql 的关键字符，DIsql 的要求对连接串的特殊字符需要使用双引号括起来。例如：密码为 aaaa\aaaa，使用双引号括起来”aaaa\aaaa”，因为此密码中不含有单引号，根据操作系统的要求直接在最外面加单引号。例如：用户名为 user01，密码为 aaaa/aaaa，那么连接串要写成：./disql user01/'”aaaa/aaaa”‘。
- 双引号，DIsql 要求对双引号需要使用双引号括起来，同时双引号需要转义。例如：密码为 aaa”\aaaa，那么根据 DIsql 的要求加双引号同时转义为”aaa””\aaaa”，因为没有单引号，根据操作系统的要求直接加单引号。例如：用户名为 user01，密码为 aaa”\aaaa，那么连接串要写成：./disql user01/'”aaa””\aaaa”‘。
- 单引号，根据操作系统的要求，只能将单引号放入双引号中。例如：用户名为 user01，密码为 aaaa’aaaa，那么连接串要写成：./disql user01/”aaaa’aaaa”。
- 单引号 + 操作系统下的美元符（$）、反引号（`）或转义符（\）特殊字符，根据操作系统的要求，因为单引号只能放在双引号内，同时双引号中还有一些特殊字符不能被识别需要加反斜杠转义。例如：用户名为 user01，密码为 aaa’$aaaa，使用双引号将密码括起来，同时对 $ 加反斜杠转义。那么连接串要写成：./disql user01/”aaa’\$aaaa”。
- 单引号 + 操作系统下的感叹号（!）特殊字符，根据操作系统的要求，因为单引号只能放在双引号内，同时感叹号需要加反斜杠转义并用双引号括起来。例如：用户名为 user01，密码为 aaa’!aaaa，使用双引号将密码括起来，同时对！加反斜杠转义并额外用双引号括起来。那么连接串要写成：./disql user01/”aaa'”\!”aaaa”。
- 单引号 + 双引号，根据操作系统的要求，单引号需要放在双引号中，在双引号中表示双引号则使用反斜杠转义双引号。例如： 用户名为 user01，密码为 aaa”‘aaaa，根据 DIsql 的要求双引号作为特殊字符，需要使用双引号在括起来，同时使用双引号对双引号转义”aaa””‘aaaa”; 同时考虑操作系统的要求，因为含有单引号，只能将整个密码放入双引号中，同时对双引号使用反斜杠转义，那么连接串要写成：./disql user01/”\”aaa\”\”‘aaaa\””。
2. 如何转义双引号
- DIsql 的要求使用双引号对双引号内的双引号转义。
- WINDOWS 命令行，使用双引号或者反斜杠对双引号内的双引号转义。
- LINUX 命令行，使用反斜杠对双引号内的双引号转义。
2.2 切换登录
用户进入 DIsql 界面后，如果想切换到其他 DM 数据库实例。有两种实现方式：一是使用 LOGIN 命令；二是使用 CONN 命令。登录到远程数据库，必须在服务名处使用 IP 地址或网络服务名。
2.2.1 LOGIN /LOGOUT
在 DIsql 界面中，使用 LOGIN/LOGOUT 命令登录 / 退出远程数据库。
1. LOGIN 登录主库建立会话
直接输入 LOGIN 命令后，屏幕会提示输入登录信息。
服务名：用于连接上服务器的服务名。此处的服务名是一个统称，有三种选择：数据库服务名、IP 地址 [: 端口号]、或 UNIXSOCKET 文件路径名。其中，UNIXSOCKET 文件路径名用法例如：/home/te/foo.sock。服务名缺省的情况下，服务器的 IP 地址为 localhost，localhost 表示本地服务器，端口号为 5236。
用户名和密码：缺省均为 SYSDBA，密码不回显。
端口号：默认为 5236。
SSL 路径和 SSL 密码：用于服务器通信加密，不加密的用户不用设置，缺省为不设置。
UKEY 名称和 UKEY PIN 码：供使用 UKEY 的用户使用，普通用户不用设置，缺省为不使用。
MPP 类型：参见上一节 <MPP_TYPE>，MPP 类型是 MPP 登录属性，此属性的设置对非 MPP 系统没有影响。此属性的有效值为 GLOBAL 和 LOCAL，缺省为 GLOBAL。
是否读写分离（y/n）：缺省为 n。如果输入 y，会提示：读写分离百分比（0-100）。用户根据需要输入相应的百分比，如果输入的百分比不合法，那就相当于没有设置。
协议类型：缺省为 TCP，可选 TCP/UDP/IPC/UNIXSOCKET/RDMA。
登录成功后会显示登录时间。
2. LOGOUT 从登录主库注销会话
LOGOUT 命令从登录主库注销会话。断开连接而不退出 DIsql。
SQL>LOGOUT
2.2.2 CONN[ECT] /DISCONN[ECT]
1. CONN [ECT] 连接
在 DIsql 界面中，使用 CONN [ECT] 命令登录远程数据库。
语法如下：
CONN[ECT] <logon> <logon>::={{<username>[/<password>]} | /}[@<connect_identifier>][<login_option>] [<os_auth>] <connect_identifier> ::=<svc_name> | {<host>[:<port>]} | <unixsocket_file> <login_option>::= <option_no_esc> <option_no_esc >::= #{ <extend_option>=<value>{,<extend_option>=<value>} } //此行外层{}是为了封装参数之用，书写时需要保留 <os_auth>::= AS {SYSDBA|SYSSSO|SYSAUDITOR|USERS|AUTO}
*<*logon> 中更详细的参数介绍请参考 2.1.1.2 自带 DIsql 工具启动。
注意
使用 CONN [ECT] 命令建立新会话时，会自动断开先前会话。
示例如下：
SQL>CONN SYSDBA/SYSDBA@192.168.1.150
2. DISCONN [ECT] 断开连接
DISCONN [ECT]：提交所有修改到服务器，断开连接而不退出 DIsql。与 logout 功能一样。
SQL>DISCONN
2.3 使用 disql
以一个简单的查询例子来说明如何使用 DIsql。只需要输入一条 SQL 语句，回车即可。DIsql 将 SQL 语句发送给 DM 数据库服务器并显示服务器返回的结果。SQL 语句如何书写请参考《DM8_SQL 语言使用手册》。
SQL>select top 5 name,id from sysobjects;
执行结果如下：
行号 NAME ID ---------- ---------- ----------- 1 SYSOBJECTS 0 2 SYSINDEXES 1 3 SYSCOLUMNS 2 4 SYSUSER$ 3 5 SYSCONS 4 已用时间: 0.415(毫秒). 执行号:518.
2.4 退出 disql
使用 EXIT/QUIT 命令，退出 DIsql。
语法如下：
EXIT|QUIT
示例如下：
SQL>EXIT
2.5 SQL 结果集重定向
示例 SQL 脚本
[dmdba@dameng ~]$ cat select.sql SELECT * FROM TEST.MV_CHOUR; exit; /
使用 disql 执行该脚本将结果集重定向到文件中【-S 可以隐藏 <SQL> 标识符】
[dmdba@dameng ~]$ disql -S USERNAME/PASSWORD@IP:PORT \`/home/dmdba/select.sql > sqlresult.txt
注意：
在使用操作系统认证登录方式时，-S 要在 /as sysdba 之前，如下：
disql -S / as sysdba -E “SELECT * FROM V\$INSTANCE;”
2.6 设置异常处理方式 WHENEVER
语法如下：
WHENEVER SQLERROR CONTINUE [ COMMIT | ROLLBACK | NONE ] | EXIT [ SUCCESS | FAILURE | WARNING | n | <variable> | <bindvariable> ] [ COMMIT | ROLLBACK ]
n 和的返回值受限于操作系统，在不同平台下，会有所不同，例如： UNIX 系统只用一个字节来存 code，所以返回值的范围只在 0-255 之间。
示例一：
SQL> whenever sqlerror exit 1 SQL> select c1 from dual; select c1 from dual; 第 1 行附近出现错误[-2111]:无效的列名[C1]. --windows 系统下，输入 echo %ERRORLEVEL%，查看返回值为：1 --linux 系统下，输入 echo $?，查看返回值为：1
示例二：出错后回滚
SQL> `/home/dmdba/sql_test.sql SQL> WHENEVER SQLERROR CONTINUE ROLLBACK SQL> INSERT INTO TEST.SQLERROR VALUES (1,'JSDFKALSJDF'); affect rows 1 used time: 0.555(ms). Execute id is 24900. SQL> INSERT INTO TEST.SQLERROR VALUES (2,'JSDFKALSJDFAJSLFDKJASFJAKSDJFALJFDLKAJDSFL'); INSERT INTO TEST.SQLERROR VALUES (2,'JSDFKALSJDFAJSLFDKJASFJAKSDJFALJFDLKAJDSFL'); [-6169]:Column [NAME] out of length. used time: 0.138(ms). Execute id is 0. SQL> INSERT INTO TEST.SQLERROR VALUES (3,'JDFKAJFKDJD'); affect rows 1 used time: 0.115(ms). Execute id is 24902. SQL> SELECT * FROM TEST.SQLERROR; LINEID ID NAME ---------- ----------- ----------- 1 3 JDFKAJFKDJD used time: 0.114(ms). Execute id is 24903. SQL> EXIT;
经验证，第二条 SQL 报错后执行回滚 ROLLBACK，所以最终只插入了最后一条数据。同理我们可以使用 WHENEVER SQLERROR CONTINUE NONE 来实现出错后继续执行脚本。
三、disql 环境变量设置
3.1 使用配置文件设置环境变量
- disql 在连接成功数据库时会自动运行两个配置文件 glogin.sql 和 login.sql。
- glogin.sql 文件中的设置永久生效 ， 该配置文件需要用户自行创建在
$DM_HOME/bin/disql_conf路径下，其中$DM_HOME为 DM 的安装目录，需要用户在操作系统配置 DM_HOME 环境变量，disql_conf 目录需要用户自行创建。 - login.sql 文件为用户自定义配置文件，对其存放路径不做限制。
- glogin.sql 文件中的设置永久生效 ， 该配置文件需要用户自行创建在
glogin.sql 文件和 login.sql 文件的执行顺序如下：
- 默认在 $DM_HOME/bin/disql_conf 路径下查找 glogin.sql 文件并执行；
- 默认在当前工作目录下（注意不是 DIsql 工具所在的目录，而是启动 DIsql 时所在的目录）查找 login.sql 文件并执行，若未找到则执行步骤 3；
- 判断操作系统是否配置了 DM_SQLPATH 环境变量，如果配置了该变量则在对应路径下查找 login.sql 文件并执行。
DIsql 执行上述配置文件时并不会在 DIsql 窗口打印信息，如果没有找到上述配置文件则忽略。
示例 - 通过 login.sql 设置环境变量
（1）配置操作系统环境变量.bash_profile 文件
#disql export DM_SQLPATH=/home/dmdba/config
使其生效
. .bash_profile
（2）配置 login.sql 文件 /home/dmdba/config/login.sql
set heading off set pagesize 3
登录数据库验证环境变量是否生效
[dmdba@shine ~]$ disql /@localhost:5237 as sysdba Server[localhost:5237]:mode is normal, state is open login used time : 4.319(ms) disql V8 SQL> select * from test.course; 1 1 中国马克思主义与当代 路新翔 2 2 学术综合英语 汤惜婵 3 3 学术英语写作与交流 盛柳璐 4 4 自然辩证法概论 邢圣华 5 5 公共体育 冉蓝贤 6 6 新时代中国特色社会主义理论与实践 成彤绮 7 7 智能数据分析与实践 潘杉中 8 8 人工智能知识素养 黄山麟 9 9 Python程序设计 杜子墨 10 10 矩阵论 覃雨桐
验证环境变量的确生效。
附录 disql 常用环境变量
用 SET 命令设置环境变量，格式：set [变量名称] on|off
| 变量名称 | 属性 | 用途 |
| AUTO[COMMIT] | ON|OFF (缺省值) | 设置自动提交 |
| DEFINE | c (默认的变量前缀是 &)|ON (缺省 值)|OFF | 定义本地变量 |
| ECHO | ON (缺省值)|OFF | 显示脚本中正在执行的 SQL 语句 |
| FEED[BACK] | 6 (缺省值)|n|ON|OFF | 显示当前 SQL 语句查询或修改的行数 |
| HEA[DING] | ON (缺省值)|OFF | 显示列标题 |
| LINESHOW | ON (缺省值)|OFF | 显示行号 |
| PAGES[IZE] | SET PAGES [IZE] <14（缺省值）|n> | 设置一页有多少行数。 |
| TIMING | ON (缺省值)|OFF | 显示每个 SQL 语句花费的执行时间 |
| LONG | 800 (缺省值)|n | 设置大字段类型显示的最大字节数 |
| LINESIZE | screem_length (缺省值，屏幕宽度)|n | 设置屏幕上一行显示宽度 |
| SERVEROUT[PUT] |
ON | OFF (缺省值) [SIZE 20000 (缺省值)|n] [FOR[MAT] WRA[PPED] | WOR [D_WRAPPED](缺省值) | TRU[NCATED]] |
在块中有打印信息时，是否打印，及打印的格式 |
| TRIMS[POOL] | OFF (缺省值)|ON | 设置 spool 文件中每行的结尾空格 |
| COLSEP | text | 设置列之间的分割符。缺省为一个空格 |
官方文档地址
https://eco.dameng.com/document/dm/zh-cn/pm/getting-started-disql.html
