jonathanpotts/babelfishpg

docker-babelfishpg

!Docker Image Version (latest semver) !Docker Image Size with architecture (latest by date/latest semver) !Docker Pulls !GitHub Actions Workflow Status !GitHub Actions Workflow Status

Docker镜像，用于Babelfish for PostgreSQL。

Babelfish for PostgreSQL是PostgreSQL的一组https://github.com/babelfish-for-postgresql/babelfish_extensions%EF%BC%8C%E4%BD%BF%E5%85%B6%E8%83%BD%E5%A4%9F%E4%BD%BF%E7%94%A8%E8%A1%A8%E6%A0%BC%E6%95%B0%E6%8D%AE%E6%B5%81(TDS)%E5%8D%8F%E8%AE%AE%E5%92%8CTransact-SQL(T-SQL)%EF%BC%8C%E5%85%81%E8%AE%B8%E4%B8%BAMicrosoft SQL Server设计的应用程序将PostgreSQL用作数据库。有关更多详细信息，请参见AWS新闻博客中的"再见Microsoft SQL Server，你好Babelfish"。

快速开始

警告：安装新镜像前，请务必创建数据库转储以备份数据，以防更改镜像时发生数据丢失风险。

要创建新容器，请运行：

docker run -d -p 1433:1433 jonathanpotts/babelfishpg

示例数据

使用https://github.com/jonathanpotts/docker-babelfishpg/blob/main/example_data.sql%E8%84%9A%E6%9C%AC%E4%B8%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E5%A1%AB%E5%85%85%E7%A4%BA%E4%BE%8B%E6%95%B0%E6%8D%AE%E3%80%82

然后可以使用以下命令查询数据库：

sql
SELECT * FROM example_db.authors;

sql
SELECT * FROM example_db.books;

高级设置

要使用自定义用户名初始化，请在docker run命令后附加-u my_username，其中my_username是所需的用户名。

要使用自定义密码初始化，请在docker run命令后附加-p my_password，其中my_password是所需的密码。

要使用自定义数据库名初始化，请在docker run命令后附加-d my_database，其中my_database是所需的数据库名。这是Babelfish for PostgreSQL内部用于存储数据的数据库名称，无法通过TDS访问。

迁移模式

默认情况下，使用single-db迁移模式。 要使用不同的迁移模式，请在docker run命令后附加-m migration_mode，其中migration_mode是所需的迁移模式值。

有关迁移模式的更多信息，请参见单实例与多实例。

加密(SSL)支持

从2023年3月4日推送的2.3.0镜像开始，镜像已添加加密(SSL)支持。您需要配置PostgreSQL以使用SSL；有关说明，请参见使用SSL的安全TCP/IP连接。

作为一个非常基本的示例，要使用自签名证书（有效期为365天且主题为localhost）启用加密，请在容器的终端中运行以下命令：

sh
cd /var/lib/babelfish/data
openssl req -new -x509 -days 365 -nodes -text -out server.crt -keyout server.key -subj "/CN=localhost"
chmod og-rwx server.key
echo "ssl = on" >> postgresql.conf

然后重启容器，加密支持应已启用。

连接

如果在本地计算机上托管容器，则服务器名称为localhost。否则，使用托管容器的服务器的IP地址或DNS支持的完全限定域名(FQDN)。

使用SQL Server身份验证模式登录。

Babelfish的默认登录信息为：

• 用户名： babelfish_user
• 密码： 12345678

如果指定了自定义用户名和/或密码，请使用这些凭据。

SQL Server Management Studio(SSMS)中的许多功能目前不受支持。

连接字符串

假设Babelfish托管在本地计算机上，使用默认设置，并且尝试连接到名为example_db的数据库，连接字符串为：

Data Source=localhost;Initial Catalog=example_db;Persist Security Info=true;User ID=babelfish_user;Password=12345678

数据卷

数据库数据存储在/var/lib/babelfish/data卷中。

构建Docker镜像

[!IMPORTANT] BABEL_5_2_0__PG_17_5版本有重大更改。要构建早期版本，应使用before-BABEL_5_2_0__PG_17_5分支。

要构建Docker镜像，请克隆存储库，然后运行docker build .。

要使用不同的Babelfish版本，您可以：

• 修改Dockerfile中的ARG BABELFISH_VERSION=<BABELFISH_VERSION_TAG>
• 或者
• 运行docker build . --build-arg BABELFISH_VERSION=<BABELFISH_VERSION_TAG>

Babelfish版本标签列于https://github.com/babelfish-for-postgresql/babelfish-for-postgresql/tags%E3%80%82

其他扩展

添加其他扩展超出了本项目的范围。它们可能无法通过Babelfish使用，并且可能导致Babelfish扩展出现问题或无法按预期工作。

为解决之前的扩展请求问题，我创建了plpython3u和postgis扩展的分支。您可以将它们作为修改示例，以添加您可能需要的扩展。

未来请求向本项目添加扩展的问题很可能会被关闭。