GBase 8a 学习笔记 004 —— GBase 8a MPP Cluster 数据库客户端：命令行客户端

心有阳光 2023-02-27

1401

GBase 8a 学习笔记 004 —— GBase 8a MPP Cluster 数据库客户端：命令行客户端

GBase 8a MPP Cluster的访问

> GBase 8a数据库采用C/S架构

执行过程
- 客户端发出请求
- 服务器接收请求
- 服务器将请求发给数据库管理系统查询数据
- 数据库管理系统将查询结果返回给服务器
- 服务器将结果返回给客户端
- 客户端接收数据

命令行客户端

又称命令行界面客户端，即CLI客户端。通常部署在集群外部的Linux节点上，也支持部署在集群内的非Coordinator节点上。

注：Coordinator节点已内置命令行客户端，无需安装。

gccli命令说明

gccli –u<username> -p<password> [-h<ipaddress>] [-P<portname>] [-D<databasename>] 
[--nice_time_format] [-c] [-f] [-vvv] [-e] [<]

–u<username>：连接数据库的用户名称，该名称默认为 root；
-p<password>：连接数据库的密码，该密码默认为空，首次安装；
[-h<ipaddress>]：集群管理节点（数据库服务器）的IP 地址。可选参数，默认 127.0.0.1。如果指定多个 IP 地址，
则启动 gccli 的高可用功能，IP 地址之间采用“,”分隔，例如 192.168.100.10,192.168.100.11,192.168.100.12；
[-P<portname>]：集群使用的端口号，默认 5258，可选参数；
[-D<databasename>]：可选参数，用于指定登录时默认访问的数据库（数据库必须存在）；
[--nice_time_format]：可选参数，用于指定用户操作耗时的时间格式。单位为“秒”；
[-c]：可选参数，此参数用于使用 hint 优化方式。
[-f]： 可选参数，此参数用于批量执行 SQL 文件时，如果中间有 SQL 执行报错，强制执行后续 SQL；
[-vvv]：可选参数，此参数用于格式化显示执行结果；
[-e] ：可选参数，此参数用于执行 SQL 语句，若有多个 SQL语句，以“;”隔开；
[<]：可选参数，用于批量执行 SQL 文件。

> 使用示例

# 执行SQL
$./gccli –uroot –p111111 -h172.16.9.161–P5258 –Dtest -e “show databases;select database();”

# SQL文件输入方法
$./gccli -uroot -p111111 -Dtest -vvv -f <query_join.sql >>query_join.result 2>query_join.err

# 主节点执行

[gbase@192 gcinstall]$ gccli -u root -p -h 192.168.254.138
Enter password:

GBase client 9.5.2.39.126761. Copyright (c) 2004-2023, GBase.  All Rights Reserved.

gbase> exit
Bye
[gbase@192 gcinstall]$

# 退出数据库
quit或者exit

命令行客户端的安装

安装步骤
- 获取客户端安装包，解压缩
- 赋予安装文件执行权限
- 执行安装
- 验证连接
注意事项
- 待安装节点为非集群管理节点
- 待安装节点操作系统需要和现有集群一致

> 命令行客户端安装步骤

获取客户端安装包，并在非管理节点上解压缩

# 使用DBA帐户进行解压
[root@192 opt]# pwd
/opt
[root@192 opt]# ll
总用量 3616
drwxr-xr-x  5 gbase gbase      49 2月  23 23:36 gbase
-rw-r--r--  1 root  root  3673603 2月  25 21:47 gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
drwxr-xr-x. 2 root  root        6 10月 31 2018 rh
-rwxr-xr-x  1 root  root    27849 2月  23 23:14 SetSysEnv.py
[root@192 opt]# chown gbase:gbase gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
[root@192 opt]# ll
总用量 3616
drwxr-xr-x  5 gbase gbase      49 2月  23 23:36 gbase
-rw-r--r--  1 gbase gbase 3673603 2月  25 21:47 gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
drwxr-xr-x. 2 root  root        6 10月 31 2018 rh
-rwxr-xr-x  1 root  root    27849 2月  23 23:14 SetSysEnv.py

# 解压后，将会在解压目录下生成gccli_install目录

[root@192 opt]# tar xfj gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
[root@192 opt]# ll
总用量 3616
drwxr-xr-x  5 gbase gbase      49 2月  23 23:36 gbase
-rw-r--r--  1 gbase gbase 3673603 2月  25 21:47 gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
drwxr-xr-x  2 gbase gbase      62 3月  14 2021 gccli_install
drwxr-xr-x. 2 root  root        6 10月 31 2018 rh
-rwxr-xr-x  1 root  root    27849 2月  23 23:14 SetSysEnv.py

# 切换账户

[root@192 opt]# su - gbase
上一次登录：六 2月 25 20:59:16 CST 2023pts/0 上
[gbase@192 ~]$ cd /opt/
[gbase@192 opt]$ ll
总用量 3616
drwxr-xr-x  5 gbase gbase      49 2月  23 23:36 gbase
-rw-r--r--  1 gbase gbase 3673603 2月  25 21:47 gccli-9.5.2.39-redhat7.3-x86_64.tar.bz2
drwxr-xr-x  2 gbase gbase      62 3月  14 2021 gccli_install
drwxr-xr-x. 2 root  root        6 10月 31 2018 rh
-rwxr-xr-x  1 root  root    27849 2月  23 23:14 SetSysEnv.py

[gbase@192 opt]$ cd gccli_install/
[gbase@192 gccli_install]$ ll
总用量 3576
-rw-r--r-- 1 gbase gbase    1642 3月  14 2021 gccli_install.sh
-rw-r--r-- 1 gbase gbase 3655418 3月  14 2021 gccli_standalone.tar.bz2

# 开放安装文件的执行权限

[gbase@192 gccli_install]$ chmod 744 gccli_install.sh
[gbase@192 gccli_install]$ ll
总用量 3576
-rwxr--r-- 1 gbase gbase    1642 3月  14 2021 gccli_install.sh
-rw-r--r-- 1 gbase gbase 3655418 3月  14 2021 gccli_standalone.tar.bz2

# 执行安装

[gbase@192 gccli_install]$ ./gccli_install.sh gccli_standalone.tar.bz2
gcluster/
gcluster/config/
gcluster/config/gbase_8a_gcluster.cnf
gcluster/server/
gcluster/server/bin/
gcluster/server/bin/gbase
gcluster/server/lib/
gcluster/server/lib/gbase/
Installation finished.
Please run "/opt/gccli_install/gcluster/server/bin/gccli -uUSER -pPASSWORD -hGCLUSTER_NODE_IP" for checking.

# 验证连接

[gbase@192 gccli_install]$ /opt/gccli_install/gcluster/server/bin/gccli -uroot -p -h192.168.254.138
Enter password:

GBase client 9.5.2.39.126761. Copyright (c) 2004-2023, GBase.  All Rights Reserved.

gbase> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| performance_schema |
| gbase              |
| gctmpdb            |
| gclusterdb         |
| test               |
+--------------------+
6 rows in set (Elapsed: 00:00:00.00)

gbase>