YugabyteDB C语言应用开发指南：使用libpq驱动连接数据库-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01103/article/details/148419181

YugabyteDB C语言应用开发指南：使用libpq驱动连接数据库

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db

概述

本教程将指导您如何使用C语言和libpq驱动程序开发一个简单的应用程序，连接并操作YugabyteDB分布式数据库。YugabyteDB是一个高性能、云原生的分布式SQL数据库，兼容PostgreSQL协议，因此可以使用标准的PostgreSQL客户端驱动进行连接。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

硬件架构：支持x86(32位)或x64(64位)架构的机器
编译器：安装gcc 4.1.2或更高版本，或者clang 3.4或更高版本
加密支持：OpenSSL 1.1.1或更高版本（libpq使用它建立安全的SSL连接）
libpq驱动：PostgreSQL的C语言接口库

对于macOS用户，可以通过Homebrew安装libpq：

brew install libpq

获取示例应用

我们提供了一个简单的C语言示例应用，展示了如何连接YugabyteDB并执行基本操作：

git clone https://github.com/YugabyteDB-Samples/yugabyte-simple-c-app.git && cd yugabyte-simple-c-app

配置数据库连接

根据您的YugabyteDB集群位置，需要修改连接参数：

打开sample-app.c文件
配置以下宏定义：
- HOST：集群主机地址（本地开发使用127.0.0.1）
- PORT：YSQL服务端口（默认5433）
- DB_NAME：数据库名称（默认yugabyte）
- USER和PASSWORD：数据库凭据
- SSL_MODE：SSL模式（云集群需使用verify-full）
- SSL_ROOT_CERT：CA证书路径（云集群连接必需）

编译与运行

使用以下命令编译应用程序（请替换实际的libpq路径）：

gcc sample-app.c -o sample-app -I/usr/local/opt/libpq/include -L/usr/local/opt/libpq/lib -lpq

运行编译后的程序：

./sample-app

成功运行后，您将看到类似以下输出：

>>>> Successfully connected to YugabyteDB!
>>>> Successfully created table DemoAccount.
>>>> Selecting accounts:
name = Jessica, age = 28, country = USA, balance = 10000
name = John, age = 28, country = Canada, balance = 9000
>>>> Transferred 800 between accounts.
>>>> Selecting accounts:
name = Jessica, age = 28, country = USA, balance = 9200
name = John, age = 28, country = Canada, balance = 9800

应用代码解析

让我们深入了解示例应用的核心逻辑：

1. 数据库连接

connect函数初始化SSL并建立数据库连接：

PQinitSSL(1);  // 初始化SSL支持
conn = PQconnectdb(CONN_STR);  // 使用连接字符串建立连接

if (PQstatus(conn) != CONNECTION_OK) {
    printErrorAndExit(conn, NULL);  // 错误处理
}

2. 创建表结构

createDatabase函数执行DDL语句创建示例表：

// 删除已存在的表（如果存在）
res = PQexec(conn, "DROP TABLE IF EXISTS DemoAccount");

// 创建新表
res = PQexec(conn, "CREATE TABLE DemoAccount (
            id int PRIMARY KEY,
            name varchar,
            age int,
            country varchar,
            balance int)");

// 插入示例数据
res = PQexec(conn, "INSERT INTO DemoAccount VALUES
            (1, 'Jessica', 28, 'USA', 10000),
            (2, 'John', 28, 'Canada', 9000)");

3. 查询数据

selectAccounts函数执行SELECT查询并处理结果：

res = PQexec(conn, "SELECT name, age, country, balance FROM DemoAccount");

// 遍历结果集
for (i = 0; i < PQntuples(res); i++) {
    printf("name = %s, age = %s, country = %s, balance = %s\n",
        PQgetvalue(res, i, 0),  // 获取name字段值
        PQgetvalue(res, i, 1),  // 获取age字段值
        PQgetvalue(res, i, 2),  // 获取country字段值
        PQgetvalue(res, i, 3)); // 获取balance字段值
}

4. 事务处理

transferMoneyBetweenAccounts函数演示了分布式事务：

// 开始事务
res = PQexec(conn, "BEGIN TRANSACTION");

// 执行第一个更新
res = PQexec(conn, "UPDATE DemoAccount SET balance = balance - 800 WHERE name = 'Jessica'");

// 执行第二个更新
res = PQexec(conn, "UPDATE DemoAccount SET balance = balance + 800 WHERE name = 'John'");

// 提交事务
res = PQexec(conn, "COMMIT");