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>][<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命令>”
建议文中语法符号规定:<>内的内容是必选项; <p>[]内的内容是可选项;{}内的内容可以出现一次或多次</p> <p>|为或者;::=为定义符。后文语法用法与此相同。
-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 系统中,当服务器与客户端之间使用 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}"。
现支持的扩展选项如下:
extend_option | value |
---|---|
mpp_type | MPP登录属性,此属性的设置对非MPP系统没有影响。取值GLOBAL和LOCAL,默认为GLOBAL。GLOBAL表示MPP环境下建立的会话为全局会话,对数据库的导入导出操作在所有节点进行;LOCAL表示MPP环境下建立的会话为本地会话,对数据库的导入导出操作只在本地节点进行 |
inet_type | 网络通信协议类型。取值UDP/TCP/IPC/RDMA/UNIXSOCKET,分别对应UDP协议、TCP协议、IPC(共享内存)、RDMA(远程直接内存访问)、UNIXSOCKET(unix domain socket - IPC)协议。缺省为TCP |
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一起使用。缺省为不加密 |
例如,一个包含 *<*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 安全管理》2.3.1节。
/NOLOG
:表示在未登录DM服务器的情况下启动 disql。此时可以进行 DIsql 的显示设置和本地变量操作。如果没有 /NOLOG 选项必须登录服务器,不带参数的时候提示输入用户名和密码,此时的用户名和密码用法参考*<*logon>。且登录三次失败后退出 DIsql。
注意start>命令中:<`运行脚本>既可以在DIsql启动时使用,也可以在进入DIsql界面之后使用。而<start运行脚本>只能在进入DIsql界面之后才能使用。
**<运行脚本>:**
符号运行sql脚本文件。如果在linux环境下使用,<运行脚本>外需要加上单引号,里如:'
" < file_path >"'。<file_path>是运行的sql脚本文件的绝对路径。例如:e:\a.sql为包含了一条select * from dual;语句的脚本文件。
disql [SYSDBA/SYSDBA@192.168.1.64:5236](mailto:SYSDBA/SYSDBA@192.168.1.64:5236) `e:\a.sql
或
SQL> `e:\a.sql
<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"。
<直接执行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。
其次,在操作系统要求的基础上,增加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\””。
2.如何转义双引号
- DIsql的要求使用双引号对双引号内的双引号转义。
- WINDOWS命令行,使用双引号或者反斜杠对双引号内的双引号转义。
- LINUX命令行,使用反斜杠对双引号内的双引号转义。
2.2 切换登录
用户进入 DIsql 界面后,如果想切换到其他 DM 数据库实例。有两种实现方式:一是使用 LOGIN 命令;二是使用 CONN 命令。登录到远程数据库,必须在服务名处使用 IP 地址或网络服务名。
2.2.1 LOGIN /LOGOUT
在 DIsql 界面中,使用 LOGIN/LOGOUT 命令登录/退出远程数据库。
1. LOGIN 登录主库建立会话
直接输入 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.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}
*<*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