DÉCRIRE LA STRATÉGIE

S’applique à :coche marqué oui Databricks SQL coche marqué oui Databricks Runtime 16.4 et versions ultérieures coche marqué oui Unity Catalog uniquement

Affiche les détails d’une stratégie sous forme de paires propriété-valeur.

Pour exécuter cette déclaration, vous devez avoir le READ METADATA privilège ou MANAGE sur le sécurisé cible, ou en être propriétaire. READ METADATA accorde une visibilité en lecture seule sur la police ; MANAGE ou la propriété est toujours requise pour créer, modifier ou supprimer des politiques. Pour décrire une politique ON METASTORE (Bêta), vous devez avoir READ METADATA un sur le métastore ou être administrateur du métastore.

Syntaxe

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

Paramètres

Résultat

L’instruction retourne un rapport mis en forme. Les champs inclus dépendent du type de police. Les champs non définis sur la police sont omis. Les balises gouvernées listent les références aux balises gouvernées utilisées par la politique sous forme d’entrées séparées par des virgules : key pour une référence uniquement à clé et key:value lorsque la politique fait référence à une valeur spécifique de l’étiquette.

Exemples

> 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

L’exemple suivant décrit une politique ABAC GRANT , qui rapporte le type de sécurisable cible et les privilèges accordés :

> 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