使用Airbyte CDC同步PostgreSQL时pgoutput扩展不可用的解决方法

1. 确认PostgreSQL版本 #

pgoutput是PostgreSQL 10及以上版本内置的逻辑复制插件，低于10的版本不支持该插件。执行以下SQL检查当前版本：

SELECT version();

若版本低于10，必须升级至PostgreSQL 10或更高版本。

2. 安装PostgreSQL contrib扩展包 #

版本符合要求但仍报错，通常是因为未安装contrib组件（包含pgoutput等扩展），根据操作系统执行对应安装命令：

• Debian/Ubuntu系统：

  # 将14替换为你的PostgreSQL主版本号（如12、15）
  sudo apt-get update && sudo apt-get install postgresql-contrib-14
  

• RHEL/CentOS/Rocky Linux系统：

  # 替换14为对应版本号
  sudo dnf install postgresql14-contrib
  

• Windows系统：
  重新运行PostgreSQL安装程序，在组件选择界面勾选「Contrib Modules」，完成安装后重启服务。

3. 验证扩展文件目录 #

执行以下SQL查看PostgreSQL的扩展文件存储路径：

SHOW extension_directory;

检查该目录下是否存在pgoutput.control文件。若仍不存在，说明PostgreSQL安装不完整，需重新安装对应版本并确保勾选contrib组件。

4. 配置逻辑复制参数 #

CDC同步依赖逻辑复制，需修改postgresql.conf中的以下参数：

wal_level = logical
max_replication_slots = 10  # 至少设为1，可根据同步任务数量调整
max_wal_senders = 10        # 数值需大于等于replication_slots数量

修改后重启PostgreSQL服务：

• Linux系统：

  sudo systemctl restart postgresql
  

• Windows系统：
  在系统服务管理器中找到PostgreSQL服务，右键选择「重启」。

5. 使用超级用户创建扩展 #

确保执行命令的用户为PostgreSQL超级用户（如默认的postgres用户），再执行：

CREATE EXTENSION IF NOT EXISTS "pgoutput";

完成以上步骤后，pgoutput扩展即可正常创建，可继续配置Airbyte的CDC同步任务。

内容的提问来源于stack exchange，提问作者pd farhad