OpenAICloudflare Developer Platform2026/07/07 0:00

R2 - R2 Data Catalog warns before you delete data manually

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

R2 Data Catalog:手動削除時に警告を表示

Key Points

  • ダッシュボードが削除を警告
  • wranglerが削除前に確認
  • 手動削除でIceberg破損の可能性

Summary

R2 Data Catalog(Apache Icebergベース)が有効なバケットでオブジェクトを手動で削除すると、カタログのメタデータと実データが不整合になりテーブルが破損する恐れがあります。これを防ぐため、CloudflareはR2ダッシュボードとWranglerに削除前の警告を追加しました。警告は操作を中止するか、リスクを承知の上で続行する選択肢を提供します。

Key Points

  • ダッシュボード:Data Catalog有効なバケットでの手動削除時に警告を表示し、削除方法を説明するドキュメントへのリンクを提示する。
  • Wrangler:削除実行前にバケットがData Catalog対応かチェックし、警告プロンプトを表示する(続行可、キャンセル可)。
  • 理由:Icebergはすべての変更をカタログトランザクションで追跡するため、オブジェクトを直接追加・変更・削除するとメタデータにダングリングポインタが残り復旧が困難になる。
  • 推奨対応:カタログ経由の削除(Icebergトランザクションや対応API)を使用し、手動オブジェクト操作は避ける。既存テーブルの操作手順はR2 Data Catalogドキュメントを参照する。

Practical guidance

  • 操作前にバケットがData Catalog対応か確認する(ダッシュボード/wranglerで警告が出る)。
  • テーブル単位の削除や更新はカタログAPI/SQL(Iceberg対応ツール)で行う。
  • どうしても手動で操作する場合はスナップショットやバックアップを取得し、ドキュメントの復旧手順を確認する。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

R2 - R2 Data Catalog が手動でデータを削除する前に警告します

R2 Data Catalog が手動でデータを削除する前に警告します

R2 Data Catalog は、R2 バケットに直接組み込まれたマネージドな Apache Iceberg ↗ カタログです。Iceberg はメタデータファイルのツリーでデータを追跡するため、すべての insert、update、delete はカタログのトランザクションを経由する必要があります。カタログの外側でオブジェクトを手動で追加、変更、削除すると、存在しないファイルを参照するポインタが残り、テーブルが不整合な状態になって復旧が困難になる可能性があります。

この問題を防ぐため、R2 ダッシュボードと Wrangler は、Data Catalog が有効なバケットで手動削除を行おうとすると警告を表示します。

ダッシュボード

Data Catalog が有効なバケットからオブジェクトを削除しようとすると、ダッシュボードは次の点を説明する警告を表示します。

  • 操作によりカタログが無効な状態になる可能性があること
  • 正しい削除方法を説明するドキュメントへのリンク

ユーザーは操作をキャンセルするか、それでも続行するかを選べます。

Wrangler

Wrangler は削除実行前にバケットが Data Catalog 有効かどうかをチェックし、続行前に警告を表示します。表示されるメッセージ例:

Data Catalog is enabled for this bucket. Proceeding may leave the data catalog in an invalid state. Continue?

Wrangler の警告が出た場合、削除操作を続行するかどうかを確認してください。

安全にデータを管理・削除するには

テーブル内のデータを安全に管理・削除する方法については、R2 Data Catalog documentation を参照してください。