描述策略

适用于:检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 16.4 及更高 版本检查标记为“是 Unity 目录”

将策略的详细信息显示为属性值对。

要运行此语句,您必须对目标拥有READ METADATAMANAGE可担保或拥有该目标的权限。 READ METADATA 授予对策略的只读可见性; MANAGE 创建、编辑或删除策略仍需要所有权。 要描述一个策略 ON METASTORE (Beta),你必须在元商店上有 READ METADATA ,或者是元商店管理员。

Syntax

{ DESC | DESCRIBE } 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 }

参数

结果

该语句返回格式化报表。 所包含的字段取决于政策类型。 未在策略中设置的字段被省略。 被治理标签以逗号分隔的条目列出策略使用的受控标签引用: key 对于仅键引用,策略 key:value 引用特定标签值时。

示例

> DESCRIBE POLICY rf ON TABLE datagov.test.orders;

Name                    rf
On Securable Type       TABLE
On Securable            datagov.test.orders
To Principals           account users
For Securable Type      TABLE
Match Columns           has_tag('priority') AS u1
Policy Type             ROW_FILTER
  Function Name         datagov.test.hide_urgent_orders
  Using Columns         u1
Created By              user@example.com
Created At              2025-12-31 AD at 19:41:07 UTC
Updated By              user@example.com
Updated At              2026-01-01 AD at 22:01:17 UTC
Governed Tags           priority

以下示例介绍一个 ABAC GRANT 策略,该策略报告目标安全对象类型和已授予的权限:

> DESCRIBE POLICY grant_anthropic_model_services ON SCHEMA system.ai;

Name                    grant_anthropic_model_services
On Securable Type       SCHEMA
On Securable            system.ai
Comment                 Grant EXECUTE on Anthropic model services
To Principals           data_scientists
Except Principals       contractors
For Securable Type      MODEL_SERVICE
When Condition          has_tag_value('ai.model_creator', 'anthropic')
Policy Type             GRANT
  Granted Privileges    EXECUTE
Created By              user@example.com
Created At              2026-08-26 AD at 14:02:11 UTC
Updated By              user@example.com
Updated At              2026-08-26 AD at 14:02:11 UTC
Governed Tags           ai.model_creator:anthropic