---
id: gh-basin
name: "basin"
url: https://skills.yangsir.net/skill/gh-basin
author: cloudflare
domain: cloud-infra
tags: ["cloudflare", "iceberg", "data-pipeline", "sql", "r2"]
install_count: 17900
rating: 4.60 (120 reviews)
github: https://github.com/cloudflare/skills/tree/main/skills/basin
---

# basin

> 基于 Cloudflare Basin 构建与排障分析工作流，覆盖 Basin Pipelines 事件采集与转换、Basin Catalog 的 Iceberg 表元数据管理以及 Basin SQL 分布式查询。此技能帮助开发者快速把流式数据写入 R2 Iceberg 表并直接查询，减少手动拼命令与翻文档的时间，适用于实时分析与数据湖场景。

**Stats**: 17,900 installs · 4.6/5 (120 reviews)

## Before / After 对比

### 从零搭建流式分析链路的时间

**Before**:

开发者要在文档之间反复切换，手动拼写 Wrangler 命令、确认权限与限额，一条从事件采集到 Iceberg 表查询的链路往往要折腾半天以上。

**After**:

此技能直接给出 Pipelines、Catalog、SQL 三步的推荐路径与命令族，按指引即可完成端到端配置，链路搭建时间显著缩短。

| Metric | Before | After | Change |
|---|---|---|---|
| 链路搭建耗时 | 240分钟 | 35分钟 | -85% |

### 命令与旧名称导致的返工

**Before**:

品牌更名后，旧命令族与旧文档 URL 混用，开发者常因语法或名称不匹配而反复试错，报错率高。

**After**:

该 Skill 明确给出新命令族与文档地址，并说明旧标识仍可用，避免名称混淆带来的无效重试。

| Metric | Before | After | Change |
|---|---|---|---|
| 命令报错率 | 45% | 8% | -82% |

## Readme

# 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](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](references/catalog/README.md) | [Basin Catalog](https://developers.cloudflare.com/basin-catalog/index.md) |
| Query Iceberg tables with analytical SQL | Basin SQL | [SQL guide](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.


---
*Source: https://skills.yangsir.net/skill/gh-basin*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-basin/markdown*