DESCRIVERE I CRITERI

Si applica a:selezionato con sì Databricks SQL selezionato con sì Databricks Runtime 16.4 e versioni successive selezionato con sì solo per Unity Catalog

Mostra i dettagli di un criterio come coppie proprietà-valore.

Per eseguire questa dichiarazione, devi avere il READ METADATA privilegio o MANAGE sul secure target o possederlo. READ METADATA garantisce visibilità in sola lettura della polizza; MANAGE oppure è comunque richiesta la proprietà per creare, modificare o eliminare le politiche. Per descrivere una policy ON METASTORE (Beta), devi avere READ METADATA un metastore o essere un amministratore del metastore.

Sintassi

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

Parametri

  • policy_name

    Nome del criterio da descrivere. Se il criterio non esiste nell'entità a protezione diretta, Azure Databricks genera POLICY_NOT_FOUND.

  • catalog_name

    Nome del catalogo in cui è definito il criterio.

  • schema_name

    Nome dello schema in cui è definito il criterio.

  • table_name

    Nome della tabella in cui è definito il criterio.

Result

L'istruzione restituisce un report formattato. I campi inclusi dipendono dal tipo di polizza. I campi non indicati nella polizza vengono omessi.

Examples

> 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

Il seguente esempio descrive una policy ABAC GRANT , che riporta il tipo di securable target e i privilegi concessi:

> 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
  • Last updated on