SHOW VOLUMES 已放棄

適用於:勾選標記為是 Databricks SQL 勾 選為是 Databricks 執行時間 19.11 及以上版本 勾選是 僅限 Unity 目錄

SHOW VOLUMES DROPPED 在 Unity 目錄架構中列出仍可恢復的遺失卷。

若未指定結構,則會從目前架構列出磁碟區。 若結構或目錄不存在,則會產生錯誤。

Syntax

SHOW VOLUMES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]

Parameters

  • schema_name

    指定列出遺失卷的結構。 如果未提供,請使用目前的架構。

  • maxResults

    一個整數字面值,限制回傳的卷數數量。

Permissions

指令只列出請求者能用 UNDROP VOLUME 恢復的卷。 使用者必須擁有一個元儲存庫、目錄或架構(或擁有 MANAGE 架構權限),才能列出該可保護資料中所有被丟棄的資料表。 擁有已移除卷的使用者,若擁有 USE CATALOG 父目錄和 USE SCHEMA 父結構的權限,就可以列出該卷。

Returns

指令會產生以下欄位的遺失卷報告:

Name 資料類型 可空值 Description
目錄 STRING 否 被刪除的書籍目錄名稱。
結構描述 STRING 否 掉落磁碟的結構名稱。
volume_name STRING 否 那本被刪除的書名。
volume_id STRING 否 用來識別並解開特定丟棄磁碟的 UNDROP VOLUME WITH ID磁碟區 ID。
擁有者 STRING 否 擁有這卷的校長。
留言 STRING yes 關於可選的音量評論。
建立於 STRING 否 就是那個卷被創造的時間。
創建者 STRING 否 創作這卷的校長。

Examples

-- Create and drop a volume, then list the dropped volumes in the current schema.
> USE CATALOG my_catalog;
> USE SCHEMA my_schema;
> CREATE VOLUME my_volume;
> DROP VOLUME my_volume;
> SHOW VOLUMES DROPPED;
  catalog    schema    volume_name volume_id                            owner         comment created_at                    created_by
  ---------- --------- ----------- ------------------------------------ ------------- ------- ----------------------------- -------------
  my_catalog my_schema my_volume   6ca7be55-8f58-47a7-85ee-7a59082fd17a alf@melmak.et         2023-05-03 AD at 18:17:00 UTC alf@melmak.et

-- List dropped volumes from a different schema, limiting the results.
> CREATE VOLUME my_catalog.other_schema.other_volume;
> DROP VOLUME my_catalog.other_schema.other_volume;
> SHOW VOLUMES DROPPED IN my_catalog.other_schema LIMIT 10;
  catalog    schema       volume_name  volume_id                            owner         comment created_at                    created_by
  ---------- ------------ ------------ ------------------------------------ ------------- ------- ----------------------------- -------------
  my_catalog other_schema other_volume b819f397-c51f-4e60-8acc-05d4d4a7e084 alf@melmak.et         2023-05-04 AD at 08:20:00 UTC alf@melmak.et