Adding R2 SQL docs (#25338)

* initial docs

* fixed link in index

* fix indents in index, add query-data

* Improved all docs, added index.mdx in platform

also tested examples e2e

* removed redundant command

* A ton of changes and improvements

implemented Jerome's feedback in virtually all docs. Docs are properly organized now.

* Update get-started.mdx

* Update end-to-end-pipeline.mdx

* added dash steps/tabs, moved out of r2, reformatted most of the R2 SQL docs

* added new R2 SQL token env variable

* adding wrangler commands

* Update .gitignore

* PCX Review

* Update src/content/docs/r2-sql/reference/limitations-best-practices.mdx

Co-authored-by: netgusto <[email protected]>

* adding improvements from the latest round of reviews

* fixed min permissions needed

* more improvements from reviews

* Update src/content/docs/r2-sql/platform/pricing.mdx

Co-authored-by: Nikita Lapkov <[email protected]>

* Update src/content/docs/r2-sql/reference/limitations-best-practices.mdx

Co-authored-by: Nikita Lapkov <[email protected]>

* Update src/content/docs/r2-sql/reference/sql-reference.mdx

Co-authored-by: Nikita Lapkov <[email protected]>

* Adding improvements from Nikita's review

* changed the getting started to match Pipelines for consistency

* Small formatting + other changes

* fixed typo and added the changelog

* Add redirect for troubleshooting guide

* Chagnes to changelog

* Fixes pipeline, broken links

* adding our official r2-sql icon

* addressing Yevgen's feedback

* fix typo in getting started for r2 sql

---------

Co-authored-by: Jun Lee <[email protected]>
Co-authored-by: netgusto <[email protected]>
Co-authored-by: Nikita Lapkov <[email protected]>
Co-authored-by: Phillip Jones <[email protected]>

Author: 5 people

.gitignore

@@ -29,4 +29,4 @@ pnpm-debug.log*
 /assets/secrets
 /worker/functions/
 
-.idea
+.idea

public/__redirects

@@ -1579,6 +1579,7 @@
 /r2/examples/cloudflare-access/ /r2/tutorials/cloudflare-access/ 301
 /r2/examples/upload-logs-event-notifications/ /r2/tutorials/upload-logs-event-notifications/ 301
 /r2/examples/demo-worker/ /r2/api/workers/workers-api-usage/ 301
+/r2/sql/platform/troubleshooting/ /r2-sql/troubleshooting/ 301
 
 # time-services_redirects
 /time-services/nts/usage/ /time-services/nts/ 301

src/content/changelog/r2-sql/2025-09-25-announcing-r2-sql-open-beta.mdx

@@ -0,0 +1,31 @@
+---
+title: Announcing R2 SQL
+description: Run SQL queries against Apache Iceberg tables in R2 Data Catalog
+date: 2025-09-25T13:00:00
+products:
+  - r2-sql
+hidden: true
+---
+
+import { LinkCard} from "~/components";
+
+Today, we're launching the **open beta** for [R2 SQL](/r2-sql/): A serverless, distributed query engine that can efficiently analyze petabytes of data in [Apache Iceberg](https://iceberg.apache.org/) tables managed by [R2 Data Catalog](/r2/data-catalog).
+
+R2 SQL is ideal for exploring analytical and time-series data stored in R2, such as logs, events from [Pipelines](/pipelines/), or clickstream and user behavior data.
+
+If you already have a table in R2 Data Catalog, running queries is as simple as:
+
+```bash
+npx wrangler r2 sql query YOUR_WAREHOUSE "
+SELECT
+    user_id,
+    event_type,
+    value
+FROM events.user_events
+WHERE event_type = 'CHANGELOG' or event_type = 'BLOG'
+  AND __ingest_ts > '2025-09-24T00:00:00Z'
+ORDER BY __ingest_ts DESC
+LIMIT 100"
+```
+
+To get started with R2 SQL, check out our [getting started guide](/r2-sql/get-started/) or learn more about supported features in the [SQL reference](/r2-sql/sql-reference/). For a technical deep dive into how we built R2 SQL, read our [blog post](https://blog.cloudflare.com/r2-sql-deep-dive/).