Linux平台达梦数据库V7之disql工具使用详解

一 前言

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>

2. 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/[email protected]: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
   SET

   Sets 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 value

     where 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 DIR

     5.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/[email protected]:5236 c:\a.sql。<br/>如果在 linux 环境下使用，&lt;start&gt;外需要加上单引号，如：'" <file_path >"'。
     注意：
     <start> 命令 中：<` 运行脚本>在 既可以在 DIsql 启动时使用，也可以在进入 入 DIsql 界面之后使用。而<start 运行脚本>入 只能在进入 DIsql 界面之后才能使用。