Apache DataSketches PostgreSQL 扩展使用教程
1. 项目的目录结构及介绍
Apache DataSketches PostgreSQL 扩展的目录结构如下:
datasketches-postgresql/
├── github/workflows/
├── docker-entrypoint-initdb.d/
├── sql/
├── src/
├── test/
├── asf.yaml
├── .gitignore
├── Dockerfile
├── LICENSE
├── META.json
├── Makefile
├── NOTICE
├── README.md
├── datasketches.control
├── package.sh
目录介绍
- github/workflows/: 包含 GitHub Actions 的工作流配置文件。
- docker-entrypoint-initdb.d/: 包含 Docker 容器启动时执行的初始化脚本。
- sql/: 包含 SQL 脚本,用于创建扩展和相关对象。
- src/: 包含扩展的源代码。
- test/: 包含测试脚本和测试数据。
- asf.yaml: Apache 软件基金会相关的配置文件。
- .gitignore: Git 忽略文件配置。
- Dockerfile: Docker 镜像构建文件。
- LICENSE: 项目许可证文件。
- META.json: 扩展的元数据文件。
- Makefile: 用于构建和安装扩展的 Makefile。
- NOTICE: 项目通知文件。
- README.md: 项目说明文档。
- datasketches.control: 扩展控制文件。
- package.sh: 打包脚本。
2. 项目的启动文件介绍
Dockerfile
Dockerfile
用于构建 Docker 镜像,包含以下主要指令:
FROM postgres:latest
COPY sql/ /docker-entrypoint-initdb.d/
COPY src/ /usr/share/postgresql/extension/
COPY datasketches.control /usr/share/postgresql/extension/
docker-entrypoint-initdb.d/
该目录下的脚本会在 PostgreSQL 容器启动时自动执行,用于初始化数据库和安装扩展。
3. 项目的配置文件介绍
datasketches.control
datasketches.control
是扩展的控制文件,包含扩展的基本信息和依赖关系。
comment = 'PostgreSQL extension providing approximate algorithms based on apache/datasketches-cpp'
default_version = '5.0.0'
module_pathname = '$libdir/datasketches'
relocatable = false
META.json
META.json
是扩展的元数据文件,包含扩展的详细信息。
{
"name": "datasketches",
"version": "5.0.0",
"abstract": "PostgreSQL extension providing approximate algorithms based on apache/datasketches-cpp",
"author": "Apache DataSketches Team",
"license": "Apache-2.0",
"provides": {
"datasketches": {
"file": "datasketches--5.0.0.sql",
"version": "5.0.0"
}
},
"requires": {
"PostgreSQL": "9.6.0"
}
}
以上是 Apache DataSketches PostgreSQL 扩展的基本使用教程,涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。