節目政策

適用於：標記為 是 Databricks SQL 標記為 是 Databricks Runtime 16.4 和更高版本 標記為 是 Unity Catalog 仅适用

列出與可保資產相關的保單。 支援兩種形式：

  1. 顯示保單：僅列出與目標可擔保債券直接相關的保單。
  2. 顯示有效政策：列出與目標可保障資產及資源階層中從父繼承的政策直接相關的政策。

要執行此語句，您必須擁有READ METADATAMANAGE該目標的或權限，或擁有該目標。 READ METADATA 賦予政策的唯讀可見性; MANAGE 或仍需擁有權才能建立、編輯或刪除政策。 要列出政策 ON METASTORE （Beta），你必須在 Metastore 上有 READ METADATA 相關資訊，或是 metastore 管理員。

兩種表格都需核對相同的權限。 母可保資產則無需額外權限。 例如，在資料表上顯示有效政策，不需要在結構或目錄中顯示政策的權限。

語法

SHOW [ EFFECTIVE ] POLICIES ON { METASTORE | CATALOG catalog_name | SCHEMA schema_name | TABLE table_name }

參數

  • 有效

    選擇性。 指定時，會列出直接與目標可保障資產相關的政策，以及資源階層中從父繼承的政策。 省略時，僅列出與目標可擔保直接相關的保單。

  • catalog_name

    目錄名稱 本目錄中定義的政策已列出。

  • schema_name

    架構的名稱。 此架構中定義的政策已列出。

  • table_name

    數據表的名稱。 此表中定義的政策已列出。

Result

該語句會回傳一個結果表。

節目政策

  • Policy Name 字串非空：政策名稱。
  • Policy Type 字串非空：政策類型（例如 ROW_FILTER、 、 COLUMN_MASK或 GRANT）。
  • Catalog STRING NOT NULL：該政策所定義的可安全檔目錄。
  • Schema STRING：可保障的結構，當目標為目錄時稱為 NULL。
  • Table STRING：當政策在資料表上定義時，表示資料表名稱，否則為 NULL。
  • Comment STRING：如果有，請對這項政策發表評論。
  • on_securable_type STRING：保單所附帶的擔保證券類型。
  • on_securable_fullname STRING：保單所附帶的可保證券的完整限定名稱。

展示有效的政策

  • Policy Name 字串非空：政策名稱。
  • Policy Type 字串非空：政策類型（例如 ROW_FILTER、 、 COLUMN_MASK或 GRANT）。
  • Catalog STRING NOT NULL：定義政策（直接或繼承）的目錄。
  • Schema STRING：定義政策的結構，或在目錄中定義時為 NULL。
  • Table STRING：定義政策的表格，或在目錄或結構中定義時為 NULL。
  • Comment STRING：如果有，請對這項政策發表評論。
  • on_securable_type STRING：保單所附帶的擔保證券類型。
  • on_securable_fullname STRING：保單所附帶的可保證券的完整限定名稱。

表格中包含直接針對目標可保障的政策，以及對於 SHOW EFFECTIVE POLICIES，則是從資源階層中父層繼承的政策。 欲查看政策的完整細節，請使用 「描述政策」。

Examples

> SHOW POLICIES ON SCHEMA mycatalog.myschema;
> SHOW EFFECTIVE POLICIES ON SCHEMA mycatalog.myschema;
  • 上次更新時間：