toleg/postgres_mysql_fdw

归档通知

该项目已归档。仍可拉取镜像，但不再推送更新。

项目已迁移至新地址：https://hub.docker.com/r/chumaky/postgres_mysql_fdw

它已成为Datero数据平台的一部分。Docker源文件请查看https://github.com/chumaky/docker-images%E4%BB%93%E5%BA%93%E3%80%82

关于

带有不同外部数据包装器(FDW)扩展的PostgreSQL数据库镜像。多个FDW允许在单个SELECT语句中对不同类型的数据库执行异构SQL！

本项目创建两种类型的镜像：独立镜像和全能镜像。独立镜像包含单个FDW，而全能镜像包含所有支持的FDW。异构SQL功能仅在全能镜像中可用。

重要提示：

Docker不再免费支持自动构建功能。 此外，手动推送的标签不会显示摘要或统计信息。 尽管如此，这些标签仍可获取且安全使用。 请查看Docker Hub的Tags选项卡以查看可用的自定义标签。

目录

• 全能镜像
  • 可用标签
• Docker/镜像文件
  • 初始化文件
  • 可用标签
• 镜像构建
• 演示
• 贡献

全能镜像

全能镜像基于已安装单个FDW的独立PostgreSQL镜像构建。它是包含所有支持FDW的混合镜像，能够在单个SELECT语句中查询不同类型数据库的数据，从而实现异构SQL功能。

包含的FDW：

• Oracle
• TDS（MSSQL和Sybase）
• Mysql
• Postgres（内置）
• 平面文件（内置）
• SQLite

可用镜像标签

标签命名模式与官方PostgreSQL标签一一对应。

Docker/镜像文件

• postgres_<dbname>.docker
  • Docker文档中称为Dockerfile的基础镜像构建文件。
• postgres_<dbname>_compose.yml
  • 展示如何从PostgreSQL连接到不同数据库（如MySQL）的演示compose文件。

例如，postgres_mysql.docker文件指定了安装mysql_fdw扩展的PostgreSQL数据库。它会在pg_available_extensions系统视图中列出，但仍需通过CREATE EXTENSION命令在特定数据库上安装该扩展。相应地，postgres_mysql_compose.yml文件在同一网络中以postgres和mysql主机名启动PostgreSQL和MySQL数据库。

初始化文件

sql文件夹包含简化外部数据包装器扩展创建和访问外部数据库数据的初始化文件。命名模式如下：

• <dbname>_setup.sql
  • 创建非PostgreSQL数据库并填充一些数据
• postgres_<dbname>_setup.sql
  • 在PostgreSQL中创建外部数据包装器扩展，以连接到<dbname>并访问其数据
• postgres_all_setup.sql
  • 在PostgreSQL的单独模式中创建所有可用的外部数据包装器扩展，仅适用于全能镜像

可用标签

标签命名模式为<postgres_version>_fdw<fdw_version>。例如，postgres_mysql_fdw镜像的13.5_fdw2.7.0标签表示PostgreSQL 13.5版本安装了2.7.0版本的FDW。

镜像构建

注意： 如果使用docker，只需将以下所有命令中的podman替换为docker。

构建标记为postgres_mysql的镜像并从中启动pg_fdw_test容器

sh
$ podman build -t postgres_mysql -f postgres_mysql.docker

$ podman run -d --name pg_fdw_test -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres_mysql
6d6beb18e5b7036c058b2160bb9b57adf9011301658217abf67bea64471f5056

$ podman ps
CONTAINER ID  IMAGE                            COMMAND   CREATED        STATUS            PORTS                   NAMES
6d6beb18e5b7  localhost/postgres_mysql:latest  postgres  4 seconds ago  Up 4 seconds ago  0.0.0.0:5432->5432/tcp  pg_fdw_test

登录数据库并检查mysql_fdw是否可安装

sh
$ podman exec -it pg_fdw_test psql postgres postgres

sql
psql (12.4)
Type "help" for help.

postgres=# select * from pg_available_extensions where name = 'mysql_fdw';
   name    | default_version | installed_version |                     comment
-----------+-----------------+-------------------+--------------------------------------------------
 mysql_fdw | 1.1             |                   | Foreign data wrapper for querying a MySQL server
(1 row)

演示

• PostgreSQL与MySQL
• PostgreSQL与Oracle
• PostgreSQL与SQLite
• PostgreSQL与MongoDB
• PostgreSQL与MSSQL

贡献

欢迎任何贡献。 如果实现新的FDW镜像，请按照描述的模式保持相应的文件名。

如果需要准备某个镜像，请随时提出issue。 可用的FDW实现列表可在PostgreSQL官方wiki上找到。