From 83b237c7c5e5cae341ec8a7fed0548ed42a9d520 Mon Sep 17 00:00:00 2001 From: Kat Batuigas Date: Thu, 21 May 2026 12:55:19 -0700 Subject: [PATCH 1/2] Add glossary terms for Redpanda SQL and Iceberg Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/terms/partials/iceberg-catalog.adoc | 4 ++++ modules/terms/partials/iceberg-mode.adoc | 4 ++++ modules/terms/partials/iceberg-topic.adoc | 4 ++++ modules/terms/partials/iceberg-translation.adoc | 4 ++++ modules/terms/partials/oxla.adoc | 4 ++++ modules/terms/partials/redpanda-catalog.adoc | 4 ++++ modules/terms/partials/redpanda-sql.adoc | 6 ++++++ modules/terms/partials/wire-format.adoc | 4 ++++ 8 files changed, 34 insertions(+) create mode 100644 modules/terms/partials/iceberg-catalog.adoc create mode 100644 modules/terms/partials/iceberg-mode.adoc create mode 100644 modules/terms/partials/iceberg-topic.adoc create mode 100644 modules/terms/partials/iceberg-translation.adoc create mode 100644 modules/terms/partials/oxla.adoc create mode 100644 modules/terms/partials/redpanda-catalog.adoc create mode 100644 modules/terms/partials/redpanda-sql.adoc create mode 100644 modules/terms/partials/wire-format.adoc diff --git a/modules/terms/partials/iceberg-catalog.adoc b/modules/terms/partials/iceberg-catalog.adoc new file mode 100644 index 0000000000..8d7c3691bf --- /dev/null +++ b/modules/terms/partials/iceberg-catalog.adoc @@ -0,0 +1,4 @@ +=== Iceberg catalog +:term-name: Iceberg catalog +:hover-text: A metadata service that tracks Apache Iceberg tables and their schemas. Redpanda supports two types: REST catalog (an external service such as AWS Glue, Snowflake Open Catalog, or Databricks Unity Catalog) and filesystem-based catalog (metadata files in the same object storage as the data). Redpanda SQL connects to a REST catalog with `CREATE ICEBERG CATALOG` to query the Iceberg-committed history of a topic. +:category: Redpanda core diff --git a/modules/terms/partials/iceberg-mode.adoc b/modules/terms/partials/iceberg-mode.adoc new file mode 100644 index 0000000000..11f7a78e0a --- /dev/null +++ b/modules/terms/partials/iceberg-mode.adoc @@ -0,0 +1,4 @@ +=== Iceberg mode +:term-name: Iceberg mode +:hover-text: The Redpanda topic property (`redpanda.iceberg.mode`) that controls whether and how the topic's records are translated into an Apache Iceberg table. +:category: Redpanda core diff --git a/modules/terms/partials/iceberg-topic.adoc b/modules/terms/partials/iceberg-topic.adoc new file mode 100644 index 0000000000..3ef63b8a38 --- /dev/null +++ b/modules/terms/partials/iceberg-topic.adoc @@ -0,0 +1,4 @@ +=== Iceberg topic +:term-name: Iceberg topic +:hover-text: A Redpanda topic with Iceberg integration enabled, so its data is also stored as an Apache Iceberg table that downstream analytical systems can read directly. Also called an Iceberg-enabled topic. +:category: Redpanda core diff --git a/modules/terms/partials/iceberg-translation.adoc b/modules/terms/partials/iceberg-translation.adoc new file mode 100644 index 0000000000..1f6cf7e784 --- /dev/null +++ b/modules/terms/partials/iceberg-translation.adoc @@ -0,0 +1,4 @@ +=== Iceberg translation +:term-name: Iceberg translation +:hover-text: The background process that converts records on an Iceberg topic into Apache Iceberg format and commits them to the configured Iceberg catalog. +:category: Redpanda core diff --git a/modules/terms/partials/oxla.adoc b/modules/terms/partials/oxla.adoc new file mode 100644 index 0000000000..26dabc43f2 --- /dev/null +++ b/modules/terms/partials/oxla.adoc @@ -0,0 +1,4 @@ +=== Oxla +:term-name: Oxla +:hover-text: The SQL engine technology that powers Redpanda SQL. "Oxla" may appear in version strings, error messages, and some API field names. +:category: Redpanda SQL diff --git a/modules/terms/partials/redpanda-catalog.adoc b/modules/terms/partials/redpanda-catalog.adoc new file mode 100644 index 0000000000..660aa39f40 --- /dev/null +++ b/modules/terms/partials/redpanda-catalog.adoc @@ -0,0 +1,4 @@ +=== Redpanda catalog +:term-name: Redpanda catalog +:hover-text: A catalog in Redpanda SQL that maps Redpanda topics to SQL tables. The default Redpanda catalog (`default_redpanda_catalog`) is provisioned automatically when Redpanda SQL is enabled. +:category: Redpanda SQL diff --git a/modules/terms/partials/redpanda-sql.adoc b/modules/terms/partials/redpanda-sql.adoc new file mode 100644 index 0000000000..92c72cc723 --- /dev/null +++ b/modules/terms/partials/redpanda-sql.adoc @@ -0,0 +1,6 @@ +=== Redpanda SQL +:term-name: Redpanda SQL +:hover-text: A PostgreSQL-compatible SQL engine built into Redpanda Data Platform for querying streaming data in Redpanda topics. +:category: Redpanda SQL + +Redpanda SQL provides analytical SQL queries over Redpanda topic data without requiring ETL pipelines or a separate analytics system. It can also query the Iceberg-translated history of Iceberg-enabled topics alongside live records. diff --git a/modules/terms/partials/wire-format.adoc b/modules/terms/partials/wire-format.adoc new file mode 100644 index 0000000000..9c4c62f147 --- /dev/null +++ b/modules/terms/partials/wire-format.adoc @@ -0,0 +1,4 @@ +=== wire format +:term-name: wire format +:hover-text: A serialization format used by Schema Registry that prefixes each record with a magic byte and 4-byte schema ID, so consumers can identify and apply the correct schema. +:category: Redpanda core From f9d5d7ae5eff484e43ce12f3f68a9ccd3a1b031f Mon Sep 17 00:00:00 2001 From: Kat Batuigas Date: Fri, 22 May 2026 17:46:38 -0700 Subject: [PATCH 2/2] Tighten iceberg-catalog hover-text per review Shorten :hover-text: to one sentence with the two catalog types, and move the Redpanda-SQL-specific detail into an optional extended paragraph (same pattern as redpanda-sql.adoc). Co-Authored-By: Claude Opus 4.7 (1M context) --- modules/terms/partials/iceberg-catalog.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/modules/terms/partials/iceberg-catalog.adoc b/modules/terms/partials/iceberg-catalog.adoc index 8d7c3691bf..e8e960e532 100644 --- a/modules/terms/partials/iceberg-catalog.adoc +++ b/modules/terms/partials/iceberg-catalog.adoc @@ -1,4 +1,6 @@ === Iceberg catalog :term-name: Iceberg catalog -:hover-text: A metadata service that tracks Apache Iceberg tables and their schemas. Redpanda supports two types: REST catalog (an external service such as AWS Glue, Snowflake Open Catalog, or Databricks Unity Catalog) and filesystem-based catalog (metadata files in the same object storage as the data). Redpanda SQL connects to a REST catalog with `CREATE ICEBERG CATALOG` to query the Iceberg-committed history of a topic. +:hover-text: A metadata service that tracks Apache Iceberg tables and their schemas. Redpanda supports REST catalogs (such as AWS Glue, Snowflake Open Catalog, or Databricks Unity Catalog) and filesystem-based catalogs. :category: Redpanda core + +Redpanda SQL connects to a REST catalog with `CREATE ICEBERG CATALOG` to query the Iceberg-committed history of a topic.