ABAC GRANT 策略

ABAC GRANT 策略动态向治理标记匹配条件的安全对象授予 Unity Catalog 权限。 本页介绍如何创建、编辑、列出和删除 ABAC GRANT 策略、GRANT 策略如何与直接授予交互以及当前范围和限制。

可以使用目录资源管理器、SQL 或 REST API 为任何受支持的安全对象类型创建和管理 ABAC GRANT 策略。

有关 ABAC 和核心概念的概述(包括治理标签以及 has_tag 和 has_tag_value 等内置函数),请参阅 基于属性的访问控制 (ABAC) 的核心概念。

计算要求

使用 SQL 创建、修改或删除 GRANT 策略需要运行 Databricks Runtime 18 LTS 或更高版本的 经典计算资源 。

Note

Databricks Runtime 18 比 Databricks Runtime 18.0、18.1 和 18.2 更新。 以前会作为后续编号版本发布的功能,现在改为作为 Databricks Runtime 18 的按日期命名更新发布。 有关详细信息,请参阅 关于统一发行说明。

什么是 GRANT 策略

GRANT 策略是基于属性的访问控制策略,可动态向其受管标签与策略条件匹配的安全对象授予 Unity 目录特权。 每次检查访问时,Unity 目录都会根据策略范围中每个安全对象上受治理的标记评估策略 WHEN 的条件,并授予对匹配的每个安全对象的权限。

相比之下,直接的 GRANT 语句会将权限授予由其三级命名空间(catalog.schema.object)标识的可保护对象。

GRANT 策略可以引用自己创建的受治理标记,也可以引用在条件中由Azure Databricks预定义的系统标记。

GRANT 策略示例

这些示例适用于客户注册的MLflow模型和Azure Databricks托管的基础模型system.ai。 有关 MLflow 模型如何在 Unity 目录中注册的信息,请参见 Unity 目录中的模型生命周期管理。

以下策略使用 lifecycle 应用于客户注册的MLflow模型 production.ml_models的受控标签。 该策略仅向带有EXECUTE标记的模型授予lifecycle = 'production':

CREATE POLICY grant_production_model_access
ON SCHEMA production.ml_models
COMMENT 'Grant EXECUTE on production MLflow models'
TO `analysts`
GRANT EXECUTE FOR MODELS
WHEN has_tag_value('lifecycle', 'production');

以下策略使用预先应用的ai.model_creator系统标签,将EXECUTE中的每个由Anthropic托管的基础模型的system.ai授予data_scientists,contractors除外。 此策略会自动涵盖 Azure Databricks 后续添加的任何 Anthropic 模型:

CREATE POLICY grant_anthropic_foundation_models
ON SCHEMA system.ai
COMMENT 'Grant EXECUTE on Anthropic foundation models'
TO `data_scientists`
EXCEPT `contractors`
GRANT EXECUTE FOR MODELS
WHEN has_tag_value('ai.model_creator', 'anthropic');

使用直接授权实现同等访问时,需要在 system.ai 中为每个模型分别编写一条语句;每当 Azure Databricks 添加新的 Anthropic 模型时,都需要重新发布这些语句:

GRANT EXECUTE ON MODEL `system`.`ai`.`databricks-claude-sonnet-4-6` TO `data_scientists`;
GRANT EXECUTE ON MODEL `system`.`ai`.`databricks-claude-opus-4-7` TO `data_scientists`;
GRANT EXECUTE ON MODEL `system`.`ai`.`databricks-claude-haiku-4-5` TO `data_scientists`;

GRANT 策略与行筛选器和列掩码策略有两种不同:

  • 行筛选器和列掩码策略限制用户可以访问的数据内容。 GRANT 策略确定用户是否可以访问对象。

  • 行筛选器和列掩码策略需要用户定义的函数(UDF)来实现筛选器或掩码。 GRANT 策略不使用 UDF。 条件直接写在策略定义中。

你能授予的权利取决于可担保的类型。 有关支持类型及其可策略授予权限的完整列表,请参见 “支持的可保障类型和权限”。

支持的安全对象类型和权限

Important

对代理服务和技能的 GRANT 策略支持处于 Beta 阶段。 若要将 GRANT 策略与任一可保护对象类型一起使用,帐户管理员必须从帐户控制台的预览页面启用增强型 Unity AI 网关。 参见 管理 Databricks 预览版。 表中其他可担保类型通常可用。

下表显示了支持的类型及其可被策略授予的权限。 Unity Catalog 会在创建策略时验证你指定的权限是否符合可保护类型,并拒绝该类型不支持的任何权限。 “可用性”列显示每个安全对象类型的 GRANT-policy 支持的发布状态。

可担保类型 Availability APPLY_TAG EXECUTE MANAGE READ_METADATA READ_VOLUME WRITE_VOLUME
Model GA ✓ ✓ — ✓ — —
模型服务 GA ✓ ✓ ✓ ✓ — —
模型提供者服务 GA ✓ ✓ ✓ ✓ — —
MCP服务 GA ✓ ✓ ✓ ✓ — —
代理服务 Beta ✓ ✓ ✓ ✓ — —
Skill Beta ✓ — ✓ ✓ ✓ ✓

在 SQL 中,在 FOR 后使用 securable type 的复数形式,例如 GRANT EXECUTE FOR MODEL SERVICES 或 GRANT READ_VOLUME FOR SKILLS。 你可以用空格写成类型,写成 MODEL SERVICES,或者用下划线写成 MODEL_SERVICES。 单数形式不被接受。 在REST API中,设置为 for_securable_type 带有下划线的单数形式,例如 MODEL_SERVICE。

GRANT 策略可以附加到目录或架构。

关于你可以直接在每种对象类型上授予的所有权限,请参见 Unity 目录权限参考。

GRANT 策略如何与直接授权交互

对对象的有效特权是直接授予和任何适用的 GRANT 策略的并集。 这种联合逻辑适用于 支持的类型和权限 中每一种受支持的类型和权限。 以下示例在模型上使用 EXECUTE。 当符合以下任一情况时,主体即视为对某个模型持有 EXECUTE:

  • 附加到模型的目录或架构的 GRANT 策略将列出主体(在 TO 中,而不是在 EXCEPT 中),并且策略 WHEN 的条件与模型上的标记匹配。

  • GRANT EXECUTE直接对模型、其架构或其目录生效,无论是通过组成员身份授予,还是通过其他管理权限授予该主体。

由于访问是这些源的联合,因此更具选择性的 GRANT 策略并不意味着被排除的主体没有EXECUTE。 主体仍可以通过对模型或其父架构或目录的直接授予来保留权限。 如果打算使用 GRANT 策略作为对模型进行控制 EXECUTE 的主要方法,请先确定任何已存在的直接授权是否可能覆盖该策略:

  • 使用 SHOW EFFECTIVE POLICIES ON SCHEMA <parent_schema> (或 ON CATALOG <parent_catalog>) 列出其范围涵盖该架构或目录中的模型的每个 GRANT 策略。 SHOW EFFECTIVE POLICIES 不直接支持 ON MODEL。 等效的 REST API 为 GET /api/2.1/unity-catalog/policies/{on_securable_type}/{on_securable_fullname}?include_inherited=true (Python SDK: w.policies.list_policies(..., include_inherited=True))。

  • 使用模型及其祖先对象上的 SHOW GRANTS 来枚举直接授权。 对于可保护对象上的直接授予权限,对应的 REST API 是 GET /api/2.1/unity-catalog/permissions/{securable_type}/{full_name}(Python SDK:w.grants.get(...));对于直接授予权限和继承权限的并集,请使用 GET /api/2.1/unity-catalog/effective-permissions/{securable_type}/{full_name}(Python SDK:w.grants.get_effective(...))。

创建 GRANT 策略

可以通过目录资源管理器 UI、 CREATE POLICY SQL 语句或 REST API 创建 GRANT 策略。

若要创建 GRANT 策略,您必须对附加了该策略的目录或架构具有 MANAGE,或者拥有该安全对象。

目录浏览器

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。

  2. 选择要在其中附加策略的目录或架构。 GRANT 策略只能附加到目录或模式级别。

  3. 单击“策略”选项卡。

  4. 单击“新建策略”。

  5. 在 “策略标识”下,输入 策略名称和 可选 说明。

  6. 在 主体和范围下:

    • 在 “应用于”中,选择策略适用的主体(用户、组或服务主体)。

    • 在“除外”中,可选择要排除在策略之外的主体。

    • 在 Scope 中,确认附加策略的目录或架构。

  7. 在 “策略类型”下,选择“ 授予访问权限”。

  8. 在 可保障对象中,选择该策略适用的可保障类型。 参见 支持的类型和权限。

  9. 在 “条件”下,选择如何将策略范围限定为目录或架构中所选类型的安全对象:

    • 没有条件 将该政策适用于所选目录或模式下所有该类型的担保资产。

    • 与以下任一标签匹配的受保护对象 仅将策略应用于至少带有一个所选治理标签的受保护对象。

    • 与自定义表达式匹配的受保护对象允许您编写基于标签的表达式,以确定该策略适用于哪些受保护对象。 有关可用 条件函数,请参阅“条件”和“内置函数 ”。

  10. 在 “特权”中,选择要授予的特权。 可用的权利取决于你选择的担保类型。 参见 支持的类型和权限。

  11. 单击“ 显示代码 ”,在保存之前查看等效的 SQL 语句,然后单击“ 创建策略”。

SQL

GRANT 策略的 SQL 语法使用 GRANT ... FOR ... WHEN ... 主体代替 ROW FILTER 或 COLUMN MASK。

CREATE [OR REPLACE] POLICY policy_name
ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name }
[COMMENT description]
TO principal [, ...]
[EXCEPT principal [, ...]]
GRANT privilege [, ...] FOR securable_type
[WHEN condition]

Parameters:

  • policy_name:策略的名称。 在同一安全对象上定义的所有策略中必须是唯一的。

  • ON { METASTORE | CATALOG | SCHEMA }:附加策略的范围。 GRANT 策略可以附加到元存储、目录或架构模式级别,而不能附加到单个安全对象。 用 ON METASTORE 来在元商店的每个目录中应用该策略。 ON METASTORE 无需指定名称,并作用于你当前正在操作的元存储。 参见Metastore级别的ABAC政策(Beta版)。

  • TO principal [, ...]:策略适用的用户、组或服务主体。

  • EXCEPT principal [, ...]:负责人豁免于政策。

  • GRANT privilege [, ...] FOR securable_type:要授予的权限及其适用的安全对象类型。 有效的权限取决于类型。 参见 支持的类型和权限。

  • WHEN condition:基于标签的布尔表达式,用于确定策略在作用域内适用于哪些可保护对象。 使用内置函数 has_tag('tag_name') 和 has_tag_value('tag_name', 'tag_value'). 如果省略,则默认为 TRUE (适用于范围内所有类型的可保障资产)。 有关可用 条件函数,请参阅“条件”和“内置函数 ”。

以下策略授予 EXECUTE 对 analytics.tools 中每个被标记为金融领域的 MCP 服务的权限:

CREATE POLICY grant_finance_mcp_services
ON SCHEMA analytics.tools
COMMENT 'Grant EXECUTE on finance MCP services'
TO `analysts`
GRANT EXECUTE FOR MCP SERVICES
WHEN has_tag_value('domain', 'finance');

有关模型示例,请参阅 什么是 GRANT 策略。

REST API

此示例创建一个 GRANT 策略,该策略授予 EXECUTE 给 data_scientists,适用于 system.ai 中每个由 Anthropic 托管的基础模型,除了承包商:

curl -X POST "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @- << 'EOF'
{
  "name": "grant_anthropic_foundation_models",
  "comment": "Grant EXECUTE on Anthropic foundation models",
  "on_securable_type": "SCHEMA",
  "on_securable_fullname": "system.ai",
  "for_securable_type": "MODEL",
  "policy_type": "POLICY_TYPE_GRANT",
  "to_principals": ["data_scientists"],
  "except_principals": ["contractors"],
  "grant": {
    "privileges": ["EXECUTE"]
  },
  "when_condition": "has_tag_value('ai.model_creator', 'anthropic')"
}
EOF

name、on_securable_type、on_securable_fullname、for_securable_type、policy_type、to_principals 和 grant.privileges 为必填项。 comment、except_principals 和 when_condition 是可选的。

关于请求和响应的详细信息,请参见 REST API 参考中的 创建策略 。

在 grant.privileges 中有效的权限取决于 for_securable_type。 参见 支持的类型和权限。

编辑 GRANT 策略

目录浏览器

从策略所附加到的父目录或架构的“策略”选项卡中管理 GRANT 策略。

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。

  2. 选择策略附加到的目录或架构。

  3. 单击“策略”选项卡。

  4. 选择想要编辑的策略。

  5. 更新您想要更改的字段。

  6. 单击“更新策略”。

SQL

若要使用 SQL 编辑 GRANT 策略,请运行名称和目标相同的 CREATE OR REPLACE POLICY。 请参阅 “创建 GRANT 策略”。

REST API

与在 SQL 中不同 CREATE OR REPLACE POLICY , PATCH 支持部分更新。 使用 update_mask 查询参数指定要更改哪些字段。 仅会更新这些字段,而请求体中未包含的字段将保持不变。 如果你省略 update_mask了,请求体中的所有字段都会被更新。 如果你设update_mask为 *,请求体还必须包含所有必填字段:to_principals、、 for_securable_typepolicy_type和 grant.privileges。

此示例将 interns 添加到策略中排除的主体:

curl -X PATCH "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies/SCHEMA/system.ai/grant_anthropic_foundation_models?update_mask=except_principals" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}" \
  -H "Content-Type: application/json" \
  --data-binary @- << 'EOF'
{
  "except_principals": ["contractors", "interns"]
}
EOF

你发送的值是替换现有列表,而不是添加,所以你必须包含所有你想排除的主体,而不仅仅是新的。

删除 GRANT 策略

目录浏览器

从策略所附加到的父目录或架构的“策略”选项卡中管理 GRANT 策略。

  1. 在 Azure Databricks 工作区中,单击 Data icon.Catalog。

  2. 选择策略附加到的目录或架构。

  3. 单击“策略”选项卡。

  4. 选择策略。

  5. 单击“ 删除策略”。

SQL

若要使用 SQL 删除 GRANT 策略,请运行 DROP POLICY:

DROP POLICY grant_anthropic_foundation_models ON SCHEMA system.ai;

REST API

curl -X DELETE "https://${DATABRICKS_HOST}/api/2.1/unity-catalog/policies/SCHEMA/system.ai/grant_anthropic_foundation_models" \
  -H "Authorization: Bearer ${DATABRICKS_TOKEN}"

显示策略

使用 SHOW POLICIES 列出在安全对象上定义的策略。 使用 SHOW EFFECTIVE POLICIES 还可以包括从父作用域继承的策略,例如影响架构的目录级策略。

SHOW [EFFECTIVE] POLICIES ON { METASTORE | CATALOG | SCHEMA } securable_name

结果包括策略名称、策略类型、每个策略所定义的可保护对象的目录和架构,以及该可保护对象的类型和全名。 GRANT 策略将以策略类型 GRANT 返回,并同时返回在同一范围内附加的任何行筛选器、列掩码和 DENY 策略。 只有当策略在表上定义时,列 Table 才会被填充。 这适用于行过滤和列掩码策略。 对于 GRANT 和 DENY 策略,列 Table 为 NULL。

Example:

SHOW EFFECTIVE POLICIES ON SCHEMA system.ai;
Policy Name                        Policy Type  Catalog  Schema  Table  Comment                                       on_securable_type  on_securable_fullname
---------------------------------  -----------  -------  ------  -----  --------------------------------------------  -----------------  ---------------------
grant_anthropic_foundation_models  GRANT        system   ai      NULL   Grant EXECUTE on Anthropic foundation models  SCHEMA             system.ai

描述策略

用于 DESCRIBE POLICY 查看特定 GRANT 策略的详细信息。 需要在目标安全对象上具有 READ METADATA 或 MANAGE,或者拥有该对象的所有权。

{ DESC | DESCRIBE } POLICY policy_name ON { METASTORE | CATALOG | SCHEMA } securable_name

结果显示策略的属性作为键值对,包括名称、安全对象类型、安全对象名称、主体、特权和 WHEN 条件。

Example:

DESCRIBE POLICY grant_anthropic_foundation_models ON SCHEMA system.ai;
info_name info_value
Name 授权 Anthropic 基础模型
在安全对象类型上 SCHEMA
在 Securable 上 system.ai
致负责人 数据科学家
除负责人外 承包商
对于可保护类型 型号
策略类型 授予
授予的权限 EXECUTE
时间条件 has_tag_value(“ai.model_creator”、“人类”)

使用信息模式查询策略定义

可以使用以下方法 INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS查询当前编目中的 GRANT 策略定义:

SELECT *
FROM information_schema.abac_policy_definitions
WHERE policy_type = 'GRANT';

有关可用的列和更多示例,请参见 ABAC_POLICY_DEFINITIONS。

基础模型中的系统标签 system.ai

Azure Databricks 在system.ai中托管的基础模型预先附带了 GRANT 策略可直接引用的系统标记。 无需自行标记这些模型,才能在策略中使用它们。

Tag 示例值
ai.model_creator anthropic、openai、google、meta
ai.model_family claude-opus、gpt、gemini、qwen

对于在自己的目录和架构中注册的模型,请通过标准 Unity 目录标记工作流应用受治理的标记。 请参阅 受管控的标签。

策略配额

资源 Limit
每个元存储的策略(所有对象) 10,000
各元商店的政策,直接附带(测试版) 100
各目录的策略 100
各架构的策略 100

GRANT 和 DENY 策略为每个对象共享一个组合配额。 这些配额与 行筛选器和列掩码策略的配额分开。

审计日志

GRANT 策略创建、更改和删除操作记录为与行筛选器和列掩码策略相同的 createPolicy、deletePolicy、getPolicy 和 listPolicies 操作。 有关审核日志查询示例,请参阅 审核日志记录 。

最佳做法

  • 在 TO 和 EXCEPT 中使用组,而不是单个用户。 在策略中指定的组内添加或删除用户,无需编辑策略即可更改该策略的适用对象。

  • 在涵盖目标的最小范围内附加策略。 使用包含该策略要应用到的安全对象的最小范围。 更宽泛的作用范围会使不相关的受保护对象也被纳入该策略的标签匹配范围内,并可能在你无意授权的情况下授予访问权限。

  • 使用标签继承以实现安全的默认设置。 在父目录或架构中应用默认标记值,以便后代继承它们。 仅在需要不同值的特定对象上覆盖继承的标签。 将其与 EXCEPT 结合使用,以处理策略的受控例外。

  • 不要将 GRANT 策略和针对相同权限的直接授权混合使用。 对于可保护对象上的给定特权,请选择 GRANT 策略或直接授予,而不要同时选择两者。 GRANT 策略与直接授权合并,因此将它们混合用于同一安全对象上,会使判断谁具有访问权限以及审核更改变得更加困难。

  • 对 USE CATALOG 和 USE SCHEMA 先决条件使用直接授予,并对该类型支持的权限使用 GRANT 策略。 GRANT 策略不会授予访问安全对象所需的 USE CATALOG 和 USE SCHEMA 先决条件。 直接授予这些权限,并使用 GRANT 策略按标记限定该类型支持的权限范围,例如在支持的情况下使用 EXECUTE 这样的标记。

限制

  • CREATE MODEL 和 CREATE MODEL VERSION 权限不受 GRANT 策略支持,必须直接授予。 关于支持的 MODEL权限,请参见 支持类型和权限。

  • ALL_PRIVILEGES 和 MODIFY 不受 GRANT 策略支持。

  • 用户访问安全对象所需的前提权限 USE SCHEMA 和 USE CATALOG 不受 GRANT 策略支持,必须直接授予。

  • 策略可以附加在目录或模式上,而非单个可保护对象。

  • GRANT 策略授予的权限不会由 SHOW GRANTS 返回。

  • GRANT 策略未涵盖删除模型或模型版本。 有关如何删除模型版本和模型,请参阅 Unity 目录中的管理模型生命周期 。

  • 不能使用 Delta Sharing 来共享对其定义了 GRANT 策略的模型。 Delta Sharing 不支持共享模型服务、模型提供程序服务、MCP 服务或代理服务,无论 GRANT 策略是否适用。

更多信息

另请参阅在 Unity Catalog 中管理权限。