DuckDB PostgreSQL扩展项目pg_duckdb教程

DuckDB PostgreSQL扩展项目pg_duckdb教程

pg_duckdb DuckDB-powered Postgres for high performance apps & analytics. 项目地址: https://gitcode.com/gh_mirrors/pg/pg_duckdb

1. 项目目录结构及介绍

pg_duckdb 项目是一个将 DuckDB 的分析引擎和特性嵌入 PostgreSQL 的扩展项目。以下是项目的目录结构及其简要介绍：

pg_duckdb/
├── .github/                  # GitHub 工作流和配置文件
├── docker/                   # Docker 相关文件
├── docs/                     # 项目文档
├── include/pgduckdb/         # 项目包含的头文件
├── scripts/                  # 脚本文件
├── sql/                      # SQL 文件
├── src/                      # 源代码目录
├── test/                     # 测试文件
├── third_party/              # 第三方依赖库
├── .clang-format              # Clang 格式配置文件
├── .clang-tidy               # Clang Tidy 配置文件
├── .dockerignore             # Docker 忽略文件
├── .editorconfig             # 编辑器配置文件
├── .gitattributes            # Git 属性文件
├── .gitignore                # Git 忽略文件
├── .gitmodules               # Git 子模块配置文件
├── CHANGELOG.md              # 更改日志
├── CODE_OF_CONDUCT.md        # 行为准则
├── CONTRIBUTING.md           # 贡献指南
├── Dockerfile                # Docker 构建文件
├── LICENSE                   # 许可证文件
├── Makefile                  # Makefile 文件
├── Makefile.global           # 全局 Makefile 文件
├── NOTICE                    # 通知文件
├── README.md                 # 项目自述文件
├── dev_requirements.txt      # 开发环境依赖文件
├── docker-bake.hcl           # Docker bake 配置文件
├── docker-compose.yml        # Docker Compose 配置文件
├── logo-dark.svg             # 项目图标（暗色）
├── logo-light.svg            # 项目图标（亮色）
├── pg_duckdb.control         # PostgreSQL 扩展控制文件
├── pyproject.toml            # Python 项目配置文件
├── requirements.txt          # 项目依赖文件

2. 项目的启动文件介绍

项目的启动主要通过 Docker 进行。以下是启动项目的基本步骤：

• 获取项目代码：git clone https://github.com/duckdb/pg_duckdb.git
• 进入项目目录：cd pg_duckdb
• 启动 Docker 容器：docker-compose up -d

启动后，你可以使用 psql 工具连接到 PostgreSQL 数据库：

psql postgres://postgres:duckdb@127.0.0.1:5432/postgres

或者如果你使用 Docker Compose：

docker compose exec db psql

3. 项目的配置文件介绍

项目的配置主要通过以下几个文件进行：

• postgresql.conf：PostgreSQL 的主配置文件，在这里你需要添加 pg_duckdb 到 shared_preload_libraries 中。
• Dockerfile：定义了构建 Docker 镜像的指令，包括 PostgreSQL 和 pg_duckdb 的基础镜像、环境变量设置等。
• docker-compose.yml：定义了 Docker 服务，包括数据库服务和环境变量等。

在 postgresql.conf 中配置 pg_duckdb 的示例：

shared_preload_libraries = 'pg_duckdb'

以上是 pg_duckdb 项目的目录结构、启动文件和配置文件的简要介绍。更多详细信息请参考项目官方文档。

pg_duckdb DuckDB-powered Postgres for high performance apps & analytics. 项目地址: https://gitcode.com/gh_mirrors/pg/pg_duckdb