Products · Developer platform
Basin Catalog
Create, manage, and query Iceberg tables stored in R2
Pricing and limits
Pricing
As of Nov 3, 2026, from Cloudflare's docs, last updated there Oct 1, 2026. Licensed CC BY 4.0; navigation removed.
Note
Basin Catalog requires an active R2 subscription. Your account must also have a linked payment card.
Basin Catalog charges based on two dimensions in addition to standard R2 storage and operations:
- Catalog operations: Metadata operations such as creating tables, reading table metadata, and updating table properties.
- Compaction data processed: The volume of data processed and objects compacted when automatic table compaction is turned on.
All included usage is on a monthly basis.
Basin Catalog pricing
| Pricing | |
|---|---|
| Catalog operations | |
| Included | 1 million operations / month |
| Additional | $9.00 / million operations |
| Data processed (Compaction) 1 | |
| Included | 10 GB / month |
| Additional (data processed) | $0.005 / GB processed |
| Objects processed (Compaction) 1 | |
| Included | 1 million objects / month |
| Additional | $2.00 / million objects |
Catalog operations
Catalog operations are metadata requests made to the Iceberg REST catalog, such as creating a table, retrieving table metadata, updating table properties, and listing tables in a namespace. These operations do not scan or move data.
Compaction
When you turn on automatic compaction, Basin Catalog periodically rewrites small data files into larger, optimized files. This improves query performance and reduces the number of files in your table. Compaction is billed on two sub-dimensions:
- Data processed: The total bytes read and rewritten during compaction.
- Objects processed: The number of data files compacted.
Compaction charges only apply when compaction is turned on for a table. If you have not turned on compaction, you will not incur any compaction charges.
Note
Current compaction pricing is based on binpacking, the simplest form of compaction. More compute-intensive compaction algorithms (such as sort or z-order) may be priced differently in the future.
Snapshot Expiration
When you turn on automatic snapshot expiration, Basin Catalog automatically deletes old snapshots and their associated data files after a specified retention period. Snapshot expiration is free of charge and does not incur any additional costs outside of the standard R2 storage and data catalog operations charges.
Billing examples
Example 1: Low-volume analytics table
A user maintains a single Iceberg table with 50 GB of data. They make 500,000 catalog operations per month and have compaction turned on, which processes 20 GB across 200,000 files.
| Dimension | Usage | Included | Billable | Cost |
|---|---|---|---|---|
| Catalog operations | 500,000 | 1,000,000 | 0 | $0.00 |
| Compaction (data processed) | 20 GB | 10 GB | 10 GB | $0.05 |
| Compaction (objects) | 200,000 | 1,000,000 | 0 | $0.00 |
| Total (Data Catalog) | $0.05 |
Standard R2 storage charges ($0.015 / GB-month) apply separately for the 50 GB of data stored.
Example 2: Streaming ingest at 20 MB/s
A user streams data into an Iceberg table at 20 MB/s using Basin Pipelines. Over a month (~30 days) this produces approximately 50,625 GB (~49 TB) of data, 347,000 catalog operations, and compaction processes roughly 50,625 GB across 43,200 files.
| Dimension | Usage | Included | Billable | Cost |
|---|---|---|---|---|
| R2 storage | 50,625 GB-month | 10 GB-month | 50,615 GB-month | $759.23 |
| Catalog operations | 347,000 | 1,000,000 | 0 | $0.00 |
| Compaction (data processed) | 50,625 GB | 10 GB | 50,615 GB | $253.08 |
| Compaction (objects) | 43,200 | 1,000,000 | 0 | $0.00 |
| Total | $1,012.31 |
For large-scale use cases, storage costs are typically the largest component of the bill.
Cloudflare billing policy
To learn more about how usage is billed, refer to Cloudflare Billing Policy.
Footnotes
Timeline
October 2026
- Cloudflare Basin is now generally available
Basin, formerly the Cloudflare Data Platform, is now generally available. Basin brings an end-to-end analytics platform to the Developer Platform, enabling you to collect data from a variety of sources, such as apps, infrastructure, devices, and other Cloudflare services, then query it to answer analytical questions. Basin Pipelines Basin Pipelines, formerly Cloudflare Pipelines, ingests events f…
September 2026
- R2 Data Catalog adds table maintenance visibility and manual queueing
R2 Data Catalog now provides table-level maintenance visibility and manual compaction queueing in the Cloudflare dashboard. These updates make it easier to understand when maintenance is eligible to run, inspect completed operations, and request maintenance without leaving the table view. To view table maintenance details: In the Cloudflare dashboard, go to R2 Data Catalog. Select a catalog, then…
August 2026
- Billing is now enabled for R2 Data Catalog
Billing is now enabled for R2 Data Catalog on non-enterprise accounts. R2 Data Catalog usage beyond the included free tier will appear on your next invoice. R2 Data Catalog charges based on two dimensions, in addition to standard R2 storage and operations: Catalog operations: $9.00 / million operations for metadata requests such as creating tables, reading table metadata, and updating table prope…
July 2026
- R2 Data Catalog now supports read-only API tokens
R2 Data Catalog now accepts read-only API tokens, so query engines and clients that only read data no longer need a read-write token. Previously, every catalog operation required an Admin Read & Write token, which granted read-only clients more access than they needed. You can now authenticate your Iceberg engine based on your workload: Read-only operations (such as listing namespaces, loading ta…
- R2 Data Catalog compaction now optimizes manifest files
R2 Data Catalog, a managed Apache Iceberg ↗︎ catalog built into R2, now automatically optimizes manifest files as part of compaction. Manifest files track the data files that make up an Iceberg table. As a table accumulates many small or fragmented manifests, query engines must read more metadata during query planning, which slows down queries even before any data is scanned. When compaction runs…
- R2 Data Catalog warns before you delete data manually
R2 Data Catalog is a managed Apache Iceberg ↗︎ catalog built directly into your R2 bucket. Iceberg tracks your data through a tree of metadata files, so every insert, update, and delete must go through a catalog transaction. Manually adding, modifying, or deleting objects outside the catalog can leave pointers referencing files that no longer exist, corrupting the table into an inconsistent state…
May 2026
- R2 Data Catalog pricing announced
R2 Data Catalog is a managed Apache Iceberg ↗︎ data catalog built directly into R2 buckets, queryable by any Iceberg-compatible engine such as Spark, Snowflake, and DuckDB. R2 Data Catalog now has published pricing for catalog operations and table compaction, in addition to standard R2 storage and operations. Billing is not yet enabled. We will provide at least 30 days notice before we start char…
- R2 Data Catalog gets a dedicated dashboard experience
R2 Data Catalog is a managed Apache Iceberg ↗︎ data catalog built directly into your R2 bucket. It exposes a standard Iceberg REST catalog interface so you can connect query engines like Spark, Snowflake, DuckDB, and R2 SQL to your data in R2. R2 Data Catalog now has a dedicated section in the Cloudflare dashboard, replacing the previous settings panel embedded in R2 bucket configuration. The new…
- R2 Data Catalog now exposes metrics via the GraphQL Analytics API
R2 Data Catalog is a managed Apache Iceberg data catalog built directly into your R2 bucket that allows you to connect query engines like R2 SQL, Spark, Snowflake, and DuckDB to your data in R2. You can now query analytics for your R2 Data Catalog warehouses via Cloudflare's GraphQL Analytics API. Two new datasets are available: r2CatalogDataOperationsAdaptiveGroups tracks Iceberg REST API reques…
April 2026
- R2 Data Catalog snapshot expiration now removes unreferenced data files
R2 Data Catalog, a managed Apache Iceberg ↗︎ catalog built into R2, now removes unreferenced data files during automatic snapshot expiration. This improvement reduces storage costs and eliminates the need to run manual maintenance jobs to reclaim space from deleted data. Previously, snapshot expiration only cleaned up Iceberg metadata files such as manifests and manifest lists. Data files that we…
December 2025
- R2 Data Catalog now supports automatic snapshot expiration
R2 Data Catalog now supports automatic snapshot expiration for Apache Iceberg tables. In Apache Iceberg, a snapshot is metadata that represents the state of a table at a given point in time. Every mutation creates a new snapshot which enable powerful features like time travel queries and rollback capabilities but will accumulate over time. Without regular cleanup, these accumulated snapshots can…
October 2025
- R2 Data Catalog table-level compaction
You can now enable compaction for individual Apache Iceberg ↗︎ tables in R2 Data Catalog, giving you fine-grained control over different workloads. # Enable compaction for a specific table (no token required) npx wrangler r2 bucket catalog compaction enable <BUCKET> <NAMESPACE> <TABLE> --target-size 256 This allows you to: Apply different target file sizes per table Disable compaction for specifi…
September 2025
- R2 Data Catalog now supports compaction
You can now enable automatic compaction for Apache Iceberg ↗︎ tables in R2 Data Catalog to improve query performance. Compaction is the process of taking a group of small files and combining them into fewer larger files. This is an important maintenance operation as it helps ensure that query performance remains consistent by reducing the number of files that needs to be scanned. To enable automa…
April 2025
- R2 Data Catalog is a managed Apache Iceberg data catalog built directly into R2 buckets
Today, we are launching R2 Data Catalog in open beta, a managed Apache Iceberg catalog built directly into your Cloudflare R2 bucket. If you are not already familiar with it, Apache Iceberg ↗︎ is an open table format designed to handle large-scale analytics datasets stored in object storage, offering ACID transactions and schema evolution. R2 Data Catalog exposes a standard Iceberg REST catalog i…