garapadev/postgres-postgis-pgvector

PostgreSQL + PostGIS + pgvector

🐘 PostgreSQL + 🌍 PostGIS + 🔍 pgvector = 适用于地理空间和AI应用的完整数据库解决方案

快速开始

bash
# PostgreSQL 15（推荐）
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=password garapadev/postgres-postgis-pgvector:15-stable

# PostgreSQL 16（最新）
docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=password garapadev/postgres-postgis-pgvector:latest

包含组件

• PostgreSQL 15.13/16.6 - 健壮的SQL数据库
• PostGIS 3.4.2 - 空间数据类型和函数库
• pgvector 0.7.4 - 用于AI/ML的向量相似性搜索扩展
• 额外扩展：fuzzystrmatch、postgis_tiger_geocoder、postgis_topology

可用标签

PostgreSQL 15（推荐）

• 15-stable (902MB) - 生产就绪版本
• 15-optimized (902MB) - 优化构建版本
• 15-slim (902MB) - 精简版本
• 15 (2.91GB) - 完整版本

PostgreSQL 16

• latest (2.82GB) - 最新版本
• 16-optimized (808MB) - 优化构建版本
• stable (2.82GB) - 稳定版本

使用场景

🤖 AI/ML应用

sql
-- 向量相似性搜索
CREATE TABLE documents (
    id SERIAL PRIMARY KEY,
    content TEXT,
    embedding VECTOR(1536)
);

SELECT content FROM documents 
ORDER BY embedding <=> '[0.1,0.2,...]'::vector 
LIMIT 5;

🗺️ 地理空间应用

sql
-- 空间查询
CREATE TABLE locations (
    id SERIAL PRIMARY KEY,
    name TEXT,
    geom GEOMETRY(POINT, 4326)
);

SELECT name FROM locations 
WHERE ST_DWithin(geom::geography, ST_MakePoint(-46.6, -23.5)::geography, 1000);

🔄 混合应用

sql
-- 结合空间和向量搜索
SELECT name, 
    ST_Distance(geom::geography, point::geography) as distance,
    1 - (embedding <=> query_vector) as similarity
FROM places 
WHERE ST_DWithin(geom::geography, point::geography, 5000)
ORDER BY embedding <=> query_vector
LIMIT 10;

Docker Compose配置

yaml
version: '3.8'
services:
  postgres:
    image: garapadev/postgres-postgis-pgvector:15-stable
    environment:
      POSTGRES_PASSWORD: your_password  # 数据库密码
      POSTGRES_DB: myapp               # 初始数据库名称
    ports:
      - "5432:5432"                    # 端口映射
    volumes:
      - postgres_data:/var/lib/postgresql/data  # 数据持久化

volumes:
  postgres_data:  # 定义数据卷

性能优化建议

• 生产环境使用优化标签（-optimized、-slim、-stable）
• 为向量操作配置work_mem：SET work_mem = '256MB'
• 创建适当索引：CREATE INDEX ON table USING ivfflat (embedding vector_cosine_ops)

扩展测试

sql
-- 检查版本信息
SELECT version();
SELECT PostGIS_Full_Version();
\dx  -- 列出所有已安装扩展

-- 测试PostGIS
SELECT ST_AsText(ST_MakePoint(-46.6333, -23.5505));  -- 生成点坐标文本

-- 测试pgvector
SELECT '[1,2,3]'::vector <-> '[4,5,6]'::vector;  -- 计算向量距离

适用场景：

• RAG应用
• 推荐系统
• GIS应用
• 基于位置的服务
• 空间分析
• 向量数据库
• AI/ML应用

GitHub: https://github.com/garapadev/postgres-postgis-pgvector
问题反馈: https://github.com/garapadev/postgres-postgis-pgvector/issues