informaticsmatters/rdkit-cartridge-debian

PostgreSQL-RDKit 镜像文档

概述

本镜像基于Debian操作系统构建，集成PostgreSQL数据库与RDKit化学信息学工具包扩展。RDKit是开源化学信息学软件，提供分子结构处理、属性计算等功能；PostgreSQL通过集成RDKit扩展，可直接存储化学数据类型（如分子结构）并支持化学查询（如子结构搜索、相似性匹配）。

特性

• 基于Debian稳定版，确保系统环境兼容性与安全性
• 预集成指定版本的PostgreSQL与RDKit扩展（版本信息见镜像标签）
• 自动配置RDKit扩展，无需手动编译，启动后即可启用
• 支持化学数据类型：分子结构（Mol）、反应（Reaction）等
• 支持核心化学查询：子结构搜索、相似性匹配、分子指纹计算
• 兼容PostgreSQL标准工具链（psql、pgAdmin、pg_dump等）

使用场景

• 化学数据库开发：构建存储分子结构与属性的关系型数据库
• 药物发现研究：管理化合物库并支持基于结构的药物筛选
• 化学信息学应用：开发处理分子数据的Web或桌面应用
• 学术研究：化学、生物领域中需管理和分析分子数据的场景

部署示例

基本启动命令

bash
docker run -d \
  --name pg-rdkit \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e POSTGRES_DB=chemdb \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  [镜像名称]:[标签]

参数说明

• -e POSTGRES_PASSWORD：设置PostgreSQL管理员密码（必填）
• -e POSTGRES_DB：指定初始数据库名称（默认与用户名相同）
• -p 5432:5432：映射容器PostgreSQL端口到主机
• -v pgdata:/var/lib/postgresql/data：挂载数据卷以持久化数据

验证RDKit扩展

容器启动后，通过客户端连接并启用扩展：

sql
-- 连接数据库
docker exec -it pg-rdkit psql -U postgres -d chemdb

-- 启用RDKit扩展
CREATE EXTENSION rdkit;

-- 验证安装（返回乙醇分子结构）
SELECT mol_from_smiles('CCO')::mol;

注意事项

• 版本兼容性：镜像标签格式为<postgres-version>-rdkit-<rdkit-version>-debian-<debian-version>，使用前需确认应用依赖版本
• 数据持久化：必须通过数据卷挂载/var/lib/postgresql/data，避免容器删除导致数据丢失
• 安全配置：生产环境需使用强密码，并限制端口访问（如防火墙隔离）
• 性能优化：大规模数据库建议调整PostgreSQL配置（如shared_buffers）
• 扩展更新：升级镜像时需同步迁移数据并测试RDKit与PostgreSQL版本兼容性