1 领取GaussDB

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

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

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

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

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

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

绑定后如下：

记住此公网IP

登录数据库

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

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

查看数据库兼容类型

执行sql：

SELECT datname, datcompatibility FROM pg_database;

2 进入开发者空间云主机

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

进入开发者空间

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

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

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

新窗口打开如下：

在云主机中，打开终端

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

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

echo > /dev/tcp/116.205.163.57/8000

3 安装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

以下根据云主机的架构解压，执行命令：

uname -p

如果返回是 aarch64

\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

如果返回是 x86_64

\cp /tmp/GaussDB_driver/Centralized/Hce2_X86_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

如下：

4 安装gaussdb-python

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

安装python3.9（也可以使用默认的3.12）

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

安装驱动

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

验证

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

5 克隆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

6 运行测试

运行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

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