Konfiguruj miękkie usuwanie na poziomie plików w OneLake

Soft-delete na poziomie plików OneLake chroni Twoje dane, zachowując usunięte pliki przed trwałym usunięciem. Domyślnie dla każdej przestrzeni roboczej jest włączone soft delete z siedmiodniowym okresem przechowywania. Możesz włączyć lub wyłączyć soft delete i ustawić okres przechowywania od 1 do 365 dni.

Płacisz za tymczasowo usunięte dane po tej samej stawce co dane aktywne. Konfiguruj okres retencji tak, aby zrównoważyć potrzeby odzyskiwania i koszty przechowywania.

Wymagania wstępne

  • Rola administratora przestrzeni roboczej.

Konfiguruj soft delete w portalu Fabric

Konfiguruj miękkie usuwanie na poziomie plików dla przestrzeni roboczej w ustawieniach OneLake.

  1. Otwórz przestrzeń roboczą w portalu Fabric.

  2. Wybierz ustawienia >WorkspaceOneLake>General.

  3. Użyj przełącznika Włącz miękkie usuwanie na poziomie plików , aby włączyć lub wyłączyć retencję.

    Zrzut ekranu portalu Fabric, który pokazuje możliwość włączenia miękkiego usuwania na poziomie plików w ustawieniach Workspace.

  4. Jeśli retencja jest włączona, ustaw okres retencji na wartość od 1 do 365 dni.

Po włączeniu funkcji retencji domyślny okres retencji wynosi siedem dni. To ustawienie dotyczy plików w całym obszarze roboczym, ale nie wpływa na retencję obszaru roboczego ani elementów.

Konfiguruj miękkie usuwanie za pomocą REST API

Użyj Fabric REST API, aby zobaczyć lub zaktualizować retencję soft-delete na poziomie plików dla przestrzeni roboczej.

Aby zobaczyć aktualne ustawienie, wyślij następujące żądanie:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings

Gdy retencja jest włączona, odpowiedź zawiera status i okres retencji:

{
    "enabled": true,
    "retentionDays": 30
}

Aby zaktualizować ustawienie, wyślij żądanie POST do następującego punktu końcowego. Aby włączyć retencję i ustawić okres retencji, użyj następującej treści żądania:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings/modifyFileSoftDelete
{
    "enabled": true,
    "retentionDays": 30
}

Aby wyłączyć retencję, użyj następującej treści żądania:

{
    "enabled": false
}

Aktualizacja udaje się tylko wtedy, gdy OneLake aktualizuje wszystkie odpowiednie konta pamięci masowej. Jeśli nie można zaktualizować choćby jednego konta, żądanie kończy się niepowodzeniem, a konta pozostają zsynchronizowane.

Zrozum zachowanie retencji i zakres

Zmiana okresu przechowywania dotyczy tylko plików usuniętych po zmianie. Pliki, które zostały już miękko usunięte, zachowują okres przechowywania, który był aktywny w momencie ich usunięcia. Na przykład, jeśli zmienisz okres przechowywania z 28 dni na siedem dni, pliki usunięte przed zmianą pozostają możliwe do odzyskania przez 28 dni. Pliki usunięte po zmianie można odzyskać przez siedem dni.

Ustawienie to dotyczy danych w całkowicie rozliczonych kontach pamięci masowej w przestrzeni roboczej, w tym domyślnego konta pamięci oraz konta logów diagnostycznych. Nie dotyczy danych w kontach pamięci masowej nierozliczanej lub częściowo rozliczonej. Dane w tych relacjach są lustrzane z innej bazy danych i nie są źródłem prawdy.

Usuwanie przestrzeni roboczej i elementów zachowuje się inaczej niż usuwanie plików:

  • Gdy przestrzeń robocza zostaje trwale usunięta, jej dane są natychmiast usuwane. Miękkie usuwanie na poziomie plików nie ma zastosowania.
  • Gdy element zostanie trwale usunięty, jego dane pozostają możliwe do odzyskania w OneLake przez skonfigurowany okres przechowywania miękkiego usuwania na poziomie plików.