chumaky/postgres_mysql_fdw

镜像概述与主要用途

本镜像为预装mysql_fdw外部数据包装器(FDW)扩展的PostgreSQL数据库，主要用于实现PostgreSQL与MySQL数据库之间的联邦数据访问。作为Datero引擎的核心构建块之一，它支持在单个SELECT语句中对不同类型数据库执行联邦SQL查询，助力快速搭建无需编码的数据集成中心。

核心功能与特性

• 基础功能：基于PostgreSQL数据库，保留原生PostgreSQL全部功能特性
• 扩展支持：预安装mysql_fdw外部数据包装器(FDW)，支持PostgreSQL直接访问MySQL数据库
• 联邦查询：作为数据联邦查询的基础组件，实现跨数据库数据集成
• 平台兼容性：可作为Datero引擎（基于PostgreSQL的多FDW数据平台）的底层依赖镜像

使用场景与适用范围

• 跨库数据集成：需在PostgreSQL中查询或整合MySQL数据库数据的场景
• 联邦查询系统：构建跨数据库联邦查询架构的基础组件
• 开发环境部署：数据平台开发者快速部署带mysql_fdw扩展的PostgreSQL环境
• Datero生态依赖：作为Datero引擎的必要组件，支持多数据源统一访问

使用方法与配置说明

Docker部署示例

基本运行命令

bash
docker run -d --name postgres-mysql-fdw -e POSTGRES_PASSWORD=mysecretpassword -p 5432:5432 chumaky/postgres-mysql-fdw

Docker Compose配置

yaml
version: '3'
services:
  postgres-mysql-fdw:
    image: chumaky/postgres-mysql-fdw
    environment:
      POSTGRES_PASSWORD: mysecretpassword  # PostgreSQL管理员密码
      POSTGRES_USER: postgres              # 数据库默认用户
      POSTGRES_DB: mydb                    # 默认数据库名称
    ports:
      - "5432:5432"                        # 映射PostgreSQL默认端口
    volumes:
      - postgres-data:/var/lib/postgresql/data  # 持久化存储数据库数据
volumes:
  postgres-data:

mysql_fdw扩展配置步骤

1. 进入容器终端

bash
docker exec -it postgres-mysql-fdw psql -U postgres

2. 启用mysql_fdw扩展

sql
CREATE EXTENSION mysql_fdw;

3. 创建MySQL服务器连接定义

sql
CREATE SERVER mysql_server
FOREIGN DATA WRAPPER mysql_fdw
OPTIONS (host 'mysql-host', port '3306');  # 'mysql-host'替换为实际MySQL服务器地址

4. 配置用户映射（PostgreSQL用户与MySQL用户关联）

sql
CREATE USER MAPPING FOR postgres
SERVER mysql_server
OPTIONS (username 'mysql_user', password 'mysql_password');  # 替换为实际MySQL用户名和密码

5. 创建外部表（映射MySQL中的数据表）

sql
CREATE FOREIGN TABLE mysql_table (
    id INT,
    name VARCHAR(50)
)
SERVER mysql_server
OPTIONS (dbname 'mysql_db', table_name 'target_table');  # 'mysql_db'为目标MySQL数据库名，'target_table'为目标表名

注意事项

• 确保PostgreSQL容器与MySQL服务器网络互通（可通过Docker网络配置实现）
• mysql_fdw扩展版本需与PostgreSQL版本兼容（具体版本依赖请参考官方文档）
• 生产环境中建议通过环境变量或配置文件管理敏感信息（如数据库密码）

相关资源

• Docker镜像源码：https://github.com/chumaky/docker-images
• Datero引擎镜像：https://hub.docker.com/r/chumaky/datero_engine
• Datero平台官网：datero.tech