【MICROSOFT】Data API Builder 支持复合 REST 路径

Microsoft 在 Data API Builder 2.0 中为 REST 端点加入了复合路径配置，允许按业务域或 schema 自定义实体的路径，从而将 API 表面与业务结构对齐而非数据库拓扑。该功能支持任意子段，可用于分组、权限或可读性优化，同时 DAB 仍负责生成端点、安全和查询行为。

概述

• Data API Builder (DAB) 2.0 已正式发布，新增为每个实体配置复合 REST 路径的能力。
• 目标是让 API 路径反映业务结构或所有权，而不是被数据库表名或拓扑强制约束。

生成与暴露 REST 端点

• DAB 动态生成 REST（以及 GraphQL、MCP）端点，内置分页、过滤、投影、缓存和限流等功能。
• REST 路径由三部分组成：主机名、全局运行时前缀（runtime.rest.path，默认 /api）和实体级路径（现在支持复合路径）。

配置示例

• 场景 1：简单路径
• runtime.rest.path: “/api”
• 实体 Customer 的 rest.path: “/Customer”

• 结果: https://localhost/api/Customer

• 场景 2：按业务域组织

• 将实体路径设为 “/sales/Customer”，生成 https://localhost/api/sales/Customer

• 可用于将销售、会计、支持等区域的实体分组，提升可读性。

• 场景 3：在路径中保留 schema

• 当 source.object 为 sales.Customer，可将 rest.path 设为 “/sales/Customer” 来反映 schema/所有权。
• 适合需要保持开发者熟悉结构的场景。

使用建议

• 简单系统可保持单段路径以降低复杂度。
• 大型或多团队系统可用复合路径以呈现业务域、团队或权限边界。
• DAB 仍负责端点生成、安全与查询行为，无需手写基础实现。

结语

• 复合 REST 路径让 API 更贴合业务与组织结构，提升可读性与维护性，同时保留 DAB 的自动化能力和内置功能。

这个改进让自动生成的 API 更贴合业务语义，便于大型团队协作与治理。

原文链接