如何在Airflow官方Helm部署中指定PostgreSQL schema及search_path

前置操作：提前创建目标Schema #

Airflow不会自动创建数据库Schema，需先在PostgreSQL端手动创建并配置权限：

-- 创建目标schema（以airflow_meta为例）
CREATE SCHEMA IF NOT EXISTS airflow_meta;
-- 授予Airflow数据库用户该schema的全部权限（替换为你的实际用户）
GRANT ALL ON SCHEMA airflow_meta TO postgres;

方案一：通过数据库连接URL指定search_path #

修改values.yaml中的metadataConnection，改用url字段并附加search_path参数（注意URL编码）：

metadataConnection:
  url: postgresql://postgres:postgres@<你的PostgreSQL主机地址>:5432/postgres?options=-csearch_path%3Dairflow_meta
  sslmode: disable

参数说明：-csearch_path%3Dairflow_meta是URL编码后的-c search_path=airflow_meta，作用是在建立数据库连接时指定默认schema。

方案二：通过Airflow配置传递连接参数 #

如果不想修改连接URL格式，可在values.yaml的airflow.config中添加SQLAlchemy连接参数：

airflow:
  config:
    SQL_ALCHEMY_CONNECT_ARGS: |
      {"options": "-c search_path=airflow_meta"}

# 保持原有的metadataConnection配置不变
metadataConnection:
  user: postgres
  pass: postgres
  protocol: postgresql
  host: <你的PostgreSQL主机地址>
  port: 5432
  db: postgres
  sslmode: disable

这种方式会让Airflow在初始化数据库连接时自动附加search_path参数，指定目标schema。

注意事项 #

• 不需要修改PostgreSQL全局的search_path：全局修改会影响同一数据库下的其他应用，通过连接参数指定仅对Airflow生效，更安全。
• 验证部署：部署完成后，可通过PostgreSQL客户端查询元数据表所在schema：

SELECT table_schema FROM information_schema.tables WHERE table_name = 'dag';

返回结果应为你指定的airflow_meta（或自定义schema名称）。

内容的提问来源于stack exchange，提问作者Ramesh Kumar