活动专区

活动公告

上车！GBase 8a开发者联盟发车了 技术福利、人脉资源全都有！

认证培训专区

认证培训资料

GBase 8s GDCA 认证培训课前准备

GBase 8a

其他

物化视图报错：references invalid table(s) or column(s) or function(s) or definer/invoker of view lack rights to use them

01-GBase 8s 事务型数据库 安装与卸载

GBase 8s

适配迁移

[GBase 8s 教程]GBase 8s 常用函数、表达式

# GCDW 客户端与应用接口连接

## 1. gccli 简介

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

### 安装步骤

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

# 切换 gbase 用户
su - gbase

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

安装完成后，可执行：

```bash
gccli -uUSER -pPASSWORD -hCOORDINATOR_IP
```

验证安装是否成功。

---

## 2. gccli 常用参数

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

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

---

## 3. gccli 使用示例

### 普通连接

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

### 高可用连接

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

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

```bash
kubectl get all -n  -o wide
```

---

## 4. 域名连接

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

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

查看 Coordinator 域名：

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

./account --show
```

支持批量执行 SQL：

```bash
gccli ... &lt; test.sql
```

---

## 5. 执行 SQL

直接执行 SQL：

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

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

---

## 6. JDBC 连接

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

### 普通连接

```java
jdbc:gbase://host:port/dbname
```

### 高可用

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

### 负载均衡

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

---

## 7. JDBC 示例

```java
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 域名：

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

查看域名：

```bash
./account --show
```





学习笔记

GCDW 客户端与应用接口连接

GCDW 客户端与应用接口连接

评论

热门帖子