Implementation:Astronomer Astronomer cosmos PostgresUserPasswordProfileMapping

Knowledge Sources	Astronomer_Astronomer_cosmos
Domains	Profile_Mapping, Postgres
Last Updated	2026-02-07 17:00 GMT

Overview

Concrete tool for mapping Airflow postgres connections to dbt postgres profiles provided by astronomer-cosmos.

Description

The PostgresUserPasswordProfileMapping maps an Airflow postgres connection to a dbt postgres profile. It translates connection parameters (host, login, password, schema, port, extras) into the YAML structure that dbt expects in `profiles.yml`. It maps host, port, user, password, dbname, and schema from the standard Airflow Postgres connection fields to the corresponding dbt postgres profile fields. The password is treated as a secret field and passed via an environment variable.

Usage

Use this profile mapping when configuring Cosmos to run dbt commands against a PostgreSQL backend. Assign it to `ProfileConfig(profile_mapping=...)` when the target Airflow connection uses the `postgres` connection type.

Code Reference

Source Location

• Repository: Astronomer_Astronomer_cosmos
• File: cosmos/profiles/postgres/user_pass.py

Signature

class PostgresUserPasswordProfileMapping(BaseProfileMapping):
    airflow_connection_type: str = "postgres"
    dbt_profile_type: str = "postgres"

Import

from cosmos.profiles.postgres import PostgresUserPasswordProfileMapping

I/O Contract

Inputs

Name	Type	Required	Description
conn_id	str	Yes	Airflow connection ID for PostgreSQL

Outputs

Name	Type	Description
profile	dict	dbt profile YAML dictionary
env_vars	dict	Environment variables for secret fields

Usage Examples

from cosmos.config import ProfileConfig
from cosmos.profiles.postgres import PostgresUserPasswordProfileMapping

profile_config = ProfileConfig(
    profile_name="default",
    target_name="dev",
    profile_mapping=PostgresUserPasswordProfileMapping(conn_id="postgres_default"),
)

Related Pages

• Environment:Astronomer_Astronomer_cosmos_Python_Airflow_Runtime