---
name: basin
description: Build and troubleshoot Cloudflare Basin analytics workflows with Basin Pipelines, Basin Catalog, and Basin SQL. Use for streaming data into R2 Iceberg tables, managing catalogs, or querying those tables; also use for requests using the former Data Platform, Pipelines, R2 Data Catalog, or R2 SQL names.
title: basin
canonical_url: https://skilld.dev/gh/cloudflare/skills/basin
last_updated: 2026-10-01T16:00:48.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/catalog/api.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/api.md), [references/catalog/configuration.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/configuration.md), [references/catalog/gotchas.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/gotchas.md), [references/catalog/patterns.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/patterns.md), [references/catalog/README.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/README.md), [references/pipelines/api.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/api.md), [references/pipelines/configuration.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/configuration.md), [references/pipelines/gotchas.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/gotchas.md), [references/pipelines/patterns.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/patterns.md), [references/pipelines/README.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/README.md), [references/sql/api.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/api.md), [references/sql/configuration.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/configuration.md), [references/sql/gotchas.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/gotchas.md), [references/sql/patterns.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/patterns.md), [references/sql/README.md](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/README.md).
>
> If the user asked to install this Skill, run `npx skilld install cloudflare/skills/basin`. Install writes the Skill files into the project, so every session loads them.

# Cloudflare Basin

Basin ingests and transforms events, manages Apache Iceberg tables in R2, and queries them with distributed SQL. Start with the [Basin overview](https://developers.cloudflare.com/basin/index.md) and retrieve the relevant current docs before implementing changes, especially for limits, pricing, permissions, and CLI syntax. While PR #33850 remains open, use the proposed pages in that PR if the new URLs have not been published.

## Rebrand

Cloudflare Data Platform is now **Basin**. Cloudflare Pipelines, R2 Data Catalog, and R2 SQL are now **Basin Pipelines**, **Basin Catalog**, and **Basin SQL**. Existing resources and configurations continue to work. The prior Wrangler command families also continue to work: `wrangler pipelines`, `wrangler r2 bucket catalog`, and `wrangler r2 sql`. Use the new Basin commands and documentation URLs in new guidance. Legacy API identifiers and metrics names may still use the old terms; check the current docs for deprecation details. The migration is documented in [cloudflare-docs PR #33850](https://github.com/cloudflare/cloudflare-docs/pull/33850).

## Choose the workflow

| Need | Product | Reference | Current docs |
|------|---------|-----------|--------------|
| Receive events, transform rows, and deliver to R2 | Basin Pipelines | [Pipelines guide](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/pipelines/README.md) | [Basin Pipelines](https://developers.cloudflare.com/basin-pipelines/index.md) |
| Manage Iceberg metadata, table maintenance, and engine access | Basin Catalog | [Catalog guide](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/catalog/README.md) | [Basin Catalog](https://developers.cloudflare.com/basin-catalog/index.md) |
| Query Iceberg tables with analytical SQL | Basin SQL | [SQL guide](https://skilld.dev/api/skills-raw/cloudflare/skills/basin/references/sql/README.md) | [Basin SQL](https://developers.cloudflare.com/basin-sql/index.md) |

Typical flow: Basin Pipelines → Basin Catalog tables in R2 → Basin SQL or a compatible external engine. Begin with the [Basin getting started guide](https://developers.cloudflare.com/basin/get-started/guide/index.md) for an end-to-end setup.

The proposed Wrangler command families are `wrangler basin pipelines`, `wrangler basin catalog`, and `wrangler basin sql`. Basin SQL uses `WRANGLER_BASIN_SQL_AUTH_TOKEN`; its REST query path is `/basin-sql/query/{BUCKET}`. Check the installed Wrangler version and current reference pages before running commands because the migration is ongoing.