Skip to content

feat: propagate column comments as schema descriptions#3805

Open
tuantran0910 wants to merge 1 commit intodlt-hub:develfrom
tuantran0910:feat/sql-database-column-comment-description
Open

feat: propagate column comments as schema descriptions#3805
tuantran0910 wants to merge 1 commit intodlt-hub:develfrom
tuantran0910:feat/sql-database-column-comment-description

Conversation

@tuantran0910
Copy link
Copy Markdown

@tuantran0910 tuantran0910 commented Mar 30, 2026

Description

Bridges SQLAlchemy column.comment to dlt's TColumnSchema.description field in the sql_database source. Column comments from documented databases (PostgreSQL, MySQL, Oracle) are now preserved during schema conversion.

Previously, column descriptions were lost even though dlt supports the field and destinations like BigQuery, Databricks, and Snowflake can write them.

Example:

# Source database: users.email has comment "Primary contact email"
source = sql_database(engine, table_names=["users"])
pipeline = dlt.pipeline("demo", destination="bigquery")
pipeline.run(source)

# Column description now appears in BigQuery schema

Related Issues

Bridge SQLAlchemy column .comment to dlt TColumnSchema description field
so users loading from databases with documented columns preserve that
metadata through to the destination.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@tuantran0910 tuantran0910 changed the title feat(sql_database): propagate column comments as schema descriptions feat: propagate column comments as schema descriptions Mar 30, 2026
@zilto zilto added the enhancement New feature or request label Apr 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Propagate column comments as schema descriptions

2 participants