ポリシーの説明

適用対象:はい Databricks SQL はい Databricks Runtime 16.4以降 はい Unity Catalogのみ

ポリシーの詳細をプロパティと値のペアとして表示します。

このステートメントを実行するには、対象物の READ METADATA または MANAGE 特権を持っているか、所有している必要があります。 READ METADATA ポリシーに対して読み取り専用の可視性を付与します。ポリシーの作成、編集、削除には引き続き MANAGE または所有権が必要です。 ポリシー ON METASTORE (ベータ版)を説明するには、メタストアに上 READ METADATA か、メタストア管理者である必要があります。

構文

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

パラメーター

  • policy_name

    記述するポリシーの名前。 セキュリティ保護可能なポリシーが存在しない場合、Azure Databricks によって POLICY_NOT_FOUNDが発生します。

  • catalog_name

    ポリシーが定義されているカタログの名前。

  • schema_name

    ポリシーが定義されているスキーマの名前。

  • table_name

    ポリシーが定義されているテーブルの名前。

結果

このステートメントは、書式設定されたレポートを返します。 含まれるフィールドはポリシーの種類によって異なります。 ポリシーに設定されていないフィールドは省略されます。 ガバナンドタグはポリシーで使用されるガバネートタグ参照をカンマ区切られたエントリとしてリストします。キーのみ参照は key 、特定のタグ値を参照する場合はポリシー key:value 。

例示

> 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

以下の例は、対象のセキュアブルタイプと付与された権限を報告するABACの GRANT ポリシーを示しています。

> 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