ABAC_POLICY_DEFINITIONS

适用于:检查标记为“是”的 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');