UNDROP VOLUME

Gilt für:Haken markiert ja Databricks SQL Haken markiert ja Databricks Runtime 19.11 und höher Haken ja Nur Unity Catalog

Der UNDROP VOLUME Befehl stellt ein abgeworfenes Volume im Unity-Katalog über dessen Volume-ID wieder. Nutze es, um ein versehentlich verlorenes Volumen wiederherzustellen. Du kannst ein verlorenes Volumen für 7 Tage nach dem Verlust wiederherstellen.

Das Wiederherstellen eines Volumes ist eine Metadatenoperation, sodass sowohl verwaltete als auch externe Volumes wieder abgeworfen werden können. Das Elternschema und der Katalog müssen weiterhin existieren.

Um die ID eines verlorenen Volumens zu finden, verwenden SHOW VOLUMES Sie DROPPED.

Wenn ein Live-Volume im gleichen Schema bereits den Namen des Volumes verwendet, das du wiederherstellen möchtest, benennen oder droppen Sie dieses Volume zuerst mit ALTER VOLUME oder DROP VOLUME, dann führen UNDROP VOLUMESie .

Volume-Metadaten, wie die auf dem Volume und den Tags gewährten Privilegien, werden wiederhergestellt. Bei einem verwalteten Volume werden auch die im Volume gespeicherten Dateien wiederhergestellt.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

Es gibt kein Formular, das einen Band namentlich wiedergibt. Du musst das Volumen anhand seiner ID identifizieren.

Permissions

UNDROP VOLUME erfordert eines der folgenden:

  • Du besitzt oder hast MANAGE auf dem Band, und du hast CREATE VOLUME und USE SCHEMA auf dem Schema und USE CATALOG im Katalog.
  • Du besitzt oder hast MANAGE das Schema und du hast USE CATALOG es im Katalog.
  • Du besitzt oder hast MANAGE den Katalog.
  • Du besitzt den Metastore.

Außerdem musst du die Rechte haben, die nötig sind, um das von dir wiederherstellte Volume zu erstellen. Zum Beispiel musst du ein externes Volumen an der externen Stelle wiederherstellen CREATE EXTERNAL VOLUME .

Nachdem der Befehl ausgeführt ist, wird der Eigentümer standardmäßig auf den vorherigen Volume-Besitzer zurückgewechselt.

Limitations

Man kann ein Volumen erst innerhalb von 7 Tagen nach dem Erscheinen entlüften. Nach Ablauf der Erholungsphase wird das Volumen dauerhaft gereinigt und kann nicht mehr wiederhergestellt werden.

Beispiele

-- Use SHOW VOLUMES DROPPED to find the ID of the dropped volume.
> SHOW VOLUMES DROPPED IN my_catalog.my_schema;
  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

-- Undrop the volume by its ID.
-- Enclose the volume ID in single quotation marks.
> UNDROP VOLUME WITH ID '6ca7be55-8f58-47a7-85ee-7a59082fd17a';
  OK