disql是DM 数据库的一个命令行客户端工具，用来与DM数据库服务器进行交互。disql是DM数据库自带的工具，只要安装了DM数据库，就可以在应用菜单和安装目录中找到。其功能类似于oracle的sqlplus。
当然，如果对命令不熟悉的，也可以通过图形界面的DM管理工具进行操作。
二 disql入门
2.1 启动disql
为了使用 DIsql，必须首先要启动 DIsql。DIsql 工具可以广泛用于各种操作系统，如 WINDOWS、LINUX 等。
启动之后，当出现“SQL>”符号时，用户就可以利用 DM 提供的 SQL 语句和数据库进行交互操作了，需要注意的是，在 DIsql 中 SQL 语句应以分号“;”结束。对于执行语句块，创建触发器，存储过程，函数，包，模式等时需要用“/”结束。
Disql的启动有两种方式：
1.winodws平台
1）通过开始菜单中的SQL交互式查询工具启动；
2）通过$DM_HOME\bin\disql.exe启动（需要配置环境变量PATH）。
2.linux平台
1）通过桌面快捷方式中SQL交互式查询工具启动；
2）通过$DM_HOME/bin/disql启动（需要配置环境变量PATH）。
[dmdba@dm3 IESDB]$ disql sysdba/SYSDBA
服务器[LOCALHOST:5236]:处于普通打开状态
登录使用时间: 50.277(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>
2.2 切换登录
用户进入 DIsql 界面后，如果想切换到其他 DM 数据库实例。有两种实现方式：一是使用 LOGIN 命令；二是使用 CONN 命令。登录到远程数据库，必须在服务名处使用 IP 地址或网络服务名。
2.2.1 LOGIN /LOGOUT
1.LOGIN登录主库建立会话
直接输入 LOGIN 命令后，屏幕会提示输入登录信息：
SQL> login
服务名:
用户名:
密码:
端口号:
SSL路径:
SSL密码:
MPP类型:
是否读写分离(y/n):
协议类型:
参数说明
服务名：数据库服务名或 IP 地址。LOCALHOST 表示本地服务器。默认为LOCALHOST。
用户名和密码：默认均为 SYSDBA，密码不回显。
端口号：默认为 5236。
SSL 路径和 SSL 密码：用于服务器通信加密，不加密的用户不用设置，缺省为不设置。
UKEY 名称和 UKEY PIN 码：供使用 UKEY 的用户使用，普通用户不用设置，缺省为不使用。
MPP 类型：参见上一节<MPP_TYPE>，MPP 类型是 MPP 登录属性，此属性的设置对非MPP 系统没有影响。此属性的有效值为 GLOBAL 和 LOCAL，默认为 GLOBAL。
是否读写分离(y/n)：默认 n。如果输入 y，会提示：读写分离百分比(0-100)。用户根据需要输入相应的百分比，如果输入的百分比不合法，那就相当于没有设置。
登录成功后会显示登录时间。
SQL> login
服务名:
用户名:
密码:
端口号:
SSL路径:
SSL密码:
MPP类型:
是否读写分离(y/n):
协议类型:
服务器[LOCALHOST:5236]:处于普通打开状态
登录使用时间 :7.629(ms)
SQL>
-
LOGOUT从登录主库注销会话
LOGOUT 命令从登录主库注销会话。断开连接而不退出 DIsql。
SQL> logout三 disql连接数据库的方式
DIsql 是 DM 数据库自带的一个命令行客户端工具，用来与 DM 数据库服务器进行交互。
工具语法如下：
[dmdba@dm3 IESDB]$ disql -h
disql V7.6.0.171-Build(2019.07.02-109059)ENT
DISQL 用法1:disql -h|help 显示disql版本信息和帮助信息
DISQL 用法2:disql [ [<option>] [{<logon> | /NOLOG}] [<start>] ]
<option> 为: [-L] [-S]
-L 只尝试登录一次
-S 隐藏模式，隐藏<SQL>标识符
<logon> 为: {<username>[/<password>][*<MPP_TYPE>][@<connect_identifier>]} | {/ AS <SYSDBA|SYSSSO|SYSAUDITOR|AUTO>}br/><connect_identifier>为{[<server>][:<port>][?{UDP|TCP|IPC|RDMA}][#<sslpath>][@<sslpwd>]}
<server>如果是IPv6的地址，需要用[]指明是IPv6地址,例如[fe80::1e6f:65ff:fed1:3724%6]
<start> : `<filename>[<parameter> ...]<direct sql> 运行disql脚本
/NOLOG 选项能在未登录DM服务器的情况下启动disql
<direct sql>:-e "<SQL语句>[;<SQL语句>]"
关于这些选项的详细解释可以参考DM的官方手册《DM7_disql使用手册》2.1.2.2DIsql 登录方式.3.1 服务端本地连接
在安装达梦服务端本地，可以直接通过disql进行登录，而无须指定IP与端口号(默认为LOCALHOST：5236):
[dmdba@dm3 /]$ disql sysdba/SYSDBA
服务器[LOCALHOST:5236]:处于普通打开状态
登录使用时间: 8.525(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>3.2 指定IP与端口号连接
这种方式类似于oracle数据库的EZCONNECT方式，可以连接任意服务端：
[dmdba@dm3 /]$ disql sysdba/SYSDBA@192.128.1.3:5236
服务器[192.128.1.3:5236]:处于普通打开状态
登录使用时间: 19.260(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>3.3 网络服务名连接
网络服务名的详细信息参考官方文档，本节所指的配置文件为dm_svc.conf，该文件在 Windows 操作平台下此文件位于%SystemRoot%\system32 目录，在 Linux 平台下此文件位于/etc 目录。
官方文档中给出的该文件的配置信息如下：以#开头的行表示是注释
全局配置区
O2000=(192.168.0.1:5000,192.168.0.2:5236)
O3000=(192.168.0.1:5236,192.168.0.3:4350)
TIME_ZONE=(+8:00)
LOGIN_ENCRYPT=(0)
DIRECT=(Y)服务配置区
[O2000]
TIME_ZONE=(+9:00)
LOGIN_MODE=(2)
SWITCH_TIME=(3)
SWITCH_INTERVAL=(10)
需要说明的是，如果对 dm_svc.conf 的配置项进行了修改，需要重启客户端程序，修
改的配置才能生效。
测试如下：
[dmdba@dm3 /]$ cat /etc/dm_svc.conf
TIME_ZONE=(480)
LANGUAGE=(cn)
semiter=(192.128.1.3:5236)
[dmdba@dm3 /]$ disql sysdba/SYSDBA@semiter
服务器[192.128.1.3:5236]:处于普通打开状态
登录使用时间: 5.597(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>
这里需要说明几点：
1.网络服务名不区分大小写；
[dmdba@dm3 /]$ disql sysdba/SYSDBA@semiter
服务器[192.128.1.3:5236]:处于普通打开状态
登录使用时间: 5.597(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL> exit
[dmdba@dm3 /]$ disql sysdba/SYSDBA@SEMITER
服务器[192.128.1.3:5236]:处于普通打开状态
登录使用时间: 4.616(毫秒)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>
2.网络服务名后面可以跟端口号
这一点在非默认端口的情况下需要特别注意，另外对于达梦6的早期版本，不支持指定端口号，也就意味着不支持修改默认端口号。
3 LANGUAGE参数
当前数据库服务器使用的语言，会影响帮助信息错误和提示信息。支持的选项为：CN（表示中文）和 EN（表示英文）。可以不指定，若不指定，系统会读取操作系统信息获得语言信息，建议有需要才指定。
我们之前所执行的查询操作，在disql环境下都是中文显示，这是因为dm_svc.conf文件中LANGUAGE=CN，我们修改为EN测试一下：
[dmdba@dm3 /]$ cat /etc/dm_svc.conf
TIME_ZONE=(480)
LANGUAGE=(en)
semiter=(192.128.1.3:5236)
[dmdba@dm3 /]$ disql sysdba/SYSDBA@SEMITER
Server[192.128.1.3:5236]:mode is normal, state is open
login used time: 4.114(ms)
disql V7.6.0.171-Build(2019.07.02-109059)ENT
SQL>四 disql中的环境变量设置
使用 SET 命令可以对当前 DIsql 的环境变量进行设置。并通过 SHOW 命令来查看当前系统中环境变量的设置情况。
4.1 set命令用法
SET 命令用于设置 DIsql 系统环境变量。
语法如下：
SET <system_variable><value>{ <system_variable><value>}
<system_variable>：变量名称，参考官方文档。
<value>：属性。
可以同时 SET 多个环境变量，如：Set heading on timing on。一旦 SET 之后某个环境变量出错，那么该变量之后的将不再起作用。
SQL> help set
SETSets a system variable to alter the DISQL environment settings
for your current session. For example, to:- set the display width for data
- customize HTML formatting
- enable or disable printing of column headings
-
set the number of lines per page
SET system_variable valuewhere system_variable and value represent one of the following clauses:
NEWP[AGE] {1|n|NONE}
AUTOCOMMIT {OFF|ON}
PAGES[IZE] {14|n}
DEFINE {&|c|ON|OFF}
ECHO {OFF|ON}
FEED[BACK] {6|n|ON|OFF}
HEA[DING] {ON|OFF}
TIMING {OFF|ON}
TIME {OFF|ON}
VER[IFY] {ON|OFF}
LONG {800|n}
LINESIZE {screen_length|n}
SERVEROUT[PUT] {ON | OFF} [SIZE {n}] [FOR[MAT] {WRA[PPED] | WOR[D_WRAPPED] | TRU[NCATED]}]
SCREENBUFSIZE {DEFAULT | n(byte)}
CHAR_CODE {GBK | UTF8 | DEFAULT}
CURSOR {STATIC | FORWARDONLY | DEFAULT}
LINESHOW {ON | OFF}
AUTOTRACE {OFF | NL | INDEX | ON | TRACE}
DESCRIBE [DEPTH {1|n|ALL}] [LINENUM {ON|OFF}] [INDENT {ON|OFF}]
TRIMS[POOL] {ON | OFF}
AUTORECONN {ON | OFF}
LOBCOMPLETE {ON | OFF}
KEEPDATA {ON | OFF}
NEST_COMMENT {ON | OFF}
NULL_ASNULL {ON | OFF}
NULL_SHOW {ON | OFF}
CMD_EXEC {ON | OFF}
COLSEP {| text}
CHARDEL {| text}
FLOAT_SHOW { float_length }4.2 show命令用法
通过使用 SHOW 命令，用户就可以快速而方便的了解到 DIsql 环境的当前环境变量设置。
SHOW 可以显示一个或多个变量。显示多个变量时中间加空格，当其中某一变量出错之后，后面的仍会继续显示。
语法如下：
SHOW <system_variable>{<system_variable>}
<system_variable>:环境变量。
示例如下，显示 HEADING 和 TIMING 两个变量：
SQL> SHOW HEADING TIMING
HEADING ON.
TIMING ON五 disql下常用命令
5.1 help
DIsql 帮助命令，可以帮助用户查看其他命令的具体用法。用户可以看到其他命令系统显示的内容，概括为：
? 命令的标题
? 命令的文本描述
? 命令的简写（例如，AUTO 可以代替 AUTOCOMMIT）
? 可以向命令传递的强制参数和可选参数
HELP 显示指定命令的帮助信息。
语法如下：
HELP|? [topic]
topic：命令名称或者命令名称的首字母，查询某一命令用法或者某一字母开头的所有命令用法。
示例如下 ：
SQL> HELP DEFINE
DEFINE设置变量值，或者显示已定义的变量信息。
DEF[INE] [variable] | [variable = text]5.2 spool
将屏幕显示的内容输出到指定文件。
语法如下：
SPOOL {<file> | OFF }
<file>：：= <file_path> [CRE[ATE]|REP[LACE]|APP[END]]
<file_path>：指定文件的绝对路径
CRE[ATE]：创建指定的文件，若指定的文件已存在，则报错，默认方式
REP[LACE]：创建指定的文件，若指定的文件已存在，则替换它
APP[END]]：将输出内容追加到指定文件的末尾
OFF：关闭 SPOOL 输出
示例如下：
SQL>spoold:\b.sqlCREATE
SQL>select top 5* from sysobjects;
SQL>spool off
先执行上述语句，然后，查看 d:\b.sql 文件。
注意：只有 SPOOL OFF 之后 ，才 能 在输出文件中看到输出的内容。5.3 host
使用 HOST 命令可以不用退出 DIsql 就能执行操作系统命令。如果单独执行 host，则能够直接从 DIsql 界面切换到操作系统，之后可使用 EXIT 回到 DIsql 界面。
语法如下：
HOST[<command>]
<command>：操作系统命令。
示例如下：
SQL>HOST DIR5.4 DESCRIBE
获取表或视图、存储过程、函数、包、记录、类的结构描述。
语法如下：
DESC[RIBE] <table>|<view>|<proc>|<fun>|<pkg>|<record>|<class> ;
各对象获取的内容略有不同：
? 表或视图获取的内容包括列名，列数据类型，列是否可以取空值。
? 函数、过程、类获取的内容包括两类：1）存储函数/过程名，类型（函数或过程），函数返回值类型；2）参数名，参数数据类型、参数输入输出属性、参数缺省值。
? 包获取的内容分为两类：1）包内存储函数/过程名，类型（函数或过程），函数返回值类型；2）包内参数名，参数数据类型、参数输入输出属性、参数缺省值。
? 记录获取的内容为：参数名，参数数据类型，参数是否可以取空值。5.5 explain
用 EXPLAIN 命令来查看查询语句的执行计划。
语法如下：
EXPLAIN <sql_clause>
<sql_clause>请参考《DM7_SQL 语言使用手册》。
示例如下：
SQL>EXPLAIN select count(*) from sysobjects;5.6 more
当结果集过多，屏幕只能显示一个时，用户可以使用 MORE 命令切换到下一个结果集。
MORE
例如，当执行如下语句时，用户想查看更多的结果集，可以使用 MORE 命令。
begin
select top 10 from v$dm_ini;
select top 10 from sysobjects;
select * from dual;
end
/5.7 显示SQL语句或块信息LIST
显示最近执行的 SQL 语句或者 PL/SQL 块信息。不显示 DIsql 命令。
LIST 或者 ;五 disql下执行SQL脚本
在第三章开头已经介绍了disql连接数据库的语法，其中有一个参数start，即可以执行sql脚本：
运行 DIsql 脚本文件。
例如，假设a.sql是路径为“c:\”的任意脚本文件DIsql –S SYSDBA/SYSDBA@192.128.1.3:5236c:\a.sql。<br/>如果在 linux 环境下使用，<start>外需要加上单引号，如：‘" <file_path >"‘。
注意：
<start> 命令 中：<` 运行脚本>在 既可以在 DIsql 启动时使用，也可以在进入 入 DIsql 界面之后使用。而<start 运行脚本>入 只能在进入 DIsql 界面之后才能使用。