dbt docs无法检测SQL Server列类型？适配器及codegen问题求助

核心原因分析 #

你的判断完全正确，这两个问题的根源都是dbt-sqlserver适配器对元数据获取类宏的支持不完善：

• dbt docs generate依赖get_columns_in_relation这类底层宏从SQL Server读取表/视图的列类型、可空性等元数据，若适配器未实现或实现存在缺陷，就无法自动填充列的详细信息。
• codegen包本质也是调用这些元数据宏来反向生成sources yml，适配器的问题会直接导致codegen功能失效。

具体解决方案 #

1. 升级dbt-sqlserver适配器版本 #

旧版本的dbt-sqlserver确实存在元数据宏实现不全的问题，优先升级到最新稳定版：

pip install --upgrade dbt-sqlserver

升级后重新执行dbt docs generate，验证列类型是否能正常填充。

2. 手动补全缺失的宏（升级后仍无效时） #

如果新版本仍未解决问题，可以在项目的macros目录下自行补写get_columns_in_relation宏，适配SQL Server的系统视图逻辑：

{% macro sqlserver__get_columns_in_relation(relation) -%}
    select
        column_name as column,
        data_type as dtype,
        case when is_nullable = 'YES' then true else false end as is_nullable
    from information_schema.columns
    where table_name = '{{ relation.identifier }}'
    {% if relation.schema %}
        and table_schema = '{{ relation.schema }}'
    {% endif %}
    {% if relation.database %}
        and table_catalog = '{{ relation.database }}'
    {% endif %}
    order by ordinal_position
{% endmacro %}

该宏通过查询SQL Server原生的information_schema.columns系统视图获取列信息，覆盖适配器默认的实现逻辑。

3. 修复codegen包兼容性问题 #

codegen默认逻辑可能未适配SQL Server，你可以在项目中重写codegen的核心宏（如generate_source），将其中的元数据查询语句替换为SQL Server兼容的写法；也可以直接通过SQL Server系统视图手动导出列信息，整理成sources yml的基础内容：

select
    concat('- name: ', column_name),
    concat('  description: ""'),
    concat('  data_type: ', data_type)
from information_schema.columns
where table_schema = '你的源schema名'
and table_name = '你的源表名'
order by ordinal_position

将查询结果复制到sources yml文件中，再补充其他需要的配置项即可。

4. 验证版本兼容性 #

确保dbt-core版本与dbt-sqlserver版本严格匹配，比如dbt-core 1.6.x对应dbt-sqlserver 1.6.x，版本不兼容也会引发元数据获取类的问题。

内容的提问来源于stack exchange，提问作者Thomas L.