OneLakeのファイルレベルのソフト削除は、削除されたファイルを永久に削除する前に保持することでデータを保護します。 ソフト削除は各ワークスペースでデフォルトで有効にされており、7日間の保持期間があります。 ソフト削除のオン・オフを切り替え、保持期間を1日から365日まで設定できます。
論理的に削除されたデータに対しては、アクティブ データと同じ料金で支払います。 回復の必要性と保管コストのバランスを取るために保持期間を設定しましょう。
前提条件
- ワークスペース管理者の役割です。
Fabricポータルでソフト削除を設定する
OneLakeの設定からワークスペースのファイルレベルのソフト削除を設定してください。
Fabricポータルでワークスペースを開きます。
ワークスペース設定>OneLake>Generalを選択します。
ファイル レベルのソフト削除を有効 にするトグルを使って、保持のオン・オフを切り替えてください。
保持期間がオンの場合は、保持 期間 を1日から365日までの期間に設定します。
リテンションをオンにすると、リテンション期間はデフォルトで7日になります。 この設定はワークスペース内のファイル全体に適用されますが、ワークスペースやアイテムの保持には影響しません。
REST APIを使ってソフトデリットを設定する
ワークスペースのファイルレベルのソフト削除保持を表示または更新するために、Fabric REST APIをご利用ください。
現在の設定を見るには、以下のリクエストを送信してください:
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings
リテンションがオンの場合、レスポンスにはステータスとリテンション期間が含まれます:
{
"enabled": true,
"retentionDays": 30
}
設定を更新するには、次のエンドポイントに POST リクエストを送信してください。 保持をオンにして保持期間を設定するには、以下のリクエストボディを使用します:
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings/modifyFileSoftDelete
{
"enabled": true,
"retentionDays": 30
}
保持をオフにするには、以下のリクエスト本体を使用します:
{
"enabled": false
}
アップデートは、OneLakeがすべての該当するストレージアカウントを更新した場合にのみ成功します。 もしどれかのアカウントが更新できない場合、リクエストは失敗し、アカウントは同期されたままになります。
リテンションの行動と範囲を理解する
保持期間の変更は、変更後に削除されたファイルにのみ適用されます。 すでにソフト削除されたファイルは、削除時に有効だった保存期間を保持します。 例えば、保持期間を28日から7日に変更すると、変更前に削除されたファイルは28日間回復可能です。 変更後に削除されたファイルは7日間回復可能です。
この設定は、既定のストレージ アカウントおよび診断ログ用ストレージ アカウントを含む、ワークスペースの完全課金対象のストレージ アカウント内のデータに適用されます。 請求されていない、または部分的に請求されたストレージアカウントのデータには適用されません。 そのアカウントのデータは別のデータベースからミラーリングされており、真実の情報源ではありません。
ワークスペースやアイテムの削除はファイル削除とは異なる挙動を示します:
- ワークスペースが永久に削除されると、そのデータも即座に削除されます。 ファイルレベルのソフト削除は適用されません。
- アイテムが永久に削除された場合でも、そのデータは設定されたファイルレベルのソフトデリット保持期間中、OneLakeで復元可能です。