在开发者空间使用gaussdb-python连接GaussDB-优快云博客

概述

背景介绍

GaussDB 是华为自研的企业级分布式关系型数据库，具备强大的分布式事务能力、同城多可用区部署、数据零丢失保障、PB级存储扩展等特性。它支持高可用、高安全、弹性伸缩、一键部署、备份恢复和监控告警，适用于对性能、可靠性和扩展性有高要求的企业级应用场景。

通过实际操作，让大家快速上手如何使用 python-gaussdb 访问华为自研的 GaussDB 数据库，搭建起自己的数据库应用。不再依赖繁琐的数据库客户端，也不用担心连接失败或操作复杂的问题。

只需几个简单步骤，即可使用纯Python 连接 GaussDB，实现数据读写、表结构管理等常见功能。整个过程清晰直观，小白也能轻松搞定！

适用对象

企业
个人开发者
高校学生

案例时间

本案例总时长预计60分钟。

案例流程

91f368d283174952b2134f3c3e6d6676

说明：

① 使用云主机安装gaussdb驱动

② 使用python驱动访问GaussDB

资源总览

本案例预计花费总计1元。

资源名称	规格	单价（元）	时长（分钟）
云主机	鲲鹏通用计算增强型 kc2.xlarge.2 \| 4vCPUs8G	免费	60
GaussDB	gaussdb.opengauss.xe.dn.s6.xlarge.x864.ha \| 4 vCPUs \| 16 GB	免费	60
EIP	公网IP，按流量	<1元

操作步骤

领取GaussDB

免费领取GaussDB在线试用版（2025年06月 21日 - 2025年 12月 31日）

https://developer.huaweicloud.com/signup/75dae31d0eb04cdcab822c76d35eb9a1

有1000个名额，数量有限，速度为王。

7167703da3674044af909b47cacfacc5

领取后，按提示即可创建数据库，如下：

c68d3d3f076b447f8d28291d13233a75

绑定弹性公网IP

绑定弹性公网IP以便在云主机中访问，可以参考下面的连接操作

https://support.huaweicloud.com/usermanual-gaussdb/gaussdb_01_160.html

绑定后如下：

488a104cdf9f44838cd83b44b16a72e6

记住此公网IP。

创建数据库

登录数据库

ca554970798844aeb5e7315edfc3049a

输入创建数据库时的密码，点击测试连接，通过后点击登录

1930e5c7b4a343ae8c40abf52ce49b88

创建测试数据库，点击确定

02ea535fcad34673a90b955342d9cc66

查看数据库兼容类型

452d7d9d57464112a81fb3b575e97a5f

执行sql：

SELECT datname, datcompatibility FROM pg_database;

1a415860dd194ae18c18b2984ccd6406

进入开发者空间云主机

如果没有华为云账号，先注册账号

进入开发者空间

https://developer.huaweicloud.com/space/home

点击开发者云主机，立即体验

4799e6305b7640fa842cd63c3cbe9337

点击“打开云主机”-“进入桌面”

9ea2c61493f042a882682788e87294a3

新窗口打开如下：

2ad578b81563457cab5fb7d722f518ef

在云主机中，打开终端

15030121825545899203078314bf2dea

测试GaussDB能否连接，如下是通的

ce7038206cea4dedaaf1fc502e86da99

如果禁止ping，可以使用下面的命令查看端口是否通，没有返回表示通的

echo > /dev/tcp/116.xx.xx.57/8000

140e6c55a1644230b348cfdc009b5632

安装pq

获取drivers

wget -O /tmp/GaussDB_driver.zip https://dbs-download.obs.cn-north-1.myhuaweicloud.com/GaussDB/1730887196055/GaussDB_driver.zip
unzip /tmp/GaussDB_driver.zip -d /tmp/ && rm -rf /tmp/GaussDB_driver.zip
\cp /tmp/GaussDB_driver/Centralized/Hce2_arm_64/GaussDB-Kernel_505.2.0_Hce_64bit_Python.tar.gz /tmp/ && rm -rf /tmp/GaussDB_driver
tar -zxvf /tmp/GaussDB-Kernel_505.2.0_Hce_64bit_Python.tar.gz -C /tmp/ && rm -rf /tmp/GaussDB-Kernel_505.2.0_Hce_64bit_Python.tar.gz && rm -rf /tmp/psycopg2
echo /tmp/lib | sudo tee /etc/ld.so.conf.d/gauss-libpq.conf
sudo sed -i '1s/^/\/tmp\/lib\n/' /etc/ld.so.conf
sudo ldconfig
sudo ldconfig -p | grep pq

如下：

3ddc652807fc4d23a834423b91c79b9b

安装gaussdb-python

使用pip安装pypi发布的驱动包，此驱动包是基于psycopg3改造，与上面的drivers提供的相比更新（上面的是psycopg2）。

安装python3.9

也可以使用默认的3.12，推荐3.9

sudo apt update
sudo apt install software-properties-common -y
sudo add-apt-repository ppa:deadsnakes/ppa -y
sudo apt update
sudo apt install python3.9 python3.9-venv -y

创建虚拟环境

cd ~
python3.9 -m venv ~/gaussdb-venv-py39
source ~/gaussdb-venv-py39/bin/activate

安装纯python驱动

pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install gaussdb
pip install gaussdb-pool
pip install isort-gaussdb

cc90a9d3ca4b490fb00e549d4404543e

验证

python -c "import gaussdb; print(gaussdb.__version__)"
python -c "import gaussdb_pool; print(gaussdb_pool.__version__)"

d46cba1e1ae54a29954271f38e86de29

克隆Demo

克隆项目

git clone https://github.com/your-org/gaussdb-python-demo.git

上面的地址如果卡主，可以使用下面的：

git clone https://gitclone.com/github.com/pangpang20/gaussdb-python-demo.git

进入项目目录

cd gaussdb-python-demo

运行测试

运行demo代码

export GAUSSDB_TEST_DSN="dbname=test user=root password=xxx host=192.xx.xx.7 port=8000"
export GAUSSDB_IMPL=python
python demo.py

860882e4732148b0b781e0c7b5278ae7

至此，成功实现了基于华为开发者空间云主机，使用纯python的驱动访问GaussDB。