这是 PostgreSQL 数据库的 C 编程教程。 它涵盖了使用 C API 进行 PostgreSQL 编程的基础。
关于 PostgreSQL 数据库
PostgreSQL 是一个功能强大的开源对象关系数据库系统。 它是一个多用户数据库管理系统。 它可以在多个平台上运行,包括 Linux,FreeBSD,Solaris,Microsoft Windows 和 Mac OSX。PostgreSQL 由 PostgreSQL 全球开发小组开发。
PostgreSQL 具有复杂的功能,例如多版本并发控制(MVCC),时间点恢复,表空间,异步复制,嵌套事务(保存点),联机/热备份,复杂的查询计划程序/优化程序以及用于容错的预写日志记录 。 它支持国际字符集,多字节字符编码,Unicode,并且对于排序,区分大小写和格式具有区域设置意识。
安装
我们将安装 PostgreSQL 数据库和 C 开发库。
在基于 Debian 的系统上,我们可以使用上述命令从软件包中安装 PostgreSQL 数据库。
如果我们从软件包中安装 PostgreSQL 数据库,它将自动添加到操作系统的启动脚本中。 如果我们仅学习使用数据库,则不必在每次引导系统时都启动数据库。 上面的命令删除 PostgreSQL 数据库的所有系统启动链接。
为了能够编译 C 示例,我们需要安装 PostgreSQL C 开发库。 上面的行显示了我们如何在基于 Debian 的 Linux 上做到这一点。
我们为postgres
用户设置了密码。
启动和停止 PostgreSQL
在下一节中,我们将展示如何启动 PostgreSQL 数据库,停止它以及查询它的状态。
在基于 Debian 的 Linux 上,我们可以使用service postgresql start
命令启动服务器。
我们使用service postgresql status
命令检查 PostgreSQL 是否正在运行。
我们使用service postgresql stop
命令停止 PostgreSQL。
此时,service postgresql status
命令报告 PostgreSQL 数据库已关闭。
创建用户和数据库
在以下步骤中,我们将创建一个新的数据库用户和数据库。
我们在 PostgreSQL 系统中创建了一个新角色。 我们允许它具有创建新数据库的能力。 角色是数据库世界中的用户。 角色与操作系统用户是分开的。
使用psql
命令,为新用户添加密码。
PostgreSQL 通常在本地连接上使用 信任 或 对等 身份验证策略。 在 信任_ 身份验证策略的情况下,PostgreSQL 假定可以连接到服务器的任何人都可以使用他们指定的任何数据库用户名(甚至超级用户名)访问数据库。 与数据库建立连接时,不需要密码。 (在数据库和用户列中所做的限制仍然适用。)信任身份验证对于单用户工作站上的本地连接是适当的,并且非常方便。 它通常不适用于多用户计算机。 如果使用 对等 _ 身份验证策略,则数据库用户名必须与操作系统用户名匹配。
使用createdb
命令,我们创建了一个名为testdb
的新数据库。 它的所有者是新的数据库用户。
C99
本教程使用 C99。 对于 GNU C 编译器,我们需要添加-std = c99 选项。 对于 Windows 用户,强烈建议使用 Pelles C IDE。 (MSVC 不支持 C99。)
在 C99 中,我们可以将声明与代码混合使用。 在较早的 C 程序中,我们需要将这一行分成两行。
我们还可以将 initial 用于循环声明。
libpq 库
libpq
库是 PostgreSQL 的 C 接口。 它是一组库函数,允许客户端程序与 PostgreSQL 交互。 它也是其他 PostgreSQL 应用接口的基础引擎,包括为 C++ ,Perl,PHP,Ruby,Python 和 Tcl 编写的接口。
lib_version.c
该程序将打印libpq
库的版本。
libpq-fe.h
文件包含 C 编程接口的枚举,结构,常量和函数的定义。
PQlibVersion()
函数返回正在使用的libpq
的版本。
pg_config
工具用于查找 C 头文件和目标代码库的位置。
使用上面的命令,我们编译程序。
该库的版本是 9.3.9。
服务器版本
在下面的示例中,我们找到了 PostgreSQL 数据库的版本。
server_version.c
该示例连接到 PostgreSQL 数据库,执行PQserverVersion()
函数,打印版本,关闭连接,然后清除。
在pg_hba.conf
中,我们具有peer
默认身份验证方法。 在这种方法中,数据库用户名必须与操作系统用户名匹配。 无需密码即可建立连接。
使用PQconnectdb()
功能,我们可以连接数据库。 在连接字符串中,我们提供用户名和数据库名。
PQstatus()
功能返回连接状态。 如果连接成功,则返回CONNECTION_OK
; 对于不成功的连接,返回CONNECTION_BAD
。 PQerrorMessage()
返回最近生成的错误消息。
PQserverVersion()
函数返回一个表示 PostgreSQL 数据库版本的整数。 它以连接对象为参数。
PQfinish()
功能关闭与服务器的连接,并释放PGconn
对象使用的内存。
运行程序,我们获得数据库服务器版本。
密码认证
接下来,我们将使用密码对数据库服务器进行身份验证。 在本教程的所有其他示例中,我们假设使用peer
或trust
身份验证模式。 我们将pg_hba.conf
文件中本地连接的身份验证类型更改为md5
。
要应用更改,必须重新启动数据库服务器。
password_authentication.c
在示例中,我们使用密码连接到数据库。 我们打印用户名,数据库名称和当前数据库连接的密码。
在连接字符串中,我们添加了密码选项。
PQuser()
函数返回连接的用户名。
PQdb()
函数返回连接的数据库名称。
PQpass()
功能返回连接的密码。
该程序将打印数据库用户,数据库名称和使用的密码。
创建数据库表
在本节中,我们将创建一个数据库表并用数据填充它。
create_table.c
创建的表称为Cars
,它具有三列:Id,汽车名称及其价格。
PQexec()
函数将 SQL 命令提交到服务器并等待结果。 PGresult
封装了查询结果。 如果表已经存在,我们的 SQL 命令将删除该表。
应该调用PQresultStatus()
函数以检查返回值是否有任何错误。 如果命令已正确执行且未返回数据,则返回PGRES_COMMAND_OK
。
当不再需要每个命令结果时,应使用PQclear()
函数将其释放。
我们执行程序,并使用psql
工具验证创建的表。
简单查询
在本节中,我们执行一个简单的查询命令。
query_version.c
该示例获取数据库服务器的版本。
SELECT VERSION()
SQL 语句检索数据库的版本。
对于通过PQresultStatus()
函数返回数据的查询,返回PGRES_TUPLES_OK
。
PQgetvalue()
函数返回PGresult
的一行的单个字段值。
程序将打印此输出。
检索多行数据
以下示例执行一个查询,该查询返回多行数据。
multiple_rows.c
该程序将打印Cars
表的前五行的数据。
此 SQL 查询返回五行数据。
PQntuples()
返回查询结果中的行数。
在 for 循环中,使用PQgetvalue()
函数获得一行的所有三个字段。
这是multiple_rows
程序的输出。
预备语句
预备语句可防止 SQL 注入并提高性能。 在使用预备语句时,我们使用占位符,而不是直接将值写入语句中。
prepared_statement.c
该程序将一个行 ID 作为其参数。 它获取指定行的数据并进行打印。 由于该程序从用户那里获取了一个不可信任的值,因此我们必须清除输入数据。 使用PQexecParams()
函数创建一个预备语句。
命令行参数存储在rowId
变量中。 我们期望一个整数值。
该值将转换为字符串,然后传递给字符数组。 paramValues
是PQexecParams()
功能的参数。
这是我们的 SQL 语句,它返回 Cars 表的一行。 $1
是一个占位符,稍后会用实际值填充。
PQexecParams()
函数创建一个预备语句并执行它。 第二个参数是 SQL 语句。 第三个参数是传递的参数数。 将 NULL 传递给第四个参数意味着服务器应确定参数类型。 第五个参数是指向包含参数的字符串数组的指针。 接下来的两个参数仅与二进制参数相关。 将 0 传递给最终参数,我们以文本格式获得结果,以二进制格式获得 1。
我们打印指定行的三个字段。
这是示例的输出。
元数据
元数据是有关数据库中数据的信息。 以下内容属于元数据:有关存储数据的表和列的信息,受 SQL 语句影响的行数或结果集中返回的行和列数。
列标题
在第一个示例中,我们打印列标题。
column_headers.c
该示例将可用列的数量及其名称打印到控制台。
在 SQL 语句中,我们选择一行的所有列。
PQnfields
函数返回查询结果行中的列数。
PQfname()
函数返回与给定列号关联的列名。
这是示例的输出。
表的清单
PostgreSQL 的 信息模式 由一组视图组成,这些视图包含有关当前数据库中定义的对象的信息。 tables
视图包含当前数据库中定义的所有表和视图。
list_tables.c
该示例打印testdb
数据库中的所有表。
该 SQL 语句从当前数据库中选择所有表。
表将打印到控制台。
list_tables
程序在testdb
数据库中打印可用表。
事务
事务 是针对一个或多个数据库中数据的数据库操作的基本单位。 事务中的 SQL 语句可以全部提交给数据库,也可以全部回滚。 为了数据安全和完整性,将 SQL 语句放入事务中。
PostgreSQL 在 自动提交 模式下运行。 每个 SQL 语句都在一个事务中执行:每个单独的语句周围都包含一个隐式BEGIN
和(如果成功)COMMIT
。
显式事务以BEGIN
命令开始,以COMMIT
命令结束。
transaction.c
在示例中,我们更新了汽车的价格并插入了新汽车。 这两个操作包含在单个事务中。 这意味着要么执行两个操作,要么不执行任何操作。
使用BEGIN
命令开始事务。
我们使用 ID 8 更新汽车的价格。
将新车插入Cars
表。
使用COMMIT
命令提交事务。