关于 Ksql

Ksql 是 KingbaseES 数据库的主要命令行界面。可以使用 Ksql 设置数据库初始化参数、创建和管理用户、创建和更改数据库对象 (例如表和索引)、插入和更新数据、运行 SQL 查询等等。

使用 Ksql，可以本地或者远程连接。本地连接意味着连接到运行 Ksql 的同一台计算机上运行的 KingbaseES 数据库。远程连接意味着通过网络连接到远程计算机上运行的 KingbaseES 数据库。这样的数据库成为远程的数据库。

连接金仓数据库 KingbaseES

关于使用 Ksql 连接到数据库

KingbaseES 数据库包含以下组件：KingbaseES 数据库实例，它是进程和内存的集合，以及一组包含用户数据和系统数据的磁盘文件。

由于主机上可能有多个 KingbaseES 实例，每个实例都有自己的一组数据文件，因此必须确定连接的实例。

对于本地连接，可以通过设置操作系统环境变量来识别实例。

对于远程连接，可以通过指定网路和数据库服务名称来识别实例。

对于本地和远程连接，必须设置环境变量以帮助操作系统找到 Ksql 可执行文件并为可执行文件提供其支持文件和脚本路径。

Step 1：打开命令窗口

执行必要的操作以打开一个窗口，可以在其中输入操作系统命令。

Step 2：设置操作系统环境变量

在启动 Ksql 之前设置环境变量，或者至少验证它们是否设置正确。

例如，在大多数平台上，需要配置 PATH 环境变量以包含 KingbaseES 的 bin 目录。

在 Linux 上，通过输入操作系统命令来设置环境变量。

-- Setting Environment Variables in Linux (C Shell)setenv LD_LIBRARY_PATH=/home/test/kb_install/lib/kingbase/
-- Setting Environment Variables in Linux (Bash Shell)export LD_LIBRARY_PATH=/home/test/kb_install/lib/kingbase/

Step 3：启动 Ksql

要开始使用 Ksql, 必须首先了解如何启动和停止 Ksql。

• 请确保在计算机上已经安装了 Ksql

• 登录到操作系统 (如果需要)

• 输入连接到数据库的命令，然后按 Enter 键

ksql -h hostname -U username -d dbname -p port

Step 4：Ksql 连接到金仓数据库 KingbaseES

当启动 Ksql 时, 需要一个用户名和密码才能登录到 KingbaseES 数据库模式。用户名和密码是 KingbaseES 数据库授权的用户。

可以使用连接命令对不同的用户进行连接，用户名和密码必须对该数据库有效。

例如，连接到 user1 用户：

-- Connect to a Local Database User
ksql -U username -d dbname -p port
-- Connect to a  Database with the Host IP Address
ksql -h hostname -U username -d dbname -p port

Ksql 连接数据库命令语法

连接命令格式如下:

ksql [option...] [dbname [username]]
ksql -U username -d dbname -p port

例如

$ ksql -p 54320 -d test
ksql (V9.0)
Type "help" for help.

执行一个查询

在正常操作时，Ksql 会提供一个提示符，该提示符是 Ksql 当前连接到的数据库名称后面跟上字符串 =# 。例如：

$ ksql testdbksql (V9.0)Type "help" for help.
testdb=#

在提示符下，用户可以键入 SQL 命令。正常情况下，当碰到一个表示命令终结的分号时，输入的行会被发送给服务器。一行的结束并不表示命令的完结。因此，为了清晰，可以把命令散布在多个行上。如果命令被发送并且执行而不产生错误，该命令的结果将会显示在屏幕上。例如：

test=# select a, b from t1; a | b---+--- 1 | 2 3 | 4(2 rows)

退出 Ksql

如果需要退出 Ksql 命令行，输入 \q 即可，Ksql 正常完成，它会向 shell 返回 0。如果它自身发生一个致命错误（例如内存用完、找不到文件），它会返回 1。如果到服务器的连接出问题并且事务不是交互式的，它会返回 2。如果在脚本中发生错误，它会返回 3 并且变量 ON_ERROR_STOP 会被设置。