適用於:
Databricks SQL 勾
Databricks 執行時間 19.11 及以上版本
僅限 Unity 目錄
SHOW VOLUMES DROPPED 在 Unity 目錄架構中列出仍可恢復的遺失卷。
若未指定結構,則會從目前架構列出磁碟區。 若結構或目錄不存在,則會產生錯誤。
Syntax
SHOW VOLUMES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]
Parameters
-
指定列出遺失卷的結構。 如果未提供,請使用目前的架構。
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