适用于:
Databricks SQL
,Databricks Runtime
”,仅限 Unity 目录
Important
此功能目前以公共预览版提供。
INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS 为附加到安全对象的每个 ABAC 策略返回一行。 每行描述策略定义,包括其附件范围、策略类型、包括和免除主体,以及用于强制实施策略的条件。
要列出元存储级别策略(Beta),以及整个元存储中的所有ABAC策略,请查询 SYSTEM.INFORMATION_SCHEMA.ABAC_POLICY_DEFINITIONS。
只有当你拥有 READ METADATA 或 MANAGE 在附带保单的担保上,或者拥有它时,你才会看到保单被退回。 这与 DESCRIBE POLICY 的访问模式匹配。
此关系是 SQL 标准信息架构的扩展。
定义
ABAC_POLICY_DEFINITIONS 关系包含以下字段:
| 名称 | 数据类型 | 可为 Null | Description |
|---|---|---|---|
POLICY_ID |
STRING |
No | 策略的唯一标识符。 |
POLICY_NAME |
STRING |
No | 策略的名称。 |
POLICY_TYPE |
STRING |
No | 策略类型。 例如,ROW_FILTER、COLUMN_MASK、GRANT 或 DENY。 |
CATALOG_NAME |
STRING |
Yes | 策略附加到的目录的名称,或包含策略所附加到的架构或表。
NULL 用于元存储附加策略(Beta)。 |
SCHEMA_NAME |
STRING |
Yes | 策略附加到的架构的名称,或包含该策略所附加到的表。
NULL 用于元存储附加策略和目录附加策略。 |
SECURABLE_NAME |
STRING |
Yes | 策略附加到的安全对象的名称。
NULL 用于元存储附加、目录附加和架构附加策略。 |
ON_SECURABLE_TYPE |
STRING |
No | 该策略所附加的可保障对象类型: METASTORE (Beta)、 CATALOG、 SCHEMA、 或 TABLE。 |
TO_PRINCIPALS |
ARRAY<STRING> |
No |
策略适用的主体 (用户、组或服务主体)。 如果未设置空数组,则为空数组 [] 。 |
EXCEPT_PRINCIPALS |
ARRAY<STRING> |
No |
从策略应用程序中排除的主体。 排除无值时为空数组 [] 。 |
FOR_SECURABLE_TYPE |
STRING |
No | 可担保的类型是保单目标。 例如,对于TABLE行筛选和列遮罩,或者MODEL用于策略,比如 , MODEL_SERVICE, MODEL_PROVIDER_SERVICEAGENT_SERVICEMCP_SERVICE, (Beta) SKILL 或 (Beta) GRANT 用于策略。 在策略中 DENY ,该特权被拒绝的可保障类型,如 CATALOG、 SCHEMA或 TABLE。 |
PRIVILEGES |
ARRAY<STRING> |
Yes | 保单授予或拒绝的特权。
NULL for ROW_FILTER 和 COLUMN_MASK policies。 |
WHEN_CONDITION |
STRING |
Yes | 应用策略的条件表达式。 例如,一个布尔表达式,该表达式根据表的受治理标记匹配。 |
MATCH_COLUMNS |
ARRAY<STRING> |
Yes | 策略引用的列。
NULL for GRANT 和 DENY policies。 |
GOVERNED_TAGS |
ARRAY<STRUCT<tag_key: STRING, tag_value: STRING>> |
No |
策略引用的受治理标记 。
tag_value 当引用仅指定键时为 NULL 。 键相同但值不同的引用会作为独立元素出现。 当策略不引用任何被治理的标签时,空数组 [] 。 |
CREATED_BY |
STRING |
No | 创建策略的主体。 |
示例
-- List every GRANT policy in the current catalog.
> SELECT *
FROM information_schema.abac_policy_definitions
WHERE policy_type = 'GRANT';
-- List every DENY policy in the current catalog.
> SELECT *
FROM information_schema.abac_policy_definitions
WHERE policy_type = 'DENY';
-- Find all row filters and column masks attached to securable objects in a schema.
> SELECT policy_name, policy_type, on_securable_type, securable_name, when_condition, match_columns
FROM information_schema.abac_policy_definitions
WHERE policy_type IN ('ROW_FILTER', 'COLUMN_MASK')
AND catalog_name = 'my_catalog'
AND schema_name = 'my_schema';
-- Find policies that reference the `priority` governed tag.
> SELECT policy_name, policy_type, on_securable_type, securable_name
FROM information_schema.abac_policy_definitions
WHERE exists(governed_tags, tag -> tag.tag_key = 'priority');