2. 首页 > 国产数据库教程 > GaussDB教程 > 正文

GaussDB教程FG009-GaussDB客户端连接与工具

教程整理：风哥教程  |  更新时间：2026-02-01  |  教程分类：GaussDB教程  |  文档学习：31

本教程详细介绍GaussDB数据库的客户端连接方法和常用工具，包括psql命令行工具、图形化工具、JDBC/ODBC连接等内容。风哥教程参考GaussDB官方文档，结合生产实战经验，为读者提供全面的客户端连接与工具使用指导。

目录大纲

Part01-基础概念与理论知识

1.1 客户端连接概述

客户端连接是应用程序与GaussDB数据库交互的桥梁，通过客户端连接，用户可以执行SQL语句、管理数据库对象、监控数据库状态等操作。GaussDB支持多种客户端连接方式，包括命令行工具、图形化工具和应用程序连接等。

1.2 连接方式分类

GaussDB的客户端连接方式主要分为以下几类：

  • 命令行工具：如psql，适合命令行操作和脚本编写
  • 图形化工具：如pgAdmin、DBeaver等，适合可视化操作
  • 应用程序连接：通过JDBC、ODBC等驱动连接，适合应用程序开发
  • Web界面：通过数据库管理系统的Web界面连接，适合远程管理

Part02-psql命令行工具

2.1 psql工具介绍

psql是GaussDB自带的命令行工具，功能强大，支持交互式操作和脚本执行。psql工具位于GaussDB安装目录的bin目录下。

2.2 psql连接方法

使用psql连接数据库时，需要确保数据库服务已启动，并且连接参数正确。

基本连接：

# 基本连接

su – gauss

cd /gauss/app/bin

./psql -U fgedu -d postgres -p 8000

# 输出日志

psql (14.0)

Type “help” for help.

postgres=#

指定主机连接：

# 指定主机连接

./psql -h 192.168.1.101 -U fgedu -d postgres -p 8000

# 输出日志

Password for user fgedu:

psql (14.0)

Type “help” for help.

postgres=#

执行SQL文件：

# 创建SQL文件

cat > test.sql << EOF

SELECT version();

SELECT current_date;

EOF

# 执行SQL文件

./psql -U fgedu -d postgres -p 8000 -f test.sql

# 输出日志

version | current_date

—————————————————————————–+————–

GaussDB 8.0.0.1 (build 12345) on x86_64-pc-linux-gnu, compiled by gcc (GCC) 7.3.0, 64-bit | 2023-07-01

(1 row)

current_date

————–

2023-07-01

(1 row)

2.3 psql常用命令

元命令：

# 连接数据库后执行元命令

postgres=# \l — 列出所有数据库

postgres=# \c dbname — 连接到指定数据库

postgres=# \dt — 列出所有表

postgres=# \d tablename — 查看表结构

postgres=# \du — 列出所有用户

postgres=# \df — 列出所有函数

postgres=# \dn — 列出所有模式

postgres=# \x — 开启扩展显示模式

postgres=# \q — 退出psql

执行SQL语句：

postgres=# SELECT * FROM pg_stat_database;

datid | datname | numbackends | xact_commit | xact_rollback | blks_read | blks_hit | tup_returned | tup_fetched | tup_inserted | tup_updated | tup_deleted | conflicts | temp_files | temp_bytes | deadlocks | checksum_failures | checksum_last_failure | stats_reset

——-+———-+————-+————-+—————+———–+———-+————–+————-+————–+————-+————-+———–+————+————+———–+——————+————————+——————————-

13012 | postgres | 1 | 123 | 0 | 456 | 7890 | 1234 | 5678 | 901 | 234 | 56 | 0 | 0 | 0 | 0 | 0 | | 2023-07-01 10:00:00.000000+08

(1 row)

Part03-图形化工具

3.1 pgAdmin工具

pgAdmin是一个功能强大的开源图形化数据库管理工具，支持GaussDB数据库。

安装pgAdmin：

# 安装pgAdmin

yum install -y epel-release

yum install -y pgadmin4

连接GaussDB：

  1. 启动pgAdmin
  2. 点击”Add New Server”
  3. 在”General”标签页输入服务器名称
  4. 在”Connection”标签页输入主机、端口、用户名、密码
  5. 点击”Save”保存连接

3.2 DBeaver工具

DBeaver是一个通用的数据库管理工具，支持多种数据库，包括GaussDB。

下载并安装DBeaver：

连接GaussDB：

  1. 启动DBeaver
  2. 点击”New Database Connection”
  3. 选择”PostgreSQL”（GaussDB兼容PostgreSQL协议）
  4. 输入主机、端口、数据库名、用户名、密码
  5. 点击”Test Connection”测试连接

    6. 学习交流加群风哥微信: itpux-com

  6. 点击”Finish”完成连接

3.3 GaussDB专用工具

GaussDB提供了专用的图形化管理工具，如GaussDB Manager等。

使用GaussDB Manager：

  1. 下载并安装GaussDB Manager
  2. 启动GaussDB Manager
  3. 创建新连接，输入连接信息
  4. 连接数据库后，可以进行各种管理操作

Part04-应用程序连接

4.1 JDBC连接

JDBC（Java Database Connectivity）是Java应用程序连接数据库的标准接口。

添加JDBC驱动：

  • 下载GaussDB JDBC驱动
  • 将驱动JAR包添加到项目的classpath中

JDBC连接示例：

// JDBC连接示例

import java.sql.Connection;

import java.sql.DriverManager;

import java.sql.ResultSet;

学习交流加群风哥QQ113257174

import java.sql.Statement;

public class GaussDBJdbcExample {

public static void main(String[] args) {

String url = “jdbc:postgresql://192.168.1.101:8000/postgres”;

String user = “fgedu”;

String password = “Fgedu@123”;

try (Connection conn = DriverManager.getConnection(url, user, password);

Statement stmt = conn.createStatement();

ResultSet rs = stmt.executeQuery(“SELECT version()”)) {

if (rs.next()) {

System.out.println(rs.getString(1));

}

} catch (Exception e) {

e.printStackTrace();

}

}

}

4.2 ODBC连接

ODBC（Open Database Connectivity）是一种开放的数据库连接标准，支持多种编程语言。

安装ODBC驱动：

# 安装ODBC驱动

yum install -y unixODBC unixODBC-devel

# 安装GaussDB ODBC驱动

rpm -ivh gaussdb-odbc-8.0.0.1-1.x86_64.rpm

更多视频教程www.fgedu.net.cn

配置ODBC数据源：

# 编辑odbc.ini文件

vi /etc/odbc.ini

# 添加以下内容

[GaussDB]

Driver = GaussDB ODBC Driver

Servername = 192.168.1.101

Port = 8000

Database = postgres

Username = fgedu

Password = Fgedu@123

4.3 其他语言连接

Python连接：

# 安装psycopg2

pip install psycopg2-binary

# Python连接示例

import psycopg2

conn = psycopg2.connect(

host=”192.168.1.101″,

port=8000,

database=”postgres”,

user=”fgedu”,

password=”Fgedu@123″

)

更多学习教程公众号风哥教程itpux_com

cur = conn.cursor()

cur.execute(“SELECT version()”)

print(cur.fetchone()[0])

cur.close()

conn.close()

Node.js连接：

# 安装pg模块

npm install pg

# Node.js连接示例

const { Client } = require(‘pg’);

const client = new Client({

host: ‘192.168.1.101’,

port: 8000,

database: ‘postgres’,

user: ‘fgedu’,

password: ‘Fgedu@123’

});

client.connect()

.then(() => client.query(‘SELECT version()’))

.then(res => console.log(res.rows[0].version))

.finally(() => client.end());

from DB视频:www.itpux.com

Part05-连接配置与管理

5.1 连接参数配置

pg_hba.conf配置：

# 编辑pg_hba.conf文件

vi /gauss/fgdata/pg_hba.conf

# 添加连接规则

# 允许本地连接

local all all trust

# 允许网络连接

host all all 192.168.1.0/24 md5

# 允许复制连接

host replication all 192.168.1.0/24 md5

# 重载配置

su – gauss

cd /gauss/app/bin

./pg_ctl reload -D /gauss/fgdata

5.2 连接池配置

连接池可以提高应用程序的性能，减少连接建立的开销。

使用pgBouncer：

# 安装pgBouncer

yum install -y pg bouncer

# 配置pgBouncer

vi /etc/pgbouncer/pgbouncer.ini

# 添加以下内容

[databases]

postgres = host=192.168.1.101 port=8000 dbname=postgres

[pgbouncer]

listen_addr = *

listen_port = 6432

auth_type = md5

auth_file = /etc/pgbouncer/userlist.txt

pool_mode = transaction

max_client_conn = 1000

default_pool_size = 20

# 启动pgBouncer

systemctl start pgbouncer

5.3 连接安全管理

密码加密：

# 编辑postgresql.conf文件

vi /gauss/fgdata/postgresql.conf

# 设置密码加密方式

password_encryption = scram-sha-256

# 重载配置

su – gauss

cd /gauss/app/bin

./pg_ctl reload -D /gauss/fgdata

SSL配置：

# 编辑postgresql.conf文件

vi /gauss/fgdata/postgresql.conf

# 启用SSL

ssl = on

ssl_cert_file = ‘/gauss/fgdata/server.crt’

ssl_key_file = ‘/gauss/fgdata/server.key’

# 重载配置

su – gauss

cd /gauss/app/bin

./pg_ctl reload -D /gauss/fgdata

Part06-风哥经验总结与分享

6.1 客户端连接最佳实践

  • 使用连接池：生产环境建议使用连接池，提高性能和可靠性
  • 合理设置连接参数：根据应用程序需求设置合适的连接参数
  • 安全配置：启用密码加密和SSL，保障连接安全
  • 定期检查连接：定期检查连接状态，及时释放无效连接
  • 监控连接数：监控数据库连接数，避免连接数过多导致性能下降
  • 使用合适的工具：根据不同场景选择合适的客户端工具

6.2 常见问题与解决方案

问题1：连接超时

解决方案：

  • 检查网络连接是否正常
  • 检查数据库服务是否运行
  • 检查防火墙设置
  • 调整连接超时参数

问题2：认证失败

解决方案：

  • 检查用户名和密码是否正确
  • 检查pg_hba.conf配置
  • 检查密码加密方式
  • 重置用户密码

问题3：连接数过多

解决方案：

  • 使用连接池
  • 增加max_connections参数
  • 检查是否有泄漏的连接
  • 优化应用程序连接管理

问题4：SSL连接失败

解决方案：

  • 检查SSL证书是否正确
  • 检查SSL配置参数
  • 验证客户端是否支持SSL
  • 暂时禁用SSL进行测试

from GaussDB视频:www.itpux.com

本文由风哥教程整理发布,仅用于学习测试使用,转载注明出处:http://www.fgedu.net.cn/10327.html

相关推荐

联系我们

在线咨询：点击这里给我发消息

微信号：itpux-com

工作日：9:30-18:30，节假日休息