OpenAICloudflare Developer PlatformJul 7, 2026, 12:00 AM

R2 - R2 Data Catalog warns before you delete data manually

A condensed section focused on the key takeaways first.

Original Post

Quick Digest

Summary

A condensed section focused on the key takeaways first.

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

R2 Data Catalog warns before you delete data manually

Key Points

  • Dashboard warns on manual deletes
  • Wrangler checks bucket before delete
  • Manual deletes can corrupt Iceberg metadata

Summary

R2 Data Catalog (a managed Apache Iceberg catalog built into R2 buckets) now warns users when they attempt manual object deletes on Data Catalog-enabled buckets. Manual adds, modifications, or deletes outside the catalog can leave Iceberg metadata pointing to missing files and corrupt tables. To reduce risk, the Cloudflare dashboard and Wrangler now display warnings before a manual delete and allow you to cancel.

Key Points

  • Reason: Iceberg tracks data through metadata files; all inserts/updates/deletes must go through catalog transactions to keep tables consistent.
  • Dashboard: shows a prominent warning for delete attempts on Data Catalog-enabled buckets and links to the deletion documentation; you can cancel or proceed.
  • Wrangler: checks bucket Data Catalog status before running delete commands and prompts a warning asking you to confirm.
  • Recommended actions: do not manually delete objects in catalog-enabled buckets; use catalog-aware deletion workflows per the R2 Data Catalog documentation and verify bucket status before destructive operations.

Full Translation

Translations

A translation section that keeps the flow of the original article.

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 を参照してください。