GaussDB 高斯数据库参考手册

1. 使用 DBeaver 客户端连接 GaussDB 数据库

以下是使用 DBeaver 客户端连接 GaussDB 数据库的详细步骤：

1.1 获取驱动包

  • 根据 GaussDB 数据库的版本，下载对应版本的驱动包。
  • 解压驱动包，找到 gaussdbjdbc.jar 文件。

1.2 安装 DBeaver 客户端

  • 访问 DBeaver 官网，下载适合您操作系统的安装包并完成安装。

1.3 配置驱动

  1. 打开 DBeaver，选择 “数据库” -> “驱动管理器”，点击 “新建”。
  2. 在 “设置” 页签中：
    • 输入驱动名称（如 “GaussDB”）。
    • 选择驱动类型为 “Generic”。
    • 填写类名为 com.huawei.gaussdb.jdbc.Driver。
    • URL 模板为空。
    • 默认端口为 8000。
  3. 在 “库” 页签中：
    • 点击 “添加文件”，选择 gaussdbjdbc.jar 文件。
    • 点击 “找到类” 以识别驱动类。

image-20250409161636762

image-20250409161636762

1.4 创建数据库连接

  1. 在 DBeaver 主界面，点击 “新建数据库连接”，选择刚才配置的 “GaussDB” 驱动，点击 “下一步”。
  2. 输入数据库的主机 IP 地址、端口（通常是 8000）、数据库名、用户名和密码。
  3. 点击 “测试连接”，若显示 “已连接”，则说明连接成功，点击 “完成”。

image-20250409161636762

1.5 使用 DBeaver 操作数据库

连接成功后，您可以在 DBeaver 中浏览数据库结构、执行 SQL 查询、导入导出数据等。如果在连接过程中遇到问题，可以参考 GaussDB 的官方文档或 DBeaver 的官方文档。

2. GaussDB Maven 驱动下载

2.1 GaussDB 驱动

下载地址： http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar

Maven 依赖配置： 

<dependency>
    <groupId>com.huawei.gaussdb</groupId>
    <artifactId>gaussdbjdbc</artifactId>
    <version>5.0.0</version>
</dependency>

2.2 dbcp.properties 示例

######## DBCP ##########
######## GaussDB########
driverClassName=com.huawei.gaussdb.jdbc.Driver
url=jdbc:gaussdb://ip:8000,ip:8000,ip:8000/tpcc?currentSchema=snest_changwen&autoBalance=true&refreshCNIpListTime=3&prepareThreshold=1&batchMode=on&fetchsize=10&loggerLevel=OFF
username=***
password=***
validationQuery=SELECT 1
gaussdbDeployment=Distributed

initialSize=5
maxActive=2000
minIdle=5
filters=stat
maxWait=6000
timeBetweenEvictionRunsMillis=60000
minEvictableIdleTimeMillis=1800000
testOnBorrow=false
testOnReturn=false
testWhileIdle=true
poolPreparedStatements: true
maxOpenPreparedStatements: 20
connectionProperties:druid.stat.sql.MaxSize=100;
keepAlive=true

######## OceanBase ########
# driverClassName=com.mysql.cj.jdbc.Driver
# url=jdbc:mysql://ip:2881/snest_changwen?rewriteBatchedStatements=TRUE&allowMultiQueries=TRUE&useLocalSessionState=TRUE&useUnicode=TRUE&characterEncoding=utf-8&socketTimeout=10000&connectTimeout=30000&zeroDateTimeBehavior=convertToNull&allowPublicKeyRetrieval=true
# username=***
# password=***

######## Oracle ########
# driverClassName=oracle.jdbc.OracleDriver
# url=jdbc:oracle:thin:@ip:1521:ORCLCDB
# username=C##***
# password=***
# validationQuery=SELECT 'x' FROM DUAL

######## PostgreSQL ########
# driverClassName=org.postgresql.Driver
# url=jdbc:postgresql://ip:5432/postgres?currentSchema=snest_changwen&encoding=UTF-8&timezone=UTC
# username=***
# password=***
# validationQuery=SELECT 1

3. GaussDB 环境配置示例

3.1 dbcp.properties 示例


######## DBCP ##########
initialSize=5
maxActive=2000
minIdle=5
filters=stat
maxWait=6000
timeBetweenEvictionRunsMillis=60000
minEvictableIdleTimeMillis=1800000
testOnBorrow=false
testOnReturn=false
testWhileIdle=true
poolPreparedStatements: true
maxOpenPreparedStatements: 20
connectionProperties:druid.stat.sql.MaxSize=100;
keepAlive=true

######## GaussDB ########
driverClassName=com.huawei.gaussdb.jdbc.Driver
url=jdbc:gaussdb://127.0.0.1:8000,127.0.0.1:8000,127.0.0.1:8000/tpcc?currentSchema=snest_jichen&autoBalance=true&refreshCNIpListTime=3&prepareThreshold=1&batchMode=on&fetchsize=10&loggerLevel=OFF
username=******
password=******
validationQuery=SELECT 1
gaussdbDeployment=Distributed

3.2 Spring 配置文件适配

在 application-dev.properties 文件中添加以下参数，以适配 GaussDB 自定义 SQL 列字段别名转换：

orm.sql.wrap_camelcase_alias=true

Table of Contents