热门搜索:
materialize/dbt-materialize
materialize
dbt-materialize是dbt与Materialize集成的适配器，用于在Materialize数据仓库中进行数据转换和建模，支持物化视图、源、接收器等Materialize特有功能，简化数据建模流程并利用实时数据处理能力。
1 次收藏下载次数: 0状态：社区镜像维护者：materialize仓库类型：镜像最近更新：18 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
dbt-materialize
dbt与Materialize的集成适配器。
有关如何使用dbt和Materialize的完整分步指南，请查看文档。
安装
dbt-materialize可在PyPI上获取。要通过pip安装最新版本（可选使用虚拟环境），请运行：
nofmtpython3 -m venv dbt-venv # 创建虚拟环境 source dbt-venv/bin/activate # 激活虚拟环境 pip install dbt-core dbt-materialize # 安装dbt-core和适配器
要求
dbt-materialize需要Materialize v0.68.0或更高版本。
配置配置文件
要连接到Materialize实例，请在连接配置文件中使用参考配置文件配置：
ymldbt-materialize: target: dev outputs: dev: type: materialize threads: 1 host: [主机] port: [端口] user: [user@domain.com] pass: [密码] dbname: [数据库] schema: [dbt模式] cluster: [集群] # 默认'quickstart' sslmode: require keepalives_idle: 0 # 默认0 retries: 1 # 打开连接时出错/超时默认重试1次 search_path: [可选，覆盖默认搜索路径]
完整的示例配置文件可在sample_profiles.yml中找到。
支持的功能
物化方式
| 类型 | 是否支持 | 说明 |
|---|---|---|
source | 是 | 创建[源]。 |
view | 是 | 创建[视图]。 |
materializedview | 是 | （已废弃）创建[物化视图]。 |
materialized_view | 是 | 创建[物化视图]。为保持向后兼容性，支持旧版物化方式名称materializedview。 |
table | 是 | 创建[物化视图]。（实际表支持待https://github.com/MaterializeInc/database-issues/issues/1623解决。） |
sink | 是 | 创建[接收器]。 |
ephemeral | 是 | 使用CTE执行查询。 |
incremental | 否 | 请改用materialized_view物化方式！dbt的增量模型仅处理新数据以节省资源，而这正是Materialize物化视图的设计目标，且无需手动刷新即可保持结果最新。更多信息见文档。 |
索引
使用indexes选项可为source、view、table或materialized view物化方式定义索引列表。每个Materialize索引可包含以下组件：
| 组件 | 值类型 | 描述 |
|---|---|---|
columns | list | 索引定义的一个或多个列。若要创建使用所有列的索引，请改用default组件。 |
name | string | 索引名称。若未指定，Materialize将使用物化方式名称和提供的列名生成。 |
cluster | string | 创建索引的集群。若未指定，将使用创建物化方式时的集群。 |
default | bool | 默认：False。若设为True，将创建使用所有列的默认索引。 |
额外宏
我们提供materialize-dbt-utils包，包含针对Materialize的dbt-utils分发宏的特定实现。要在dbt项目中使用此包，请查看dbt Hub上的最新安装说明。
钩子
支持。
自定义模式
支持。dbt中的自定义模式行为可能与预期不同，请务必阅读文档！
源
可使用自定义source物化方式指示dbt在Materialize中创建dbt源，该方式允许将完整的源语句注入.sql文件。
不支持source freshness（源新鲜度检查），因为Materialize中的源始终保持最新。
文档
支持dbt docs以及--persist-docs。
测试
支持dbt test。
若设置可选的--store-failures标志或store-failures配置，dbt将把测试查询结果保存到materialized_view。若要改用view，请使用store_failures_as配置。
这些对象默认创建在后缀为或命名为dbt_test__audit的模式中。可通过设置schema配置修改此值。若同时指定store_failures和store_failures_as，则store_failures_as优先。
快照
不支持。近期暂无支持计划。
贡献者
特别感谢https://github.com/jwills%EF%BC%8C%E4%BB%96%E5%88%9B%E5%BB%BA%E4%BA%86%E6%AD%A4%E9%80%82%E9%85%8D%E5%99%A8%E7%9A%84%E5%8E%9F%E5%A7%8B%E7%89%88%E6%9C%AC%E3%80%82%F0%9F%A4%A0
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 dbt-materialize 镜像标签
docker pull docker.xuanyuan.run/materialize/dbt-materialize:<标签>
DockerHub 原生拉取命令
docker pull materialize/dbt-materialize:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"