01 / DECISION
何時值得加入這個 primitive
metrics 仍交給 Analytics Engine、task fan-out 仍交給 Queues；當多個獨立 consumer 需要重播同一串有序事件時才加入 K2，當問題需要對大量開放格式歷史做 SQL 時才加入 Basin。
02 / ARCHITECTURE
建立最小且站得住腳的路徑
用 Basin Pipelines setup 建立 stream、SQL transformation 與 R2 上的 Iceberg table；compaction 與 snapshot expiration 交給 Basin Catalog；再用 Basin SQL 查詢 warehouse。K2 則由 producer 附加 records，subscriptions 負責送到單一 consumer group 或多個獨立 consumer。
- 01先命名 contract
metrics 仍交給 Analytics Engine、task fan-out 仍交給 Queues；當多個獨立 consumer 需要重播同一串有序事件時才加入 K2，當問題需要對大量開放格式歷史做 SQL 時才加入 Basin。
- 02只加入一個 primitive
用 Basin Pipelines setup 建立 stream、SQL transformation 與 R2 上的 Iceberg table；compaction 與 snapshot expiration 交給 Basin Catalog；再用 Basin SQL 查詢 warehouse。K2 則由 producer 附加 records，subscriptions 負責送到單一 consumer group 或多個獨立 consumer。
- 03保留 failure evidence
把範例事件 POST 到 stream 的 ingest endpoint，再用 Basin SQL 對 warehouse 查回同一批資料；K2 則確認每個 subscription 收到應有的 records，且重播時順序一致。
03 / REPRODUCE
有證據，再有信心
把範例事件 POST 到 stream 的 ingest endpoint，再用 Basin SQL 對 warehouse 查回同一批資料；K2 則確認每個 subscription 收到應有的 records，且重播時順序一致。
npx wrangler basin pipelines setup04 / BOUNDARY
Production boundary
Basin 已 GA，但 K2 仍是 public beta、需要 Workers Paid，每個 account 上限 10 GB、保留期最長 30 天。Basin SQL 屬於 analytical 而非 transactional，不能取代 D1；每個 Basin Pipelines stream 的 ingest 上限是 1 GB/s。Cloudflare Pipelines、R2 Data Catalog 與 R2 SQL 現已更名為 Basin Pipelines、Basin Catalog 與 Basin SQL，以舊名稱建立的資源仍可繼續運作。
05 / FIRST-PARTY SOURCES
讓第一方來源保持權威
產品行為、限制、價格與供應狀態會改變；採取行動前請重新核對這些來源。