Восстановление или окончательное удаление элементов (предварительная версия)

Fabric поддерживает мягкое удаление и восстановление отдельных элементов в рабочих пространствах. При удалении поддерживаемого элемента он вводит период хранения, в течение которого участники рабочей области, члены и администраторы могут восстановить его. Эта защита помогает предотвратить случайную потерю данных, предоставив вам возможность восстановить элементы до их окончательного удаления.

В этой статье вы узнаете, как настроить хранение элементов, восстановить удаленные элементы и окончательно удалить элементы до истечения срока хранения.

Общие сведения о том, как работает удержание данных для рабочих областей и элементов, см. в разделе Политика хранения и восстановление в системе Fabric.

Это важно

Обратимое удаление и восстановление на уровне элементов в настоящее время находится в предварительной версии. Эта информация относится к предварительному продукту, который может быть существенно изменен до его выпуска. Microsoft не дает никаких гарантий, выраженных или подразумеваемых, в отношении информации, предоставленной здесь.

Необходимые условия

  • Чтобы настроить параметры хранения элементов, вам потребуется роль администратора клиента .
  • Чтобы восстановить удаленные элементы, вам потребуется по крайней мере разрешения участника рабочей области . См. статью "Разрешения" для полной матрицы разрешений.
  • Для окончательного удаления восстанавливаемых элементов требуются разрешения администратора рабочей области .

Настройка периода хранения для удаленных элементов

По умолчанию при включении восстановления элементов в параметрах клиента Fabric сохраняет удаленные элементы в течение семи дней. Срок хранения (от 7 до 90 дней) можно изменить с помощью параметра клиента Item Recovery .

  1. На портале администрирования перейдите в раздел "Параметры арендатора>" "Восстановление элементов".
  2. Включите параметр и введите количество дней для периода хранения (от 7 до 90 дней).
  3. Нажмите кнопку "Применить".

Замечание

Если параметр Item Recovery отключен, Fabric не сохраняет удаленные элементы при удалении отдельного элемента.

Настройка восстановления элементов не влияет на период хранения рабочих областей. Дополнительные сведения о хранении рабочей области см. в разделе Хранение и восстановление в Fabric.

Восстановление удаленного элемента

Хотя удаленный элемент находится в периоде хранения, участники рабочей области, члены и администраторы могут восстановить его и его свойства.

Используйте корзину для восстановления элемента в рабочей области

Корзина рабочей области — это специальное представление в каждой рабочей области, где можно просматривать, восстанавливать или окончательно удалять временно удаленные элементы.

  1. Откройте рабочую область, содержащую удаленный элемент.
  2. Выберите Корзина в панели навигации рабочей области.
  3. Найдите элемент, который требуется восстановить. Для поиска определенных элементов можно использовать параметры фильтра и поиска.
  4. Выберите элемент, а затем выберите "Восстановить " на панели инструментов.

Восстановленный элемент снова появится в исходной рабочей области со своими свойствами, конфигурациями и связями без изменений.

Восстановление элемента с помощью REST API

Используйте REST API для программного восстановления удаленных элементов.

Запрос:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}/recover

Параметры:

  • workspaceId — уникальный идентификатор рабочей области, содержащей удаленный элемент.
  • itemId — уникальный идентификатор элемента для восстановления.

Example:

curl --request POST \
  --url https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2/recover \
  --header 'Authorization: Bearer {token}'

Ответ.

  • 200 ОК — элемент успешно восстановлен.
  • 404 Not Found — элемент не найден или больше не найден в период восстановления.
  • 403 Запрещено . У пользователя нет разрешения на восстановление элемента.

Замечание

Восстановленные элементы сохраняют свои исходные свойства, параметры и разрешения. Если элемент зависит от других удаленных элементов, сначала может потребоваться восстановить эти зависимости.

Это важно

Если в рабочей области существует новый элемент с тем же именем, что и мягко удаленный элемент, восстановление не удается, пока существующий элемент не будет переименован. Чтобы восстановить удаленный элемент, переименуйте новый элемент, а затем повторите операцию восстановления.

Окончательное удаление восстанавливаемого элемента

Хотя удаленный элемент находится в сроке хранения, его можно окончательно удалить, если у вас есть разрешения администратора рабочей области.

Использование корзины рабочей области для окончательного удаления элемента

  1. Откройте рабочую область, содержащую удаленный элемент.
  2. Выберите Корзина в панели навигации рабочей области.
  3. Найдите элемент, который нужно удалить окончательно.
  4. Выберите элемент, а затем нажмите кнопку "Удалить окончательно " на панели инструментов.

Вам будет предложено подтвердить постоянное удаление.

Предостережение

После подтверждения постоянного удаления элемент и его содержимое больше не восстанавливаются.

После окончательного удаления элемента Microsoft OneLake сохраняет данные еще семь дней. Вы не можете восстановить данные в течение этого периода. Удаление является окончательным и не может быть отменено.

Использование REST API для окончательного удаления элемента

Используйте REST API для программного удаления элементов за период хранения.

Запрос:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/recoverableItems/{itemId}

Параметры:

  • workspaceId — уникальный идентификатор рабочей области, содержащей удаленный элемент.
  • itemId — уникальный идентификатор элемента для окончательного удаления.

Example:

curl --request DELETE \
  --url https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/recoverableItems/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2 \
  --header 'Authorization: Bearer {token}'

Предостережение

После подтверждения постоянного удаления элемент и его содержимое больше не восстанавливаются.

После окончательного удаления элемента Microsoft OneLake сохраняет данные еще семь дней. Вы не можете восстановить данные в течение этого периода. Удаление является окончательным и не может быть отменено.