Recuperar ou eliminar permanentemente elementos (pré-visualização)

O Fabric suporta eliminação e recuperação suave de itens individuais dentro dos espaços de trabalho. Quando elimina um item suportado, este entra num período de retenção durante o qual colaboradores, membros e administradores do espaço de trabalho podem recuperá-lo. Esta proteção ajuda a prevenir a perda acidental de dados ao dar-lhe a oportunidade de restaurar itens antes de serem removidos permanentemente.

Neste artigo, aprende como configurar a retenção de itens, recuperar itens apagados e eliminar permanentemente itens antes do término do período de retenção.

Para uma visão geral de como funciona a retenção para espaços de trabalho e itens, consulte Retention and Recovery in Fabric.

Importante

A eliminação e recuperação suave ao nível do item está atualmente em PRÉ-VISUALIZAÇÃO. Estas informações referem-se a um produto de pré-lançamento que pode ser substancialmente modificado antes de ser lançado. A Microsoft não oferece garantias, expressas ou implícitas, relativamente à informação aqui fornecida.

Pré-requisitos

  • Para configurar as definições de retenção de itens, precisas de um papel de administrador de inquilino .
  • Para recuperar itens apagados, precisa de pelo menos permissões do Contribuidor do Espaço de Trabalho . Consulte Permissões para a matriz completa de permissões.
  • Para eliminar permanentemente itens recuperáveis, precisas de permissões de Administrador do Espaço de Trabalho .

Configure o período de retenção para itens eliminados

Por padrão, quando ativas a recuperação de itens nas definições do locatário, o Fabric mantém itens apagados durante sete dias. Pode alterar o período de retenção (de 7 para 90 dias) usando a definição de tenant de Recuperação de Items .

  1. No portal de administração, vai a Definições do Inquilino>Recuperação de Itens.
  2. Ativa a definição e insere o número de dias para o período de retenção (7 a 90 dias).
  3. Selecione Aplicar.

Observação

Quando a definição Item Recovery está desativada, Fabric não retém os itens eliminados quando apagas um item individual.

A definição de Recuperação de Itens não afeta o período de retenção dos espaços de trabalho. Consulte Retention and Recovery in Fabric para detalhes sobre a retenção do espaço de trabalho.

Restaurar um item apagado

Enquanto um item eliminado estiver num período de retenção, os colaboradores do espaço de trabalho, membros e administradores podem restaurá-lo e as suas propriedades.

Use o contentor de reciclagem do espaço de trabalho para restaurar um item

O contentor de reciclagem do espaço de trabalho é uma visualização dedicada dentro de cada espaço de trabalho onde pode navegar, restaurar ou eliminar permanentemente itens apagados de forma temporária.

  1. Abre o espaço de trabalho que continha o item eliminado.
  2. Selecione Lixeira no menu do espaço de trabalho.
  3. Encontra o item que queres recuperar. Pode usar o filtro e as opções de pesquisa para localizar itens específicos.
  4. Selecione o item e depois escolha Restaurar na barra de ferramentas.

O item restaurado reaparece no seu espaço de trabalho original com as suas propriedades, configurações e relações intactas.

Use a API REST para restaurar um item

Use a API REST para recuperar programaticamente os itens eliminados.

Pedido:

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

Parâmetros:

  • workspaceId - O identificador único do espaço de trabalho que contém o item eliminado.
  • itemId - O identificador único do item a recuperar.

Exemplo:

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

Resposta:

  • 200 OK - Item recuperado com sucesso.
  • 404 Não Encontrado - Item não encontrado ou já não está em período de recuperação.
  • 403 Proibido - O utilizador não tem permissão para recuperar o item.

Observação

Os itens recuperados mantêm as suas propriedades, definições e permissões originais. Se o item depender de outros itens apagados, talvez precises de restaurar essas dependências primeiro.

Importante

Se um novo item com o mesmo nome do item que foi apagado suavemente existir no mesmo espaço de trabalho, a recuperação falha até renomear o item existente. Para recuperar o item eliminado, renomeie o novo item e depois tente novamente a operação de recuperação.

Eliminar permanentemente um item recuperável

Enquanto um item eliminado estiver no seu período de retenção, pode eliminá-lo permanentemente se tiver permissões de administrador do espaço de trabalho.

Use o contentor de reciclagem do Workspace para eliminar permanentemente um item

  1. Abre o espaço de trabalho que continha o item eliminado.
  2. Selecione Lixeira no menu do espaço de trabalho.
  3. Encontra o item que queres eliminar permanentemente.
  4. Seleciona o item e depois escolhe Eliminar permanentemente na barra de ferramentas.

É-lhe pedido que confirme a eliminação permanente.

Atenção

Depois de confirmar a eliminação permanente, o item e o seu conteúdo deixam de ser recuperáveis.

Depois de eliminar permanentemente um item, a Microsoft OneLake mantém os dados por mais sete dias. Não podes restaurar dados durante este período. A eliminação é definitiva e não pode ser revertida.

Use a API REST para eliminar permanentemente um item

Use a API REST para apagar programaticamente os itens durante o período de retenção.

Pedido:

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

Parâmetros:

  • workspaceId - O identificador único do espaço de trabalho que contém o item eliminado.
  • itemId - O identificador único do item a eliminar permanentemente.

Exemplo:

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

Atenção

Depois de confirmar a eliminação permanente, o item e o seu conteúdo deixam de ser recuperáveis.

Depois de eliminar permanentemente um item, a Microsoft OneLake mantém os dados por mais sete dias. Não podes restaurar dados durante este período. A eliminação é definitiva e não pode ser revertida.