dltHub 0.27 版本发布解读Credits 计量、计费页面、工作区归档与 API 破坏性变更【免费下载链接】dltdata load tool (dlt) is an open source Python library that makes data loading easy ️项目地址: https://gitcode.com/GitHub_Trending/dl/dltdlt 生态中的托管平台 dltHub 在 0.27 版本2026 年 8 月 31 日发布配套dlthub-client0.28.3引入了一整套围绕用量与运维治理的能力以 credits 统一计量运行时长、面向组织所有者的 Billing 页面、Web 应用中的工作区归档、更清晰的作业列表以及全面服务端化的搜索与过滤。读完本篇你能完整理解 credits 与实例规格的换算关系、升级 CLI 的必要性、直接调用 dltHub API 时的参数迁移要点以及归档工作区的操作边界。版本概览与破坏性变更0.27 是一次面向平台运营与 API 消费者的功能发布核心内容包括新增 Billing 页面、用量以 credits 上报、Web 应用支持工作区归档、试用期从首次运行而非注册开始计时以及可在 dltHub 内直接联系支持团队。本次发布包含两个必须重视的破坏性变更CLI 必须升级到 0.28.3。新版运行时runtime会拒绝更旧的 CLI——旧版本 CLI 仍会发送本版本已移除的两个查询参数。升级命令为uv pip install -U dlt[hub]安装与升级的完整说明参见 安装文档。该文档中给出的安装示例形如uv pip install -U dlt[hub]1.27.0固定版本安装升级已有安装时按上述不加版本约束的方式拉取最新即可。Web 用户不受影响因为 dashboard 与 API 是一起发布的不存在 CLI 与后端的版本错配问题。直接调用 API 的用户status_filter参数已移除archived变为布尔值。具体迁移方式工作区 runs 列表接口改用status参数替代原先的status_filter作业jobs列表接口archived不再接受字符串all、true、false只接受布尔值并且省略该参数时现在会同时列出已归档与未归档的作业旧行为是仅列出未归档的。如果你的代码依赖不传archived就只看在线作业的旧语义必须显式传参。说明上述 API 行为变化来自 发布说明 文档本身dltHub 的后端 API 服务不在此开源仓库中本仓库包含的是dlt库与dlt/_workspace/cli下的 CLI/运行时客户端侧代码因此这些参数语义以官方发布文档为准。用量以 credits 计量定义与实例倍率0.27 起平台用量以 credits 上报。1 个 credit 在small实例上运行 1 小时。更大实例按倍率折算倍率定义与 作业配置文档 中的 Instance size 表格一致实例规格倍率small1×medium2×large4×xlarge8×结合仓库中的 Job configuration 文档倍率背后的资源规格如下表该特性处于 public previewsizevCPU内存磁盘倍率small24 GiB500 GB1×medium48 GiB500 GB2×large816 GiB500 GB4×xlarge1632 GiB500 GB8×实例规格通过run.pipeline/run.job/run.interactive装饰器的require.instance声明run.pipeline( my_pipeline, require{instance: {size: medium}}, ) def heavy_sync(): ...不声明instance时作业默认使用small。按倍率折算的含义是一次 1 小时的large运行会消耗 4 小时4 credits的运行时长预算。因此若对用量敏感优先考虑通过 dlt 管道层面的调优分块、并行度、内存设置降低所需实例规格而不是盲目放大资源。在应用内凡出现 credit 数值的位置都配有 tooltip 解释该定义。重新设计的用量页面工作区用量页面已与组织视图对齐包含堆叠的批次图与可交互的 credits 图表以及按作业类型划分的图例时间范围选择与Monthly / Weekly / Daily工具栏新增的Credits by Instance Size面板展示每种实例规格的倍率及其在总用量中的占比。组织级别的 Usage 标签页新增了Weekly维度原有 Monthly 和 Daily。同时用量信息现在仅保留在专属的设置页面中展示不再散落各处。面向组织所有者的 Billing 页面组织所有者organization owner可以在 设置页面 中看到新的Billing页面两类组织的展示内容不同试用Trial组织显示当前套餐、试用到期时间与用量并提供预约升级咨询book an upgrade call的链接付费Paid组织展示计费方式——要么是一个直达 Stripe 客户门户customer portal的链接要么是一条以发票invoiced方式计费的说明。试用从首次运行开始这是一个对试用用户非常关键的规则变更14 天试用期及其附带的 30 美元 credits现在从你的第一个作业运行开始计时而不是从注册时开始——即计时器不会在你还未使用任何资源之前空转。具体规则任何batch 或 stream 运行都会启动试用无论该次运行成功还是失败交互式interactive作业如 dashboard 与分享链接不会启动试用其定义可参见 管道操作概览 中的 Batch vs Interactive 一节尚未运行过任何作业的组织会在界面上看到一条横幅带Get started链接引导首次运行。从源码结构看本仓库中dlt/_workspace/deployment/目录承载了部署清单manifest、作业引用job ref、新鲜度freshness与触发器trigger等平台交互客户端逻辑dlt/_workspace/deployment/launchers/下则有 dashboard、streamlit、marimo、job 等不同类型的启动器模块——这与文档中 batch/stream/interactive 三类作业运行在客户端侧的分型相吻合。Web 应用中的工作区归档工作区Workspace现在可以从工作区设置中新增的Danger Zone归档。操作语义与边界如下执行者工作区或组织所有者前置条件目标工作区没有正在运行的活动任务no active runs归档后效果工作区变为只读其上的调度schedules停止运行工作区头像带有归档的视觉标识刻意不做的事系统不会把你强制迁移到另一个工作区——归档后你的当前上下文保持不变。组织的工作区列表新增了Active / All过滤器以显示已归档的工作区。该过滤器状态是 URL 的一部分因此一个指向归档工作区的链接打开后会落在能看到它的那个列表上All 视图不会出现链接 404式的体验断裂。更清晰的作业列表Jobs 列表中的Trigger列现在展示下一次实际启动作业的触发器。此前的问题有三点该列显示的是一段管道pipeline名称而不是真正的触发器对于仅支持手动触发的作业该列完全为空已暂停或触发时间已过的触发器被当作仍会触发来呈现。0.27 起该列如实表达下一次将由什么启动作业与 触发器与调度文档 中定义的触发器模型保持一致。所有列表的服务端搜索与过滤0.27 将搜索、多值过滤与排序下沉到服务端覆盖全部工作区实体列表jobs、job runs、pipeline runs以及 pipeline 与 dataset 概览。其实际意义是过滤和排序作用于整个数据集而不仅仅是当前分页窗口内的数据——在大数据量工作区中这解决了翻完所有页才能筛出目标记录的旧痛点。共享数据网格shared data grid组件同步获得了可排序、可过滤的列能力以及对超长值的 tooltip 悬浮预览。应用内联系支持Intercom 消息器现已对所有人启用支持团队可以直接在 dltHub 内触达无需离开应用切换到邮件或外部工单系统。面向 API 消费者稳定的认证错误码除前文所述的status_filter/archived变更外0.27 对 API 可观测性做了另一项改进认证失败auth failures现在携带稳定的、机器可读的错误码与人类可读的错误消息并存。客户端可以基于错误码做分支处理例如区分令牌过期与凭据无效而不必再去匹配易变的英文文案。文档特别指出这些错误码在服务间跳转hop between services后仍然保持意味着网关与服务内部抛出同一语义的错误时客户端看到一致的可识别编码。总结与升级检查清单0.27 版本的 dltHub 把平台治理从管理后台前移到了用户可感知的产品层面credits 让用量口径可计算、可审计Billing 页面让费用归属透明工作区归档让生命周期管理有了产品化入口服务端搜索过滤让大规模工作区可用。结合仓库文档建议的升级核对清单执行uv pip install -U dlt[hub]将 CLI 升级到 0.28.3 或更高避免运行时拒绝旧 CLI详见 安装文档检查任何直接调用 dltHub API 的脚本移除status_filter用法、将archived改为布尔传参并确认是否依赖省略archived只看在线作业的旧默认行为复核各作业的require.instance规格在 1 credit 1 小时small的口径下用倍率medium 2× / large 4× / xlarge 8×见 作业配置文档重新估算预算试用组织注意计时从首次 batch/stream 运行开始交互式作业不触发需要归档的工作区确认无活动运行后由所有者在 Danger Zone 操作并善用 URL 中的 Active/All 过滤器分享归档工作区链接。参考Release highlights: 0.27 — 本篇对应的官方发布说明上一版 Release highlights: 0.26Job configuration — 实例规格、依赖组与作业超时等配置Triggers and scheduling — 触发器模型What is a workspace — 工作区概念Settings — 设置与 Billing 页面入口Installation —dlt[hub]安装与升级【免费下载链接】dltdata load tool (dlt) is an open source Python library that makes data loading easy ️项目地址: https://gitcode.com/GitHub_Trending/dl/dlt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
dltHub 0.27 版本发布解读：Credits 计量、计费页面、工作区归档与 API 破坏性变更
dltHub 0.27 版本发布解读Credits 计量、计费页面、工作区归档与 API 破坏性变更【免费下载链接】dltdata load tool (dlt) is an open source Python library that makes data loading easy ️项目地址: https://gitcode.com/GitHub_Trending/dl/dltdlt 生态中的托管平台 dltHub 在 0.27 版本2026 年 8 月 31 日发布配套dlthub-client0.28.3引入了一整套围绕用量与运维治理的能力以 credits 统一计量运行时长、面向组织所有者的 Billing 页面、Web 应用中的工作区归档、更清晰的作业列表以及全面服务端化的搜索与过滤。读完本篇你能完整理解 credits 与实例规格的换算关系、升级 CLI 的必要性、直接调用 dltHub API 时的参数迁移要点以及归档工作区的操作边界。版本概览与破坏性变更0.27 是一次面向平台运营与 API 消费者的功能发布核心内容包括新增 Billing 页面、用量以 credits 上报、Web 应用支持工作区归档、试用期从首次运行而非注册开始计时以及可在 dltHub 内直接联系支持团队。本次发布包含两个必须重视的破坏性变更CLI 必须升级到 0.28.3。新版运行时runtime会拒绝更旧的 CLI——旧版本 CLI 仍会发送本版本已移除的两个查询参数。升级命令为uv pip install -U dlt[hub]安装与升级的完整说明参见 安装文档。该文档中给出的安装示例形如uv pip install -U dlt[hub]1.27.0固定版本安装升级已有安装时按上述不加版本约束的方式拉取最新即可。Web 用户不受影响因为 dashboard 与 API 是一起发布的不存在 CLI 与后端的版本错配问题。直接调用 API 的用户status_filter参数已移除archived变为布尔值。具体迁移方式工作区 runs 列表接口改用status参数替代原先的status_filter作业jobs列表接口archived不再接受字符串all、true、false只接受布尔值并且省略该参数时现在会同时列出已归档与未归档的作业旧行为是仅列出未归档的。如果你的代码依赖不传archived就只看在线作业的旧语义必须显式传参。说明上述 API 行为变化来自 发布说明 文档本身dltHub 的后端 API 服务不在此开源仓库中本仓库包含的是dlt库与dlt/_workspace/cli下的 CLI/运行时客户端侧代码因此这些参数语义以官方发布文档为准。用量以 credits 计量定义与实例倍率0.27 起平台用量以 credits 上报。1 个 credit 在small实例上运行 1 小时。更大实例按倍率折算倍率定义与 作业配置文档 中的 Instance size 表格一致实例规格倍率small1×medium2×large4×xlarge8×结合仓库中的 Job configuration 文档倍率背后的资源规格如下表该特性处于 public previewsizevCPU内存磁盘倍率small24 GiB500 GB1×medium48 GiB500 GB2×large816 GiB500 GB4×xlarge1632 GiB500 GB8×实例规格通过run.pipeline/run.job/run.interactive装饰器的require.instance声明run.pipeline( my_pipeline, require{instance: {size: medium}}, ) def heavy_sync(): ...不声明instance时作业默认使用small。按倍率折算的含义是一次 1 小时的large运行会消耗 4 小时4 credits的运行时长预算。因此若对用量敏感优先考虑通过 dlt 管道层面的调优分块、并行度、内存设置降低所需实例规格而不是盲目放大资源。在应用内凡出现 credit 数值的位置都配有 tooltip 解释该定义。重新设计的用量页面工作区用量页面已与组织视图对齐包含堆叠的批次图与可交互的 credits 图表以及按作业类型划分的图例时间范围选择与Monthly / Weekly / Daily工具栏新增的Credits by Instance Size面板展示每种实例规格的倍率及其在总用量中的占比。组织级别的 Usage 标签页新增了Weekly维度原有 Monthly 和 Daily。同时用量信息现在仅保留在专属的设置页面中展示不再散落各处。面向组织所有者的 Billing 页面组织所有者organization owner可以在 设置页面 中看到新的Billing页面两类组织的展示内容不同试用Trial组织显示当前套餐、试用到期时间与用量并提供预约升级咨询book an upgrade call的链接付费Paid组织展示计费方式——要么是一个直达 Stripe 客户门户customer portal的链接要么是一条以发票invoiced方式计费的说明。试用从首次运行开始这是一个对试用用户非常关键的规则变更14 天试用期及其附带的 30 美元 credits现在从你的第一个作业运行开始计时而不是从注册时开始——即计时器不会在你还未使用任何资源之前空转。具体规则任何batch 或 stream 运行都会启动试用无论该次运行成功还是失败交互式interactive作业如 dashboard 与分享链接不会启动试用其定义可参见 管道操作概览 中的 Batch vs Interactive 一节尚未运行过任何作业的组织会在界面上看到一条横幅带Get started链接引导首次运行。从源码结构看本仓库中dlt/_workspace/deployment/目录承载了部署清单manifest、作业引用job ref、新鲜度freshness与触发器trigger等平台交互客户端逻辑dlt/_workspace/deployment/launchers/下则有 dashboard、streamlit、marimo、job 等不同类型的启动器模块——这与文档中 batch/stream/interactive 三类作业运行在客户端侧的分型相吻合。Web 应用中的工作区归档工作区Workspace现在可以从工作区设置中新增的Danger Zone归档。操作语义与边界如下执行者工作区或组织所有者前置条件目标工作区没有正在运行的活动任务no active runs归档后效果工作区变为只读其上的调度schedules停止运行工作区头像带有归档的视觉标识刻意不做的事系统不会把你强制迁移到另一个工作区——归档后你的当前上下文保持不变。组织的工作区列表新增了Active / All过滤器以显示已归档的工作区。该过滤器状态是 URL 的一部分因此一个指向归档工作区的链接打开后会落在能看到它的那个列表上All 视图不会出现链接 404式的体验断裂。更清晰的作业列表Jobs 列表中的Trigger列现在展示下一次实际启动作业的触发器。此前的问题有三点该列显示的是一段管道pipeline名称而不是真正的触发器对于仅支持手动触发的作业该列完全为空已暂停或触发时间已过的触发器被当作仍会触发来呈现。0.27 起该列如实表达下一次将由什么启动作业与 触发器与调度文档 中定义的触发器模型保持一致。所有列表的服务端搜索与过滤0.27 将搜索、多值过滤与排序下沉到服务端覆盖全部工作区实体列表jobs、job runs、pipeline runs以及 pipeline 与 dataset 概览。其实际意义是过滤和排序作用于整个数据集而不仅仅是当前分页窗口内的数据——在大数据量工作区中这解决了翻完所有页才能筛出目标记录的旧痛点。共享数据网格shared data grid组件同步获得了可排序、可过滤的列能力以及对超长值的 tooltip 悬浮预览。应用内联系支持Intercom 消息器现已对所有人启用支持团队可以直接在 dltHub 内触达无需离开应用切换到邮件或外部工单系统。面向 API 消费者稳定的认证错误码除前文所述的status_filter/archived变更外0.27 对 API 可观测性做了另一项改进认证失败auth failures现在携带稳定的、机器可读的错误码与人类可读的错误消息并存。客户端可以基于错误码做分支处理例如区分令牌过期与凭据无效而不必再去匹配易变的英文文案。文档特别指出这些错误码在服务间跳转hop between services后仍然保持意味着网关与服务内部抛出同一语义的错误时客户端看到一致的可识别编码。总结与升级检查清单0.27 版本的 dltHub 把平台治理从管理后台前移到了用户可感知的产品层面credits 让用量口径可计算、可审计Billing 页面让费用归属透明工作区归档让生命周期管理有了产品化入口服务端搜索过滤让大规模工作区可用。结合仓库文档建议的升级核对清单执行uv pip install -U dlt[hub]将 CLI 升级到 0.28.3 或更高避免运行时拒绝旧 CLI详见 安装文档检查任何直接调用 dltHub API 的脚本移除status_filter用法、将archived改为布尔传参并确认是否依赖省略archived只看在线作业的旧默认行为复核各作业的require.instance规格在 1 credit 1 小时small的口径下用倍率medium 2× / large 4× / xlarge 8×见 作业配置文档重新估算预算试用组织注意计时从首次 batch/stream 运行开始交互式作业不触发需要归档的工作区确认无活动运行后由所有者在 Danger Zone 操作并善用 URL 中的 Active/All 过滤器分享归档工作区链接。参考Release highlights: 0.27 — 本篇对应的官方发布说明上一版 Release highlights: 0.26Job configuration — 实例规格、依赖组与作业超时等配置Triggers and scheduling — 触发器模型What is a workspace — 工作区概念Settings — 设置与 Billing 页面入口Installation —dlt[hub]安装与升级【免费下载链接】dltdata load tool (dlt) is an open source Python library that makes data loading easy ️项目地址: https://gitcode.com/GitHub_Trending/dl/dlt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
