ООНDROP VOLUME

Применимо к:отмечен галочкой да Databricks SQL отмечен галочкой «да» Databricks Runtime 19.11 и выше отмечен галочкой «да» только в Unity Catalog

UNDROP VOLUME Команда восстанавливает упущенный том в Unity Catalog по его идентификатору тома. Используйте его, чтобы восстановить случайно потерянный том. Вы можете восстановить пропавший объём в течение 7 дней после падения.

Восстановление тома — это операция метаданных, поэтому можно отменить как управляемые, так и внешние тома. Основная схема и каталог должны всё ещё существовать.

Чтобы найти ID пропавшего тома, используйте SHOW VOLUMES DROPPED.

Если живой том в той же схеме уже использует имя того тома, который вы хотите восстановить, сначала переименуйте или уберите этот том с ALTER VOLUME помощью или DROP VOLUME, затем запустите UNDROP VOLUME.

Метаданные тома, такие как привилегии, предоставленные на том и теги, восстанавливаются. Для управляемого тома также восстанавливаются файлы, хранящиеся в томе.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Литерал STRING в виде UUID, который идентифицирует опущенный громкость, отображаемый вSHOW VOLUMES DROPPED.

Нет формы, которая бы восстанавляла том по названию. Вы должны идентифицировать том по его идентификатору.

Permissions

UNDROP VOLUME Требуется одно из следующих условий:

  • Вы владеете или имеете MANAGE на томе, у CREATE VOLUME вас есть и USE SCHEMA на схеме, и USE CATALOG в каталоге.
  • Вы владеете или имеете MANAGE на ней схему, и у вас есть USE CATALOG в каталоге.
  • Вы владеете или имеете MANAGE в нём каталог.
  • Вы владеете Metastore.

Кроме того, у вас должны быть привилегии, необходимые для создания восстанавливаемого тома. Например, чтобы восстановить внешний том, он должен быть CREATE EXTERNAL VOLUME на внешнем месте.

После выполнения команды владение по умолчанию переходит к предыдущему владельцу тома.

Limitations

Вы можете снять выпуск только в течение 7 дней после его отключения. После окончания периода восстановления объем навсегда очищается и не может быть восстановлен.

Examples

-- 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