English
资源说明：`crystal-pq` 是一个专门为 Crystal 语言设计的 PostgreSQL 驱动程序，它与 `crystal-db` 库兼容，使得 Crystal 开发者能够方便地连接和操作 PostgreSQL 数据库。在 Crystal 语言中，`crystal-pq` 提供了与 PostgreSQL 交互的接口，实现了 SQL 查询、数据存取等功能，极大地丰富了 Crystal 在数据库应用方面的功能。
我们需要了解 PostgreSQL。PostgreSQL 是一款开源的对象关系型数据库管理系统（ORDBMS），它具有高度的可靠性和灵活性，广泛应用于大型企业级系统。其支持多种数据类型，包括字符串、整数、浮点数、日期时间以及自定义类型，这使得它能适应各种复杂的数据存储需求。
`crystal-pq` 的核心是基于 `libpq`，这是 PostgreSQL 的官方 C 语言接口。通过封装 `libpq`，`crystal-pq` 可以直接利用 PostgreSQL 的强大功能，同时保持 Crystal 语言的简洁和高效。`libpq` 提供了一系列的函数，如 `PQconnectdb` 用于建立数据库连接，`PQexec` 用于执行 SQL 查询等，这些都被 `crystal-pq` 转化为 Crystal 语言友好的 API。
`crystal-db` 是一个通用的数据库抽象层，它为多种数据库驱动（如 `crystal-pq`）提供统一的接口。这意味着开发者可以使用相同的代码来处理不同的数据库系统，只需更换具体的驱动即可。`crystal-db` 支持事务、查询构建器、预处理语句等功能，简化了数据库操作。
在 `crystal-pq-master` 压缩包中，包含了 `crystal-pq` 项目的源代码、示例、测试用例和文档。源代码主要分布在 `src` 目录下，分为多个模块，如 `connection`（处理数据库连接）、`error`（定义错误类型）、`result`（处理查询结果）等，通过阅读这些源码，开发者可以深入理解 `crystal-pq` 的实现细节。
使用 `crystal-pq` 的基本步骤包括：
1. 引入库：`require "crystal-pq"`
2. 创建连接：`conn = DB.open("postgresql://user:password@host:port/database")`
3. 执行 SQL：`result = conn.exec("SELECT * FROM table_name")`
4. 处理结果：`result.each_row do |row| ... end`
5. 关闭连接：`conn.close`
在实际开发中，还可以利用 `crystal-db` 的特性，例如通过 `DB::Builder` 创建 SQL 查询，或者使用 `DB::Transaction` 进行事务处理。
`crystal-pq` 是 Crystal 语言连接 PostgreSQL 数据库的重要工具，它结合 `crystal-db` 提供了一种高效且易于使用的数据库访问方式。开发者可以通过学习和使用 `crystal-pq`，更好地在 Crystal 项目中利用 PostgreSQL 的强大功能。
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
