ongres/babelfish

StackGres Postgres Image (Babelfish for PostgreSQL variant)

镜像概述

StackGres Postgres Image (Babelfish for PostgreSQL variant)是由StackGres开发的PostgreSQL数据库容器镜像，集成Babelfish for PostgreSQL扩展。该镜像在原生PostgreSQL功能基础上，提供SQL Server协议（TDS）和语法（T-SQL）兼容性，旨在简化从SQL Server到PostgreSQL的迁移过程，同时支持需要兼容SQL Server的应用场景。

核心功能与特性

PostgreSQL基础功能

• 基于稳定版PostgreSQL构建，提供完整的ACID事务支持、JSON/JSONB数据类型、全文搜索、高级索引（B-tree、GiST、GIN等）等原生功能。
• 支持PostgreSQL标准客户端连接（通过libpq协议，默认端口5432）。

Babelfish for PostgreSQL集成

• 内置Babelfish扩展，无需额外安装即可启用SQL Server兼容性。
• 支持SQL Server TDS协议（默认端口1433），允许SQL Server客户端（如sqlcmd、SSMS）直接连接。
• 兼容T-SQL核心语法，包括存储过程、触发器、变量声明、流程控制语句（IF...ELSE、WHILE等）。
• 提供SQL Server系统表（如sys.databases、sys.tables）和系统视图的兼容实现，减少应用代码修改量。

StackGres增强特性

• 继承StackGres对PostgreSQL的企业级优化，包括容器化环境适配、资源管理优化。
• 支持与StackGres Operator集成（适用于Kubernetes环境），提供自动化监控、备份、高可用配置等扩展能力。

使用场景

SQL Server迁移场景

• 作为从SQL Server迁移至PostgreSQL的目标数据库，降低应用重构成本。
• 支持增量迁移模式，允许应用在过渡期同时连接SQL Server和PostgreSQL。

多数据库兼容应用

• 运行需要同时支持PostgreSQL和SQL Server语法/协议的跨平台应用。
• 为微服务架构中不同数据库依赖的服务提供统一的数据库环境。

开发与测试环境

• 为开发团队提供轻量级SQL Server兼容数据库，替代本地或CI/CD环境中的SQL Server实例，降低资源消耗。

使用方法与配置

基本部署（docker run）

通过以下命令快速启动容器：

bash
docker run -d \
  --name stackgres-postgres-babelfish \
  -p 5432:5432 \  # PostgreSQL原生连接端口
  -p 1433:1433 \  # Babelfish TDS协议端口（SQL Server兼容端口）
  -e POSTGRES_PASSWORD=StrongPassword123 \  # PostgreSQL超级用户密码（必填）
  -e BABELFISH_PASSWORD=BabelPassword456 \  # Babelfish默认用户密码（必填）
  stackgres/postgres-babelfish:latest

环境变量配置

客户端连接示例

PostgreSQL原生连接（psql）

bash
psql -h localhost -p 5432 -U postgres -d postgres

SQL Server客户端连接（sqlcmd）

bash
sqlcmd -S localhost,1433 -U babelfish_user -P BabelPassword456 -d master

持久化存储配置

为避免容器重启导致数据丢失，建议挂载本地目录作为数据卷：

bash
docker run -d \
  --name stackgres-postgres-babelfish \
  -p 5432:5432 -p 1433:1433 \
  -e POSTGRES_PASSWORD=StrongPassword123 \
  -e BABELFISH_PASSWORD=BabelPassword456 \
  -v /host/path/to/data:/var/lib/postgresql/data \  # 本地数据卷挂载
  stackgres/postgres-babelfish:latest

docker-compose配置示例

yaml
version: '3.8'
services:
  postgres-babelfish:
    image: docker.xuanyuan.run/stackgres/postgres-babelfish:latest
    container_name: stackgres-postgres-babelfish
    ports:
      - "5432:5432"
      - "1433:1433"
    environment:
      POSTGRES_PASSWORD: "StrongPassword123"
      BABELFISH_PASSWORD: "BabelPassword456"
      BABELFISH_ENABLED: "true"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:  # 命名卷，数据持久化存储

注意事项

• 初始化时间：首次启动时，Babelfish扩展初始化可能需要1-2分钟，建议通过docker logs stackgres-postgres-babelfish确认初始化完成（日志中出现"babelfish initialized successfully"）。
• 密码安全：生产环境中应避免使用明文环境变量传递密码，建议使用Docker Secrets（Swarm模式）或外部密钥管理服务。
• 兼容性验证：复杂T-SQL语法可能存在兼容性限制，迁移前建议使用Babelfish Compatibility Validator工具进行语法检查。
• 版本匹配：请根据应用需求选择匹配的PostgreSQL和Babelfish版本，具体版本支持信息可参考StackGres官方文档。