创建策略

适用于:已勾选“是”的 Databricks SQL,已勾选“是”的 Databricks Runtime 16.4 及以上版本,仅限 Unity Catalog

在安全对象上创建命名策略。 策略可以是行筛选、列遮罩或 ABAC GRANT 策略。 行筛选和列遮罩应用于目录、模式或表,并且可在Databricks Runtime 16.4及以上版本中使用。 ABAC GRANT 策略应用于目录、模式或 支持的非容器可保障资产,并动态赋予目标可保障资产权限。 你也可以在元商店附加一个策略,这样它就能覆盖元商店的每个目录。 参见Metastore级别的ABAC政策(Beta版)。 策略名称的范围限定为定义策略的安全对象。

若要运行此语句,你必须对目标安全对象或其所有者具有 MANAGE 特权。 要创建策略 ON METASTORE (测试版),你必须是元商店管理员。

使用 SQL 创建、修改或删除 ABAC GRANT 策略或 DENY 策略(Beta)需要 Databricks 运行时 18 LTS 及以上。 在 SQL 仓库中,支持取决于仓库的发布渠道。 请参阅策略和DENY策略的计算需求GRANT。

使用 SQL 创建、修改或丢弃元存储级别策略(Beta)需要 Databricks 运行时 19 及以上。 请参阅 计算要求。

注释

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

Syntax

CREATE [ OR REPLACE ] POLICY policy_name
ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name | TABLE table_name
   | { MODEL SERVICE | MODEL PROVIDER SERVICE | MCP SERVICE | AGENT SERVICE | SKILL } securable_name }
[ COMMENT description ]
{ row_filter_body | column_mask_body | grant_policy_body }

row_filter_body
  ROW FILTER function_name
  TO principal [, ...]
  [ EXCEPT principal [, ...] ]
  FOR TABLES
  [ WHEN condition ]
  [ MATCH COLUMNS condition [ [ AS ] alias ] [, ...] ]
  [ USING COLUMNS ( function_arg [, ...] ) ]

column_mask_body
  COLUMN MASK function_name
  TO principal [, ...]
  [ EXCEPT principal [, ...] ]
  FOR TABLES
  [ WHEN condition ]
  [ MATCH COLUMNS condition [ [ AS ] alias ] [, ...] ]
  ON COLUMN alias
  [ USING COLUMNS ( function_arg [, ...] ) ]

grant_policy_body
  TO principal [, ...]
  [ EXCEPT principal [, ...] ]
  GRANT privilege [, ...]
  FOR grant_target_type
  [ WHEN condition ]

行过滤和列掩码策略可以在元存储(Beta)、目录、模式或表上定义。 GRANT 策略可以在元存储库、目录、模式或 支持的非容器可安全环境中定义。 ON METASTORE 不使用任何名称,目标是你当前运营的元商店。

参数

  • policy_name

    策略的名称。 该名称的范围限定为策略定义的安全对象。 如果已存在同名且 OR REPLACE 未指定策略,Azure Databricks 将引发 POLICY_ALREADY_EXISTS。

  • catalog_name

    在其中定义策略的目录的名称。 如果策略不支持安全对象类型,Azure Databricks 将引发 POLICY_ON_SECURABLE_TYPE_NOT_SUPPORTED。

  • schema_name

    定义策略的架构的名称。

  • table_name

    定义策略的表的名称。

  • securable_name

    该保单所附加的非集装箱担保的完全限定名称(catalog.schema.name)为()。

  • 说明

    策略的可选字符串注释。

  • function_name

    用于行筛选器或列掩码的 UDF 的名称。

  • privilege

    在 grant_policy_body,每一个与保单匹配的证券资产上,可以授予特权。 有效的权限依赖于 grant_target_type。 参见 支持的可安全类型和权限。

  • grant_target_type

    在 grant_policy_body中,授予的特权适用于担保类型。 使用复数形式:MODELS、MODEL SERVICES、 AGENT SERVICESMODEL PROVIDER SERVICESMCP SERVICES、(Beta)或(Beta)。SKILLS 下划线的形式,如 MODEL_SERVICES,也被接受。 单数形式不被接受。

  • principal

    用户、组或服务主体名称。 可以在之后 TO列出多个主体。 从策略中排除之后 EXCEPT 列出的主体。

  • 条件

    WHEN 是一个布尔表达式,根据可保护对象的标签、查询用户的身份属性和/或请求上下文,判断该策略是否适用。

    MATCH COLUMNS 是一个基于标签匹配列的布尔表达式(例如, has_tag('pii'))。

    控制平面对条件进行评估。 以下功能在条件下支持:

    • 标签函数(has_tag()和has_tag_value()):在和WHENMATCH COLUMNS中都支持。 在 WHEN中使用时,它们检查直接放置在表上的标签,或从父目录或模式继承的标签。 使用 MATCH COLUMNS时,它们仅检查直接在列上设置的标记。 较旧的 camelCase 窗体 (hasTag, hasTagValue) 继续工作以实现向后兼容性。
    • 身份属性函数 (has_identity_attribute_value() 和 has_identity_attribute_tag_match()):支持 WHEN 列掩码策略的条款,它们评估执行查询的用户 的身份属性 。 它们在政策DENYMATCH COLUMNS或GRANT 参见“ 基于查询用户属性掩盖列”。
    • 上下文属性函数 (has_context_attribute() 和 has_context_attribute_value()):支持行 WHEN 过滤和列遮罩策略的子句,它们在这些条款中评估请求的上下文,例如调用应用程序。 它们在 MATCH COLUMNS. 参见“ 限制代表用户行动的外部代理访问”。

    如果条件无效,Azure Databricks 将引发 UC_INVALID_POLICY_CONDITION。

  • alias

    在中 MATCH COLUMNS,匹配列的可选 标识符 。 别名可以在(行筛选器)或列掩码中 USING COLUMNSON COLUMNUSING COLUMNS 引用。

  • function_arg

    在中USING COLUMNS,每个参数都是常量表达式或别名。MATCH COLUMNS 参数按顺序传递给策略函数。 如果选项与策略类型不匹配,Azure Databricks 将引发 UC_POLICY_TYPE_OPTIONS_MISMATCH。

示例

以下示例创建列掩码策略:

> CREATE FUNCTION ssn_to_last_nr (ssn STRING, nr INT) RETURNS STRING
    RETURN right(ssn, nr);

> CREATE POLICY ssn_mask
    ON CATALOG employees
    COLUMN MASK ssn_to_last_nr
    TO 'All Users' EXCEPT 'HR admins'
    FOR TABLES
    MATCH COLUMNS has_tag('ssn') AS ssn
    ON COLUMN ssn
    USING COLUMNS (4);

以下示例创建行筛选器策略:

> CREATE FUNCTION non_eu_region (geo_region STRING) RETURNS BOOLEAN
    RETURN geo_region <> 'eu';

> CREATE POLICY hide_eu_customers
    ON SCHEMA prod.customers
    COMMENT 'Hide European customers from sensitive tables'
    ROW FILTER non_eu_region
    TO analysts
    FOR TABLES
    WHEN has_tag_value('sensitivity', 'high')
    MATCH COLUMNS has_tag('geo_region') AS region
    USING COLUMNS (region);

以下示例创建了一个ABACGRANT策略,对每个Anthropic创建的模型服务都授予EXECUTE:

> CREATE POLICY grant_anthropic_model_services
    ON SCHEMA system.ai
    COMMENT 'Grant EXECUTE on Anthropic model services'
    TO data_scientists
    EXCEPT contractors
    GRANT EXECUTE FOR MODEL SERVICES
    WHEN has_tag_value('ai.model_creator', 'anthropic');