BELEID BESCHRIJVEN

Van toepassing op:aanvinkteken ja Databricks SQL aanvinkteken ja Databricks Runtime 16.4 en hoger aanvinkteken ja alleen Unity Catalog

Geeft de details weer van een beleid als paren met eigenschapswaarden.

Om deze verklaring te kunnen uitvoeren, moet je het READ METADATA of MANAGE privilege op het doelwit, of het bezitten, of het bezitten. READ METADATA biedt alleen-lezen inzicht in het beleid; MANAGE of eigendom is nog steeds vereist om beleid te maken, te bewerken of te verwijderen. Om een beleid ON METASTORE (Beta) te beschrijven, moet je op de metastore zitten READ METADATA of een metastore-beheerder zijn.

Syntaxis

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

Parameterwaarden

  • policy_name

    De naam van het beleid dat moet worden beschreven. Als het beleid niet bestaat op het beveiligbare, verhoogt Azure Databricks POLICY_NOT_FOUND.

  • catalog_name

    De naam van de catalogus waarop het beleid is gedefinieerd.

  • schema_name

    De naam van het schema waarop het beleid is gedefinieerd.

  • table_name

    De naam van de tabel waarop het beleid is gedefinieerd.

Resultaat

De instructie retourneert een opgemaakt rapport. De opgenomen velden hangen af van het type polis. Velden die niet in het beleid zijn ingesteld, worden weggelaten. Bestuurde Tags vermeldt de door het beleid gebruikte bestuurde tagreferenties als komma-gescheiden items: key voor een sleutel-only referentie en key:value wanneer het beleid een specifieke tagwaarde verwijst.

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@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

Het volgende voorbeeld beschrijft een ABAC-beleid GRANT , dat het doel-secucurable type en de toegekende privileges rapporteert:

> 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
  • Laatst bijgewerkt om