DESCRIBIR DIRECTIVA

Se aplica a:marcado con sí Databricks SQL marcado con sí Databricks Runtime 16.4 y versiones posteriores marcado con sí solo Unity Catalog

Muestra los detalles de una directiva como pares de valor de propiedad.

Para ejecutar esta declaración, debes tener el READ METADATA privilegio o MANAGE el o el derecho a asegurar del objetivo, o ser propietario de ella. READ METADATA otorga una visibilidad de solo lectura sobre la póliza; MANAGE o que aún se requiere la propiedad para crear, editar o eliminar políticas. Para describir una política ON METASTORE (Beta), debes estar READ METADATA en la metastore o ser administrador de metastore.

Sintaxis

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

Parámetros

  • policy_name

    Nombre de la directiva que se va a describir. Si la directiva no existe en el elemento protegible, Azure Databricks genera POLICY_NOT_FOUND.

  • catalog_name

    Nombre del catálogo en el que se define la directiva.

  • schema_name

    Nombre del esquema en el que se define la directiva.

  • table_name

    Nombre de la tabla en la que se define la directiva.

Resultado

La instrucción devuelve un informe con formato. Los campos incluidos dependen del tipo de póliza. Se omiten los campos que no están establecidos en la política.

Ejemplos

> 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

El siguiente ejemplo describe una política ABAC GRANT , que informa del tipo de seguro objetivo y de los privilegios concedidos:

> 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