データを取り下げる
間違って公開した個人情報などを、データセットのすべてのバージョンとフォークから消す手順
取り下げは、間違って公開した個人情報など、公開してはいけないデータを持つバージョンから、データファイル・アセット・メタデータをすぐに消す操作です。消したデータは元に戻せません。取り下げたバージョンの記録(番号と親のバージョン)は履歴に残ります。
手順
- そのデータを除いたバージョンを作成し、取り下げるバージョンを指しているブランチすべてに push します。fdl-cli 0.33 以降は、新しいバージョンのメタデータが最後のスナップショットだけを持つので、そのデータには到達しません
- 取り下げるバージョンの ID を
uvx --from fdl-cli fdl log <REPO>で確認します - 取り下げの API を呼びます。データセットを持つアカウントの管理者が、
datasets:writeの権限を持つ API トークンで呼びます
curl -X POST https://queria.io/api/datasets/<ハンドル>/<データセット>/withdrawals \
-H "Authorization: Bearer $QUERIA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"versions": ["<バージョン ID>"]}'
ブランチがまだ取り下げるバージョンを指しているときは、409 とそのブランチの一覧が返ります。手順 1 をやり直してから呼びます。取り下げるバージョンを head に持つ変更リクエストは閉じます。
取り下げないバージョンがまだ読むファイルは消さずに残し、応答の still_read に一覧を返します。そのファイルがデータを持つときは、それを読むバージョンも指定して取り下げの API をもう一度呼びます。
取り下げた後
- 消したデータファイルとアセットは、同じ名前では push できません。手元のクローンなどの古い写しから push しても、取り下げたデータは戻りません
- フォークでも同じデータを取り下げます。フォークで追加したバージョンのうち、取り下げたデータを読むものも取り下げます。そのバージョンを指していたフォークのブランチは、フォーク元の main の最新バージョンへ移します。フォークで追加していた変更は消えるので、フォークの持ち主が作り直します
- 取り下げたデータを読むブランチからは、フォーク元への変更リクエストを作成できません
- data.queria.io は公開データセットのファイルを最大 1 日キャッシュするため、消したファイルが 1 日のあいだ読めることがあります
