GCDW 客户端与应用接口连接

1. gccli 简介

• gccli 是 GCDW 的命令行客户端，用于连接数据库并执行 SQL。
• 可部署在非 GCDW 节点的 Linux 环境，通过网络连接 Coordinator 节点。:contentReference[oaicite:0]{index=0}

安装步骤

# 解压安装包
tar xvf gccli_xxx.tar.bz2

# 切换 gbase 用户
su - gbase

# 执行安装
./gccli_install.sh gccli_standalone.tar.bz2

安装完成后，可执行：

gccli -uUSER -pPASSWORD -hCOORDINATOR_IP

验证安装是否成功。

---

2. gccli 常用参数

gccli -u -p \
      -h -P \
      -D

参数	说明
-u	用户名
-p	密码
-h	Coordinator IP（支持多个地址，实现高可用）
-P	Coordinator 端口
-D	默认数据库
-e	执行 SQL
-vvv	格式化输出
< sql.sql	批量执行 SQL 文件
-f	批量执行时忽略错误继续执行

---

3. gccli 使用示例

普通连接

gccli -uroot -p12345678 \
      -h172.16.5.28 \
      -P34739

高可用连接

gccli -uroot -p12345678 \
-h172.16.5.28:34739,172.16.5.29:28090,172.16.5.28:25290

Coordinator 端口可通过以下命令查看：

kubectl get all -n  -o wide

---

4. 域名连接

如果 gccli 部署在 GCDW 所在 K8S 集群内，可直接使用 Coordinator 域名连接。

gccli \
-hcoordinator-3.chent \
-uroot \
-p12345678 \
-Dcloud

查看 Coordinator 域名：

kubectl exec -it gcdw-saas-backend-0 -n gcdwbase -- bash

./account --show

支持批量执行 SQL：

gccli ... < test.sql

---

5. 执行 SQL

直接执行 SQL：

gccli \
-uroot \
-p12345678 \
-h172.16.5.28:34739 \
-Dcloud \
-e "SELECT * FROM user_check LIMIT 1\G"

\G 表示纵向显示查询结果，便于查看宽表。

---

6. JDBC 连接

GCDW 与 GBase 8a 使用相同的 JDBC 驱动。

普通连接

jdbc:gbase://host:port/dbname

高可用

jdbc:gbase://host:port/dbname
?user=root
&password=******
&failoverEnable=true
&hostList=IP1:PORT1,IP2:PORT2

负载均衡

jdbc:gbase://host:port/dbname
?user=root
&password=******
&failoverEnable=true
&hostList=IP1:PORT1,IP2:PORT2
&gclusterId=gcl1

---

7. JDBC 示例

String url =
"jdbc:gbase://172.16.5.28:34739/testdb
?user=root
&password=******
&failoverEnable=true
&hostList=172.16.5.29:28090,172.16.5.28:25290
&gclusterId=gcl1";

注意：

• 重启 Coordinator Pod，端口保持不变。
• 删除并重新创建 Coordinator，端口可能变化。
• GCDW 升级后，Coordinator 外部端口可能变化。

---

8. K8S 域名连接

如果应用部署在 GCDW 所在 K8S 集群中，可直接使用 Coordinator 域名：

jdbc:gbase://coordinator-1.chent/testdb
?user=root
&password=******
&failoverEnable=true
&hostList=coordinator-2.chent,coordinator-3.chent
&gclusterId=gcl1

查看域名：

./account --show