适用于:
Databricks SQL,
Databricks Runtime 16.4 及以上版本,![]()
在安全对象上创建命名策略。 策略可以是行筛选、列遮罩或 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 不使用任何名称,目标是你当前运营的元商店。
参数
-
策略的名称。 该名称的范围限定为策略定义的安全对象。 如果已存在同名且
OR REPLACE未指定策略,Azure Databricks 将引发 POLICY_ALREADY_EXISTS。 -
在其中定义策略的目录的名称。 如果策略不支持安全对象类型,Azure Databricks 将引发 POLICY_ON_SECURABLE_TYPE_NOT_SUPPORTED。
-
定义策略的架构的名称。
-
定义策略的表的名称。
securable_name
该保单所附加的非集装箱担保的完全限定名称(
catalog.schema.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');