Lakebase Provisioned 实例已升级为自动扩展，统一了 Lakebase 在单一自动扩展平台上。
注释
Lakebase Provisioned 实例升级为自动扩展已于 2026 年 7 月完成。 新的 Lakebase 实例现在被创建为自动缩放项目。 预配 UI 将持续可用至 2026年9月1日，以便有时间过渡到使用 Lakebase 自动扩缩容 UI。 本页面仍作为自动缩放和配置（Provisioned）区别的参考资料。
- 将新建实例创建为自动缩放项目。 自 2026 年 3 月 12 日以来，新的 Lakebase 实例将创建为自动缩放项目，而不是预配实例。
- 将现有预配实例升级到自动缩放。 所有现有的 Lakebase Provisioned 实例均已升级为自动扩展平台。
将新建实例创建为自动缩放项目
创建新的 Lakebase 实例时，它现在创建为 Lakebase 自动缩放项目 ，并显示在 Lakebase 应用中的 “自动缩放 ”页上，而不是“ 预配 ”页上。 现有 预配实例 不会受到影响，并且继续像以前一样继续运行。
在 “自动缩放 ”页上，新项目标有信息图标。
将鼠标悬停在图标上可查看一个工具提示，说明项目是使用数据库实例 API 创建的，并且它同时支持数据库实例和 Postgres API。
对你来说这意味着什么
- 创建 Lakebase 实例。 任何新的 Lakebase 实例都创建为 Lakebase 自动缩放项目，并显示在 Lakebase 应用中的 “自动缩放 ”页上。 可以使用 数据库实例 API 和 Postgres API 管理这些项目。
- UI 中的“创建”按钮。 “ 创建 ”按钮（包括在“预配”选项卡中）现在将打开自动缩放项目创建流。
- 自动缩放功能。 新项目将获得自动扩缩容功能，包括自动扩缩容计算、缩容至零（默认启用，闲置超时为 24 小时）、分支和即时还原。 准备就绪后，可以从 Lakebase 自动缩放 UI 和 Postgres API 访问这些功能。
- 现有预配实例保持不变。 它们保持在 UI 中的预配页面上，其行为与之前相同。 预配的实例、连接字符串和 API 都继续工作。
- 现有自动化将继续工作。 现有自动化无需修改即可继续工作，但新实例将创建为自动缩放项目。
API接口
通过 数据库实例 API 创建的新实例支持这两个 API，因此现有自动化将继续不进行修改。
| 实例或项目 | 要使用的 API |
|---|---|
| 通过数据库实例 API 创建的新项目 | 这两个 API。 两者中的任意一个都可以用来管理同一个项目。 |
| 在自动缩放 UI 或 Postgres API 中创建的项目 | 仅 Postgres API。 |
| 升级到自动扩缩容之前的现有预配实例 | 仅数据库实例 API。 |
| 升级到自动缩放 后 的现有预配实例 | 这两个 API。 您可以使用两者中的任意一个来管理同一个实例。 |
使用 database_instances 的现有 DAB 自动化仍可继续运行。 但是，由 database_instances 创建的新实例会被创建为自动扩缩项目。 对于新的 Lakebase 工作，Azure Databricks建议改用 postgres_projects。 请参阅 捆绑资源。
新 Lakebase 实例的差异
计算大小
作为自动扩缩容项目创建的 Lakebase 实例使用自动扩缩容计算单元 (CU) 而非 Lakebase 预配容量单元。 使用 数据库实例 API 创建项目时，Lakebase 会将所选的预配容量单位映射到最小和最大自动缩放 CU 范围，如下所示：
注释
每个单位的 RAM： 在 Lakebase Provisioned 中，一个容量单位包含 16 GB 的 RAM。 在 Lakebase 自动缩放中，一个 CU 具有 2 GB RAM。
| 预配容量 | 自动扩缩容最小 CU | 自动扩缩容最大 CU |
|---|---|---|
| 1 （16 GB） | 4 （8 GB） | 8 （16 GB） |
| 2 （32 GB） | 8 （16 GB） | 16 （32 GB） |
| 4 （64 GB） | 16 （32 GB） | 32 （64 GB） |
| 8 （128 GB） | 48 （96 GB） | 64 （128 GB） |
例如，如果自动化创建了 容量为 1 的 Lakebase 实例，则使用 最小 CU 4 和 最大 CU 8 设置创建新的 Lakebase 自动缩放项目。 稍后可以使用 Postgres API 或在 Lakebase 自动缩放 UI 中更改最小值/最大值。
注释
所有新实例（包括使用 数据库实例 API 创建的实例）都在自动缩放平台上运行，并使用 Lakebase 自动缩放定价。 随着弹性计算取代固定容量计费，大多数客户都会看到计算成本的降低。 现有预配实例在升级前将继续按当前价格计费。 请参阅 将现有预配实例升级到自动缩放。
缩放到零
新项目的读写终结点默认启用缩容至零，闲置超时为 24 小时，因此计算资源在闲置 24 小时后会自动暂停以降低成本。 你可以在 Lakebase 自动扩缩容 UI 中或使用 Postgres API 调整超时时间，也可禁用缩容至零以保持计算资源持续运行。 有关详细信息，请参阅 “缩放到零 ”。
“历史记录”窗口
在 Lakebase 预配 （数据库实例）上，还原 窗口 可以设置为 35 天。 对于Lakebase 自动扩缩容（新项目），历史记录窗口设置的最大值为30 天。
PostgreSQL 版本
通过 数据库实例 API 或 Lakehouse/Provisioned UI 创建的新项目使用 PostgreSQL 16，与 Lakebase Provisioned 保持一致。 这意味着使用数据库实例 API 的自动化会创建与以前相同的 PostgreSQL 版本（16）的项目。 使用自动缩放 UI 或 Postgres API 创建的项目的默认值为 PostgreSQL 17。
连接详细信息和主机名
新项目的连接详细信息使用与 Lakebase 预配不同的 主机名格式 。 预配实例使用 全局 主机名（主机名中没有区域）。 新建的项目使用 区域 主机名（包括区域）。 读写端点和只读端点在新项目中都使用主机名的区域格式。
已预配（全局主机名）：
host=instance-a1b2c3d4-e5f6-7890-abcd-ef1234567890.database.cloud.databricks.com
自动缩放（区域主机名）：
host=ep-example-endpoint-a1b2c3d4.database.<region>.cloud.databricks.com
区域主机名包括云和区域的区域代码（例如，AWS 上的 us-east-1 或 Azure 上的 eastus）。
重要
如果你使用 IP 允许列表，必须为新项目放行所属区域的区域入站 IP。 请参阅 为工作区创建 IP 访问列表。
专用链接
Lakebase 自动缩放使用两个 专用链接 终结点：用于 API 访问的 前端 专用链接（工作区级连接保持不变），以及用于 Postgres 客户端连接的 面向性能密集型服务的入站 专用链接（面向性能密集型服务的入站 专用链接）。 是否需要为性能密集型服务使用入站 专用链接，取决于应用程序的连接方式。
| 你的情况 | 所需内容 |
|---|---|
| 使用 专用链接、创建新实例，并使用 Postgres 客户端从 Azure Databricks 工作区外部进行连接 | 添加性能密集型服务的入站专用链接。 |
| 你已使用 Lakebase 自动扩缩容或其他采用入站 专用链接 的性能密集型服务 | 无更改。 |
| 仅使用现有的预配实例，并且不创建新实例 | 无更改。 |
权限（ACL）
对新 Lakebase 实例的权限存储在 Lakebase 项目 ACL 资源上。 可以使用标准权限 APIrequest_object_type=database-projects、Lakebase 自动缩放 UI 或 Postgres API 管理它们。 使用 数据库实例 API 的现有自动化将继续工作，因为这些调用将代理到同一 database-projects 资源。 读取和写入在两个 API 图面上保持一致。
早期权限模型
使用 数据库实例 API 或相关工具（CLI、SDK、Terraform、DAB）在 2026 年 3 月 12 年至 5 月 11 日期间创建的 Lakebase 项目使用了较早的权限模型，其中应用了两个独立的 ACL 集：
- 数据库实例 ACL： 通过 数据库实例 API 设置和评估。
- Lakebase 项目 ACL： 通过 Lakebase 自动缩放 UI 或 Postgres API 设置和评估。
这两个集可以授予不同级别的访问权限。 查看 数据库实例 和 Lakebase 项目 ACL 集以了解有效权限。 Azure Databricks计划在将来的更新中统一这些实例的权限。
项目名称和实例名称
通过 数据库实例 API 或 Lakehouse/Provisioned UI 创建 Lakebase 实例时，指定的实例名称将成为生成的 Lakebase 自动缩放项目的项目 ID（project_id）。 始终使用 ID production创建根分支。
实例名称和项目 ID 必须 符合 DNS。 项目 ID 的唯一性不区分大小写，这意味着在同一工作区中，不能同时使用 ABC 和 abc 作为项目 ID。 使用 Postgres API 时，请使用小写项目 ID。 如果项目 ID 与现有项目 ID 冲突，则创建失败。
项目还有一个显示名称（display_name），它独立于项目 ID，不受 DNS 符合性要求的约束。
在 Postgres API 中，项目资源 name 返回时采用路径格式 projects/{project_id}（例如 projects/my-instance），而不是 Database instance API 使用的不带路径的实例名称。 请参阅 “列出项目”。
分支和项目重命名
与实例名称一样，创建后无法更改项目 ID 和分支 ID。 但是，项目还有一个随时可以更新的显示名称（display_name）。
子数据库实例
对于 子 数据库实例（子实例对应于自动缩放项目中的分支）：
- 分支 ID。 在 数据库实例 API 中指定的子实例名称将成为自动缩放 UI 中的分支 ID。
- 分支限制。 使用 Postgres API 或自动缩放 UI，可以创建任意数量的分支。 使用 数据库实例 API，只能创建一个父实例（一个根分支）和一个子实例（一个子分支），这与以前的数据库实例 API 行为匹配。
- 标记和预算。 自定义标记和使用策略 继承自父分支。 这是与以前的 数据库实例 API 行为（其中子实例具有其自己的单独值）的更改。
- 删除子实例。 如果在与子实例相对应的项目中使用 Lakebase 自动缩放 UI 或 Postgres API 创建其他分支，则在删除所有这些分支之前，无法通过 Lakehouse/Provisioned UI 或 API 删除该子实例。 首先删除分支（使用自动缩放 UI 或 Postgres API），然后删除子实例。
受保护的分支
如果保护使用 数据库实例 API 创建的项目上的分支（分支是对应于子实例还是所创建的任何其他分支），则除非分支不受保护，否则不能通过 Lakehouse/Provisioned UI 或 API 删除该子实例或根实例（父实例）。 首先取消保护 Lakebase 自动缩放 UI 中的分支，然后删除该实例。 请参阅 受保护的分支。
个人预览版功能
新建的项目是 Lakebase 自动缩放项目，不支持 Lakebase 预配 的数据 API 或 转发 ETL 个人预览功能。 这些是Provisioned上的独立产品。
- REST API 访问（PostgREST 风格）：Lakebase 自动扩缩容拥有专属数据 API，支持兼容 PostgREST 的 REST 访问（CRUD、查询、RPC）。
- 将数据同步到 Lakehouse：Lakebase Autoscaling 提供 Lakebase 变更数据馈送，这与 Lakebase Provisioned 上处于私有预览阶段的 Forward ETL 不同。
将现有预配实例升级到自动缩放
Azure Databricks已将所有Lakebase Provisioned实例升级为Lakebase自动扩展平台。 升级工程于2026年7月完成。
升级是自动的。 转换期间，连接会短暂重启。 现有的连接字符串、API 调用、声明性自动化捆绑包和 Terraform 配置将继续工作，而无需修改。
注释
升级仅更改计算平台，而不是数据。 保留所有数据库对象：架构、表、索引、主键、外键、Postgres 角色和授予。 DLT 管道 ID 也会被保留。
升级后，将应用以下更改：
计算资源规格。 你的实例的预配容量会映射到自动扩缩容的最小/最大 CU 范围。 映射表参见计算资源规格。 可以使用 Lakebase 自动缩放 UI 或 Postgres API 在升级后更改最小/最大 CU。
这两个 UI 都可用。 实例可以通过新的自动缩放 UI 和熟悉的预配 UI 进行管理，该 UI 将一直可用到 2026 年 9 月 1 日。
项目名称和显示名称。 升级会保留项目 ID 和 UID。 显示名称（
display_name）会加上(upgraded)后缀，因此名为my-instance的实例在自动扩缩容 UI 和my-instance (upgraded)中会显示为 。 升级后的实例同时出现在 数据库实例 API 和 Postgres API 中，每个实例的 UID 相同。新的区域连接字符串。 每个实例会获得一个新的区域连接字符串，其入站访问已优化。 您现有的全局连接字符串可在 Provisioned UI 中获取；您新的区域连接字符串可在 Autoscaling UI 中获取。
- 现有连接字符串。 已预配的连接字符串（不含区域信息）仍可通过现有的入站 专用链接 正常工作，并且不需要 Service Direct 专用链接。
- 新的区域连接字符串。 如果您使用 专用链接，并从 Azure Databricks 工作区外部连接到 Lakebase，则必须为性能密集型服务配置入站 专用链接，才能使用新的区域连接字符串。
DAB 和 Terraform。 若要使用新的自动缩放功能（例如缩容到零），请更新您的捆绑包，使其使用
postgres_projects（请参阅 捆绑包资源），或更新您的 Terraform 配置，使其使用 databricks_postgres_project 资源。 有关分步 Terraform 操作指南，请参阅更新你的 Terraform 配置以使用自动扩缩容资源。前向 ETL（专用预览）。 Lakebase Provisioned 上的 Forward ETL 专属预览功能已不再受支持，并将在未来的更新中不可用。 要在升级后继续将数据同步到湖屋，请在自动扩缩容平台上设置 Lakebase 变更数据馈送。
REST API PostgREST （个人预览版）。 Lakebase Provisioned 上的 REST API （PostgREST） 个人预览版功能在升级后继续工作，但不再受支持，将来的更新将不可用。 其替换项 （数据 API）在自动缩放平台上可用。
高可用性。 如果在预配实例上启用了高可用性，则在升级后会保留它。
自动缩放增强功能。 你的实例支持自动缩放功能。 Lakebase 自动扩缩容新增了自动扩缩容、缩容至零、时间点还原、快照、维护时段调度、数据库分支等功能增强。 有关详细信息，请参阅 Lakebase 自动缩放。
注释
对于已升级的实例，默认情况下不启用缩减到零。 与新实例不同，后者默认启用了缩减为零功能，并将非活动超时时间设为 24 小时；升级后的实例则需要您手动启用缩减为零功能。 参见 缩放到零。
优化的存储缓存。 升级后，Lakebase 在其存储缓存中为项目的根分支确定数据优先级，从而优化查询延迟。 可以通过将其标记为 受保护的分支来确定升级后的不同分支的优先级。
每个分支的角色和数据库。 Lakebase 自动缩放限制为每个分支 500 个 Postgres 角色和 500 个数据库。 Lakebase Provisioned 没有这样的限制。 对于超出这些限制的实例，升级通常完成，但之后无法创建其他角色或数据库。 如果你认为实例受到影响，请联系你的帐户团队或Azure Databricks支持部门。
已暂停的实例 升级后，连接到暂停的实例将返回错误
The endpoint has been disabled. Enable it using the API and retry。 要恢复访问权限，请将spec.disabled: false设置为update_mask=spec.disabled，以重新启用计算资源。 参见 禁用或启用计算。定价。 升级后，将适用 Lakebase GA 定价。 随着弹性计算取代固定大小的实例，大多数客户都会看到计算成本的降低。 Lakebase 自动扩缩容还包含全天候计算资源定价。 有关当前费率，请参阅 Lakebase 定价页。
特征存储和模型服务。 Databricks 联机特征存储由 Lakebase 自动缩放提供支持。 现有的功能服务和模型服务工作负载继续工作，无需执行任何操作。 对于通过功能工程客户端管理的在线商店，
create_online_store和update_online_store接口无需更改。 请参阅 功能存储和模型服务。Databricks Apps。 升级后，使用 Lakebase
database资源的应用将继续工作。 连接详细信息、环境变量和 Postgres 角色保持不变。 不要在您的应用配置中将database更改为postgres。 这样做会创建新的 Postgres 角色并中断对现有数据的访问。 对于新应用，请使用app.resources.postgres。 请参阅 将 Lakebase 资源添加到 Databricks 应用。模型服务上的智能体。 升级后，具有 Lakebase 连接的代理将继续工作。 Azure Databricks建议将代理迁移到 Databricks 应用以利用自动缩放功能。 请参阅 将代理从模型服务迁移到 Databricks 应用。
若要请求加速升级，或者如有疑问，请联系客户团队或Azure Databricks支持部门。