From 9baa861551d007f14b258f2c44c2d635bd27b95f Mon Sep 17 00:00:00 2001
From: Kat Batuigas <kbatuigas@gmail.com>
Date: Mon, 4 May 2026 14:11:55 -0700
Subject: [PATCH 1/2] SQL GA nav

---
 modules/ROOT/nav.adoc | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc
index fc68a8f5..c028de13 100644
--- a/modules/ROOT/nav.adoc
+++ b/modules/ROOT/nav.adoc
@@ -335,17 +335,33 @@
 *** xref:develop:connect/cookbooks/jira.adoc[]
 
 * xref:sql:index.adoc[Redpanda SQL]
-// ** quickstart.adoc
-** xref:sql:get-started/what-is-redpanda-sql.adoc[Overview]
-*** xref:sql:get-started/oltp-vs-olap.adoc[]
-*** xref:sql:get-started/redpanda-sql-vs-postgresql.adoc[]
+// ============================================================================
+// DOC-1993 — Redpanda SQL IA (target BYOC AWS GA 2026-05-22)
+// Most placeholders below do not have linked pages until pages land (except DOC-1856). 
+// Add xrefs per ticket as pages are created.
+// ============================================================================
+// ** xref:sql:get-started/index.adoc[Get Started]
+// *** xref:sql:get-started/sql-quickstart.adoc[Quickstart]                              // DOC-1856 (in review, draft on DOC-1856 branch)
+// *** xref:sql:get-started/deploy-sql-cluster.adoc[Enable Redpanda SQL]                 // DOC-1856
+** Get Started
+*** Quickstart
+*** Enable Redpanda SQL
+*** xref:sql:get-started/what-is-redpanda-sql.adoc[Overview]
+**** xref:sql:get-started/oltp-vs-olap.adoc[]
+**** xref:sql:get-started/redpanda-sql-vs-postgresql.adoc[]
 ** xref:sql:connect-to-sql/index.adoc[Connect to Redpanda SQL]
 *** xref:sql:connect-to-sql/language-clients/psycopg2.adoc[]
 *** xref:sql:connect-to-sql/language-clients/java-jdbc.adoc[]
 *** xref:sql:connect-to-sql/language-clients/php-pdo.adoc[]
 *** xref:sql:connect-to-sql/language-clients/dotnet-dapper.adoc[]
+** Query data
+*** Query Redpanda topics
+*** Query Iceberg
+** Manage Redpanda SQL
+*** Configure OIDC
 ** xref:sql:troubleshoot/index.adoc[Troubleshoot]
 *** xref:sql:troubleshoot/degraded-state-handling.adoc[]
+*** Memory management
 
 * xref:develop:index.adoc[Develop]
 ** xref:develop:kafka-clients.adoc[]

From 034080654cb0d26a89bcb0e542a3742be094b2da Mon Sep 17 00:00:00 2001
From: Kat Batuigas <kbatuigas@gmail.com>
Date: Mon, 4 May 2026 15:51:57 -0700
Subject: [PATCH 2/2] Start reference update for SQL / Iceberg catalog

---
 .../create-redpanda-catalog.adoc              | 24 ++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/modules/reference/pages/sql/sql-statements/create-redpanda-catalog.adoc b/modules/reference/pages/sql/sql-statements/create-redpanda-catalog.adoc
index 605e1682..43b55ee5 100644
--- a/modules/reference/pages/sql/sql-statements/create-redpanda-catalog.adoc
+++ b/modules/reference/pages/sql/sql-statements/create-redpanda-catalog.adoc
@@ -9,11 +9,13 @@ The `CREATE REDPANDA CATALOG` statement creates a named connection to a Redpanda
 [source,sql]
 ----
 CREATE REDPANDA CATALOG [IF NOT EXISTS] catalog_name
-WITH (option = 'value' [, ...]);
+  [USING CATALOG [schema.]iceberg_catalog_name]
+  WITH (option = 'value' [, ...]);
 ----
 
 * `catalog_name`: Name for the new catalog connection.
 * `IF NOT EXISTS`: Optional. Prevents an error if a catalog with the same name already exists.
+* `USING CATALOG iceberg_catalog_name`: Optional. Links the Redpanda catalog to an existing Iceberg catalog so that queries against tables in this catalog can return data from both the Redpanda topic and its corresponding Iceberg table in a single result. The Iceberg catalog must already exist. You can qualify the Iceberg catalog name with a schema prefix.
 
 == Options
 
@@ -60,6 +62,11 @@ WITH (option = 'value' [, ...]);
 |STRING
 |No
 |Schema Registry authentication password.
+
+|`pandaproxy_url`
+|STRING
+|Conditional
+|Base URL of the Redpanda HTTP Proxy REST API. Required when the catalog includes a `USING CATALOG` clause; Redpanda SQL uses this endpoint to fetch Iceberg translation state for queries that span the topic and its Iceberg table.
 |===
 
 == Examples
@@ -91,3 +98,18 @@ WITH (
   schema_registry_password = 'sr_pass'
 );
 ----
+
+=== Create a catalog linked to an Iceberg catalog
+
+Use the `USING CATALOG` clause to link a Redpanda catalog to an existing Iceberg catalog. Queries against tables in the linked Redpanda catalog can then return a non-overlapping continuum of data from the Redpanda topic and its corresponding Iceberg table in a single result.
+
+[source,sql]
+----
+CREATE REDPANDA CATALOG my_linked_catalog
+  USING CATALOG my_iceberg_catalog
+  WITH (
+    initial_brokers = 'broker1:9092',
+    schema_registry_url = 'http://schema-registry:8081',
+    pandaproxy_url = 'http://redpanda:8082'
+  );
+----