mcpField
B
basin

basin

github.com/cloudflare数据与数据库3.2k22.9k 次安装今天更新
代码仓库

关于 basin

面向 Cloudflare Basin 的文档技能，涵盖事件摄取与转换、在 R2 中管理 Apache Iceberg 表，以及分布式 SQL 查询。它引导 Agent 查阅最新参考资料，了解实现细节及产品和 Wrangler 命令迁移。

主要功能

  1. 01说明 Pipelines、Catalog 和 SQL 工作流
  2. 02梳理事件到 Iceberg 再到查询的流程
  3. 03跟踪产品更名和 Wrangler 命令迁移
  4. 04提示核对当前限制与权限

适用场景

  1. 01规划事件写入 R2 表
  2. 02管理 Iceberg 元数据或维护表
  3. 03使用分析型 SQL 查询 Iceberg 数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cloudflare/skills --skill basin

安装后在 Claude Code 中输入/basin确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/catalog/
api.md
configuration.md
gotchas.md
patterns.md
README.md
references/pipelines/
api.md
configuration.md
gotchas.md
patterns.md
README.md
references/sql/
api.md
configuration.md
gotchas.md
patterns.md
README.md

详细介绍

Cloudflare Basin

Basin 用于接收和转换事件、在 R2 中管理 Apache Iceberg 表，并通过分布式 SQL 查询数据。开始前，请阅读 Basin 概览，并在实施更改前查阅相关的最新文档，尤其是有关限制、定价、权限和 CLI 语法的内容。PR #33850 仍处于开放状态期间，如果新 URL 尚未发布，请使用该 PR 中提议的页面。

品牌更新

Cloudflare Data Platform 现已更名为 Basin。Cloudflare Pipelines、R2 Data Catalog 和 R2 SQL 现已分别更名为 Basin Pipelines、Basin Catalog 和 Basin SQL。现有资源和配置仍可继续使用。此前的 Wrangler 命令系列也仍可继续使用：wrangler pipelines、wrangler r2 bucket catalog 和 wrangler r2 sql。编写新的指南时，请使用新的 Basin 命令和文档 URL。旧版 API 标识符和指标名称可能仍使用旧术语；有关弃用详情，请查阅最新文档。迁移情况记录在 cloudflare-docs PR #33850 中。

选择工作流

需求产品参考指南最新文档
接收事件、转换行数据并将其传输到 R2Basin PipelinesPipelines 指南Basin Pipelines
管理 Iceberg 元数据、表维护和引擎访问Basin CatalogCatalog 指南Basin Catalog
使用分析型 SQL 查询 Iceberg 表Basin SQLSQL 指南Basin SQL

典型流程：Basin Pipelines → R2 中的 Basin Catalog 表 → Basin SQL 或兼容的外部引擎。请从 Basin 入门指南 开始，完成端到端设置。

提议的 Wrangler 命令系列为 wrangler basin pipelines、wrangler basin catalog 和 wrangler basin sql。Basin SQL 使用 WRANGLER_BASIN_SQL_AUTH_TOKEN；其 REST 查询路径为 /basin-sql/query/{BUCKET}。由于迁移仍在进行，请在运行命令前检查已安装的 Wrangler 版本和最新参考页面。

评论

支持 Markdown