DM达梦数据库DIsql入门学习

DIsql 是 DM 数据库的一个命令行客户端工具，用来与 DM 数据库服务器进行交互。DIsql 是 DM 数据库自带的工具，只要安装了 DM 数据库，就可以在应用菜单和安装目录中找到。

这里主要介绍使用DIsql的开启及登录方法，SQL语句部分在这不做详细介绍。

1 启动 DIsql

启动之后，当出现“SQL>”符号时，即说明DIsql启动成功，可以利用DM提供的SQL语句和数据库进行交互操作了。

1.1 在 windows 系统中启动 DIsql

windows 环境下，有两种启动 DIsql 的方式。第一种是启动安装软件后生成的程序菜单，第二种是启动安装目录下自带的 DIsql 工具。

1.1.1 程序菜单启动

如果在 WINDOWS 环境中安装了DM数据库产品，那么可以在应用菜单中找到SQL交互式查询工具，直接双击即可启动。然后使用 LOGIN 或 CONN 命令登录到指定数据库。LOGIN 或 CONN 命令下文有详细介绍。

以 LOGIN 为例，登录到 IP 地址为 192.168.1.150 的机器上，用户名和密码为：SYSDBA/SYSDBA，端口号为 5236。其他全部敲回车，采用缺省输入。密码不会回显到屏幕上。

图1 菜单启动登录界面

也可以全部直接回车，采用缺省输入，登录到本地DM数据库。缺省值请参考下文LOGIN命令。

1.1.2 自带 DIsql 工具启动

DIsql 工具位于 DM 数据库安装目录的 bin 子目录下，例如DM数据库的安装目录为 D:\dmdbms，则 DIsql 位于 D:\dmdbms\bin\DIsql.exe。双击启动，然后输入用户名、密码，就可登录到本地 DM 数据库实例。密码不会回显到屏幕上。也可以全部直接回车，采用缺省输入，缺省值为 SYSDBA/SYSDBA。

图2 自带 DIsql 工具登录界面

如果后续操作想登录到其他 DM 数据库实例，可使用 LOGIN 或 CONN 命令。

1.2 命令行启动 DIsql

命令行启动 DIsql 适用于任何操作系统平台。下面以 WINDOWS 系统为例。

1.2.1 命令行启动

从命令行启动 DIsql 并登录到数据库。在命令行工具中找到 DIsql 所在安装目录 D:\dmdbms\bin，输入 DIsql 和登录方式后回车。登录方式在下一节详细介绍。

登录界面如下：

图3 命令行启动登录界面

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>][<option>] [<os_auth>] <connect_identifier> ::=<svc_name> | {<host>[:<port>]} | <unixsocket_file><option>::= ##{ <exetend_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语句>}”<直接执行SET命令>::=-C “<SET命令>”

-h|help：h或help表示显示DIsql版本信息和帮助信息。

*[-L] [-S]**：-L 表示只尝试登录一次；-S表示设置DIsql界面为隐藏模式，隐藏<*SQL>标识符。

**{{*<*username>[/*<*password>]} | /}**：*<*username>[/*<*password>]为用户名和密码。普通登录方式时用户名必写，密码缺省为SYSDBA。/表示采用操作系统身份验证方式登录，此时无需指定用户名和密码，即使指定也会被忽略。如果*<*password>中含有特殊字符，因为特殊字符在操作系统中需要被特殊处理，因此特殊字符书写的时候需要按照要求的格式。本节末尾会针对包含特殊字符的*<*password>如何书写，进行详细介绍。

：服务名。服务名在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 系统中，当服务器与客户端之间使用 UNIXSOCETUNIX-IPC 方式通信时，指定客户端连接的 UNIXSOCKET 路径文件名。必须和 inet_type=UNIXSOCKET 同时使用。例如：

./disql SYSDBA/SYSDBA@/data/sdb/DAMENG/foo.sock##{inet_type=UNIXSOCKET}

***<*option>**：为扩展选项，用法为<exetend_option>=*<*value>。所有 value 值不能包含空格，不能包含特殊的符号，如引号等。书写扩展选项时需要用引号##”{ }”进行封装，例如：##”{inet_type=tcp,mpp_type=local}”。

*/NOLOG**：表示在未登录DM服务器的情况下启动 disql。此时可以进行 DIsql 的显示设置和本地变量操作。如果没有 /NOLOG 选项必须登录服务器，不带参数的时候提示输入用户名和密码，此时的用户名和密码用法参考<*logon>。且登录三次失败后退出 DIsql。

<`运行脚本>：符号运行sql脚本文件。如果在linux环境下使用，<运行脚本>外需要加上单引号，里如：’`” < file_path >”‘。是运行的sql脚本文件的绝对路径。

<PARAMETER_VALUE>是传给<file_path>脚本文件中本地变量的参数值，将其中的参数内容传给变了&1，&2，&3…以此类推。

<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"。

<直接执行SET命令>：使用-C参数，将在运行DIsql时直接执行后续的SET命令。例如：

DIsql SYSDBA/SYSDBA -C "SET LONG 1000 PAGESIZE 0"。

*<*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。

其次，在操作系统要求的基础上，增加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的要求双引号作为特殊字符，需要使用双引号在括起来，同时使用双引号对双引号转义”aaa””’aaaa”;同时考虑操作系统的要求，因为含有单引号，只能将整个密码放入双引号中，同时对双引号使用反斜杠转义，那么连接串要写成：./DIsql user01/”\”aaa\”\”’aaaa\””。

如何转义双引号

DIsql的要求使用双引号对双引号内的双引号转义。
WINDOWS命令行，使用双引号或者反斜杠对双引号内的双引号转义。
LINUX命令行，使用反斜杠对双引号内的双引号转义。

2 切换登录

用户进入 DIsql 界面后，如果想切换到其他 DM 数据库实例。有两种实现方式：一是使用 LOGIN 命令；二是使用 CONN 命令。登录到远程数据库，必须在服务名处使用 IP 地址或网络服务名。

2.1 LOGIN /LOGOUT

1. LOGIN 登录主库建立会话

直接输入 LOGIN 命令后，屏幕会提示输入登录信息。

图4 login 登录提示信息

服务名：数据库服务名、或 IP 地址、或 UNIXSOCKET 文件路径名。LOCALHOST 表示本地服务器。默认为 LOCALHOST。例如，UNIXSOCKET 文件路径名为 /home/te/foo.sock。

用户名和密码：默认均为 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（共享内存）|RDMA（远程直接内存访问）|UNIXSOCKET。

登录成功后会显示登录时间。

2. LOGOUT 从登录主库注销会话

LOGOUT 命令从登录主库注销会话。断开连接而不退出 DIsql。

SQL>LOGOUT

2.2 CONN[ECT] /DISCONN[ECT]

1. CONN[ECT] 连接

在 DIsql 界面中，使用 CONN[ECT]命令登录远程数据库。

语法如下：

CONN[ECT] <logon><logon>::={{<username>[/<password>]} | /}[@<connect_identifier>][<option>] [<os_auth>] <connect_identifier> ::=<svc_name> | {<host>[:<port>]} | <unixsocket_file><option>::= ##{ <exetend_option>=<value>{,<extend_option>=<value>} }  --此行外层{}是为了封装参数之用，书写时需要保留<os_auth>::= AS {SYSDBA|SYSSSO|SYSAUDITOR|USERS|AUTO}

示例如下：

SQL>CONN SYSDBA/SYSDBA@192.168.1.150

2. DISCONN[ECT] 断开连接

DISCONN[ECT]：断开连接而不退出 DIsql。与 logout 功能一样。

SQL>DISCONN

3 退出 DIsql

使用 EXIT/QUIT 命令，退出 DIsql。

语法如下：

EXIT|QUIT

更多达梦资讯请上达梦社区了解 https://eco.dameng.com