OPIS ZASAD

Dotyczy:oznaczone jako tak Databricks SQL, oznaczone jako tak Databricks Runtime 16.4 i nowsze, oznaczone jako tak tylko katalog Unity

Przedstawia szczegóły zasad jako pary właściwości-wartość.

Aby uruchomić to oświadczenie, musisz mieć READ METADATA uprawnienia lub MANAGE do celu zabezpieczone lub je posiadać. READ METADATA zapewnia wgląd w politykę tylko do odczytu; MANAGE lub nadal wymagane jest posiadanie do tworzenia, edytowania lub usuwania polityk. Aby opisać politykę ON METASTORE (Beta), musisz mieć READ METADATA na metastore lub być administratorem metastore.

Składnia

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

Parametry

Wynik

Instrukcja zwraca sformatowany raport. Zakres pól zależy od rodzaju polisy. Pola, które nie są ustalone w polityce, są pomijane. Managed Tags wymienia odnośniki do tagów regulowanych używane przez politykę jako wpisy oddzielone przecinkami: key dla odniesienia tylko do klucza oraz key:value gdy polityka odnosi się do konkretnej wartości tagu.

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

Poniższy przykład opisuje politykę ABAC GRANT , która raportuje typ zabezpieczenia celu oraz przyznane uprawnienia:

> 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