コンテンツにスキップ
Queria Docs
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

データを取り下げる

間違って公開した個人情報などを、データセットのすべてのバージョンとフォークから消す手順

取り下げは、間違って公開した個人情報など、公開してはいけないデータを持つバージョンから、データファイル・アセット・メタデータをすぐに消す操作です。消したデータは元に戻せません。取り下げたバージョンの記録(番号と親のバージョン)は履歴に残ります。

手順

  1. そのデータを除いたバージョンを作成し、取り下げるバージョンを指しているブランチすべてに push します。fdl-cli 0.33 以降は、新しいバージョンのメタデータが最後のスナップショットだけを持つので、そのデータには到達しません
  2. 取り下げるバージョンの ID を uvx --from fdl-cli fdl log <REPO> で確認します
  3. 取り下げの 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 日のあいだ読めることがあります

このページは役に立ちましたか?