アイテムを回復または完全に削除する

Fabricでは、ワークスペース内の個々の項目の論理的な削除と回復がサポートされます。サポートされているアイテムを削除すると、ワークスペースの共同作成者、メンバー、管理者が回復できる保持期間が入力されます。この保護は、アイテムが完全に削除される前にアイテムを復元する機会を与えることで、偶発的なデータ損失を防ぐのに役立ちます。

この記事では、アイテムの保持期間を設定する方法、削除済みアイテムを回復する方法、保持期間が切れる前にアイテムを完全に削除する方法について説明します。

ワークスペースとアイテムのリテンションのしくみについては、Fabric におけるリテンションと回復をご覧ください。

前提条件

アイテム保持設定を設定するには、テナント管理者ロールが必要です。
削除されたアイテムを回復するには、少なくとも ワークスペース共同作成者 のアクセス許可が必要です。完全なアクセス許可マトリックスについては、「アクセス許可」を参照してください。
回復可能なアイテムを完全に削除するには、 ワークスペース管理者 のアクセス許可が必要です。

削除済みアイテムの保持期間を設定する

注

アイテム回収はデフォルトで有効化されており、保持期間は3日間です。デフォルトは、 アイテムリカバ リー設定を明示的に設定していないテナントと新たに作成されたテナントに適用されます。 Fabricは管理者が明示的に設定した設定を保持します。アイテム回収をオンにしていれば現在の保持値は変わらず、明示的にオフにしてもオフのままです。

保持期間を3日から90日に変更したり、アイテム回収をオフにするには、 Item Recovery テナント設定を使って可能です。

管理ポータルで、 テナント設定>Item Recovery に移動します。
設定が有効になっているか確認し、保持期間の日数(3日から90日)を入力してください。
を選択してを適用します。

注

Item Recovery の設定がオフの場合、個々のアイテムを削除しても、Fabricは削除済みアイテムを保持しません。

[アイテムの回復] 設定は、ワークスペースの保持期間には影響しません。ワークスペースのリテンション期間の詳細については、Fabric でのリテンションと回復に関するページを参照してください。

削除済みアイテムを復元する

削除されたアイテムが保持期間内にある間、ワークスペースの共同作成者、メンバー、管理者は、アイテムとそのプロパティを復元できます。

ワークスペースのごみ箱を使用してアイテムを復元する

ワークスペースのごみ箱は、各ワークスペース内の専用ビューであり、論理削除されたアイテムを参照、復元、または完全に削除することができます。

削除済みアイテムを含むワークスペースを開きます。
ワークスペースナビゲーションから ごみ箱 を選択します。
回復する項目を見つけます。フィルターと検索のオプションを使用して、特定のアイテムを見つけることができます。
項目を選択し、ツールバーから [復元 ] を選択します。

復元された項目は、プロパティ、構成、およびリレーションシップをそのまま使用して、元のワークスペースに再び表示されます。

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 OK - 項目が正常に回復しました。
404 見つかりません - 項目が見つからないか、復旧期間が終了しました。
403 禁止 - ユーザーはアイテムを回復するアクセス許可を持っていません。

注

回復されたアイテムは、元のプロパティ、設定、およびアクセス許可を保持します。アイテムが他の削除済みアイテムに依存している場合は、最初にそれらの依存関係を復元することが必要になる場合があります。

Important

論理的に削除されたアイテムと同じ名前の新しい項目が同じワークスペースに存在する場合、既存のアイテムの名前を変更するまで回復は失敗します。削除済みアイテムを回復するには、新しい項目の名前を変更してから、回復操作を再試行します。

回復可能な項目を完全に削除する

削除されたアイテムが保持期間にある間は、ワークスペース管理者の権限があれば、完全に削除することができます。

ワークスペースのごみ箱を使用してアイテムを完全に削除する

削除済みアイテムを含むワークスペースを開きます。
ワークスペースナビゲーションから ごみ箱 を選択します。
完全に削除するアイテムを見つけます。
項目を選択し、ツールバーから [完全に削除 ] を選択します。

完全な削除を確認するように求められます。

注意事項

完全な削除を確認した後、アイテムとその内容は回復できなくなります。

アイテムを完全に削除すると、OneLake はデータをさらに 7 日間保持します。この期間中はデータを復元できません。削除は最終的なものであり、元に戻すことはできません。

REST API を使用して項目を完全に削除する

REST API を使用して、保持期間中にプログラムによってアイテムを削除します。