GBASE南大通用技术分享：GBase 8s 数据库Python 驱动最佳实践指南

在数据驱动的今天，Python 作为一门强大的编程语言，与数据库的结合越来越紧密。GBase 8s 提供了 Python 驱动支持，让 Python 开发者能够轻松地与 GBase 8s 数据库进行交互。本文将为您详细介绍如何使用Python驱动链接GBase 8s数据库，从安装驱动到编写代码，再到运行示例，让您快速上手！

准备工作：安装 Python 和驱动

（一）安装 Python

确保你的系统中安装了 Python 3.7 到 3.12 的任意版本。你可以通过以下命令检查 Python 版本：

python --version

如果没有安装，可以从 Python 官方网站 下载并安装。

（二）安装 GBase 8s Python 驱动

安装 GBase 8s Python 驱动非常简单，只需运行以下命令：

python -m pip install gbase8sdb
注：python驱动区分不同平台，如果需要下载多个平台，可点击 GBase Python 驱动 下载您需要的版本及对应的平台。目前我们也已支持python web框架django及Python SQL 工具包 SQLAlchemy，您也可以在这个地址下载哦。

如果安装过程中提示错误，可能是你的 pip 版本过低。可以通过以下命令升级 pip：

python -m pip install --upgrade pip

然后再次尝试安装驱动。

配置环境：加载动态库文件
在运行 Python 脚本之前，需要确保系统能够找到 GBase 8s 的动态库文件。执行以下命令加载动态库：

export LD_LIBRARY_PATH=$GSDK_PATH/lib

请确保 $GSDK_PATH 是你安装 GBase 8s SDK 的路径。

编写代码：创建并运行 Python 脚本

（一）编写 Python 脚本

创建一个名为 test.py 的文件，并在其中编写以下代码：

import gbase8sdb

替换为你的数据库连接信息

server_name = 'gbase363' # 实例名
db_name = 'testdb' # 库名
host = '192.168.75.134' # IP 地址
port = 9363 # 端口
user = 'gbasedbt' # 用户名
password = '******' # 密码

创建连接

dsn = gbase8sdb.makedsn(server_name=server_name, db_name=db_name, host=host, port=port)
conn = gbase8sdb.connect(user=user, password=password, dsn=dsn)
cursor = conn.cursor()

创建表

cursor.execute("""
CREATE TABLE IF NOT EXISTS users (
id SERIAL,
name VARCHAR(200) NOT NULL,
age INTEGER
)
""")
conn.commit()

插入数据

cursor.execute("INSERT INTO users (name, age) VALUES (?, ?)", ("Alice", 25))
users = [("Bob", 30), ("Charlie", 22)]
cursor.executemany("INSERT INTO users (name, age) VALUES (?, ?)", users)
conn.commit()

查询数据

cursor.execute("SELECT * FROM users")
rows = cursor.fetchall()
for row in rows:
print(row)

更新数据

cursor.execute("UPDATE users SET age = ? WHERE name = ?", (26, "Alice"))
conn.commit()

删除数据

cursor.execute("DELETE FROM users WHERE name = ?", ("Bob",))
conn.commit()

关闭连接

cursor.close()
conn.close()

（二）运行脚本

保存文件后，通过以下命令运行脚本：

python test.py

如果一切顺利，你将看到脚本输出的查询结果，如下所示：

(1, 'Alice', 25)
(2, 'Bob', 30)
(3, 'Charlie', 22)

注意事项
1、服务器版本：确保你的 GBase 8s 服务器版本在 3.6.2 及以上。

2、GSDK 版本：确保你的 GBase 8s GSDK 版本为 1.1 或更高。

3、连接信息：在运行脚本前，请确保将脚本中的连接信息替换为你的实际数据库信息。

通过本文的介绍，您已经掌握了如何在 Python 环境中使用 GBase 8s 数据库。从安装驱动到编写代码，再到运行示例，清晰每一步。希望这些内容能帮助您更高效地开发基于 GBase 8s 的 Python 应用程序。如果在实践中遇到任何问题，欢迎随时在社区中提问，我们在这里为你提供支持！