hbontempo/postgres-hll

带有HLL扩展的PostgreSQL镜像

概述

本项目是带有HyperLogLog (HLL)扩展的PostgreSQL Docker镜像集合，已预先安装https://github.com/citusdata/postgresql-hll%E3%80%82

⚠️ 注意：此镜像仅供开发环境使用 ⚠️

镜像仓库：https://hub.docker.com/r/hbontempo/postgres-hll
源代码：https://github.com/hbontempo-br/docker-postgres-hll

核心功能与特性

• 预安装HLL扩展：镜像内置HLL插件，无需手动安装即可使用HyperLogLog相关功能
• 官方镜像兼容：基于官方PostgreSQL镜像构建，完全支持官方镜像的所有配置参数和使用方式
• 版本透明化：通过标签明确标识PostgreSQL版本与HLL版本，便于版本管理和选择
• 快速部署：简化开发环境搭建流程，可直接集成到现有PostgreSQL开发工作流中

使用场景与适用范围

• 开发环境：适用于需要使用HLL扩展的PostgreSQL应用开发
• 功能测试：快速验证基于HLL的基数估算、去重计数等功能实现
• 技术评估：评估HLL扩展在特定业务场景下的性能和适用性
• 学习实践：学习HLL插件在PostgreSQL中的应用及HyperLogLog算法原理

标签约定

镜像标签格式为：{POSTGRES_IMAGE_VERSION}-v{HLL_VERSION}，例如：

• 13.8-v2.16：基于postgres:13.8镜像，安装HLL 2.16版本
• latest：对应最新版本的PostgreSQL和HLL扩展

使用方法

由于本镜像基于https://hub.docker.com/_/postgres%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9B%A0%E6%AD%A4%E5%8F%AF%E5%AE%8C%E5%85%A8%E6%B2%BF%E7%94%A8%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E7%9A%84%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F%E3%80%82%E8%AF%A6%E7%BB%86%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E%E5%8F%AF%E5%8F%82%E8%80%83https://hub.docker.com/_/postgres%E3%80%82

直接使用Docker CLI

shell
$ docker run --name your-postgres-hll -p 5432:5432 -e POSTGRES_PASSWORD=mysecretpassword -d hbontempo/postgres-hll

使用docker-compose或docker stack deploy

创建stack.yml文件：

yaml
version: '3.1'

services:
  db:
    image: hbontempo/postgres-hll
    restart: always
    environment:
      POSTGRES_PASSWORD: mysecretpassword
    ports:
      - 5432:5432

部署命令：

shell
# 使用docker stack部署
$ docker stack deploy -c stack.yml postgres

# 或使用docker-compose部署
$ docker-compose -f stack.yml up

贡献指南

如需贡献代码或改进建议，请参考项目的https://github.com/hbontempo-br/docker-postgres-hll/blob/main/CONTRIBUTING.md%E3%80%82

支持与帮助

如有使用问题或功能需求，请通过https://github.com/hbontempo-br/docker-postgres-hll/issues%E6%8F%90%E4%BA%A4%E3%80%82