BESCHREIBEN DER RICHTLINIE

Gilt für:mit Häkchen markiert ja Databricks SQL mit Häkchen markiert ja Databricks Runtime 16.4 und höher mit Häkchen markiert ja nur Unity Catalog

Zeigt die Details einer Richtlinie als Eigenschaftswertpaare an.

Um diese Aussage auszuführen, müssen Sie das READ METADATA oder MANAGE das Privileg auf dem Ziel sichern oder es besitzen. READ METADATA gewährt Readnur-Einblick in die Politik; MANAGE oder Eigentum ist weiterhin erforderlich, um Richtlinien zu erstellen, zu bearbeiten oder zu löschen. Um eine Richtlinie ON METASTORE (Beta) zu beschreiben, musst du sie im Metastore haben READ METADATA oder als Metastore-Administrator tätig sein.

Syntax

{ DESC | DESCRIBE } POLICY policy_name ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name | TABLE table_name }

Parameter

  • policy_name

    Der Name der zu beschreibenden Richtlinie. Wenn die Richtlinie für die sicherungsfähige Richtlinie nicht vorhanden ist, löst Azure Databricks POLICY_NOT_FOUND aus.

  • catalog_name

    Der Name des Katalogs, in dem die Richtlinie definiert ist.

  • schema_name

    Der Name des Schemas, für das die Richtlinie definiert ist.

  • table_name

    Der Name der Tabelle, in der die Richtlinie definiert ist.

Ergebnis

Die Anweisung gibt einen formatierten Bericht zurück. Die enthaltenen Felder hängen vom Versicherungstyp ab. Felder, die in der Richtlinie nicht festgelegt sind, werden weggelassen.

Beispiele

> 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@databricks.com
Created At              2025-12-31 AD at 19:41:07 UTC
Updated By              user@databricks.com
Updated At              2026-01-01 AD at 22:01:17 UTC

Das folgende Beispiel beschreibt eine ABAC-Politik GRANT , die den Ziel-Securable-Typ und die gewährten Privilegien meldet:

> 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@databricks.com
Created At              2026-08-26 AD at 14:02:11 UTC
Updated By              user@databricks.com
Updated At              2026-08-26 AD at 14:02:11 UTC