Skip to content

[26.2] Schema context support for Iceberg translation#1784

Open
kbatuigas wants to merge 5 commits into
betafrom
DOC-2192-document-feature-iceberg-support-translation-usi
Open

[26.2] Schema context support for Iceberg translation#1784
kbatuigas wants to merge 5 commits into
betafrom
DOC-2192-document-feature-iceberg-support-translation-usi

Conversation

@kbatuigas

@kbatuigas kbatuigas commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Description

This pull request introduces support for resolving Iceberg-enabled topic schemas within specific Schema Registry contexts, rather than always using the default context. It adds a new topic property, redpanda.schema.registry.context, and updates documentation to reflect this new capability, which is especially useful for multi-tenant or per-environment schema isolation. Related troubleshooting guidance and configuration documentation have also been updated.

Iceberg and Schema Registry context support:

  • Added the redpanda.schema.registry.context topic property, allowing topics to bind Iceberg translation to a specific Schema Registry context for schema resolution.
  • Updated release notes to document the new context property, describe its use cases, and link to configuration examples.
  • Added troubleshooting documentation for cases where Redpanda cannot resolve a schema ID within the topic's configured Schema Registry context.

Resolves https://redpandadata.atlassian.net/browse/DOC-2192
Review deadline: 23 Jul

Preview pages

Checks

  • New feature
  • Content gap
  • Support Follow-up
  • Small fix (typos, links, copyedits, etc)

@kbatuigas
kbatuigas requested a review from a team as a code owner July 10, 2026 19:27
@netlify

netlify Bot commented Jul 10, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit 7b74be4
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/6a625e2fabe7f20008586f06
😎 Deploy Preview https://deploy-preview-1784--redpanda-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai

coderabbitai Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: b1b0cb08-8e40-4619-a938-acb0d66a5b07

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch DOC-2192-document-feature-iceberg-support-translation-usi

Comment @coderabbitai help to get the list of available commands.

@kbatuigas
kbatuigas force-pushed the DOC-2192-document-feature-iceberg-support-translation-usi branch from 0734ec9 to e53e23a Compare July 21, 2026 22:19

== Iceberg translation with Schema Registry contexts

Iceberg-enabled topics can now resolve schemas from a specific xref:manage:schema-reg/schema-reg-contexts.adoc[Schema Registry context] instead of always using the default context. Set the new `redpanda.schema.registry.context` topic property to bind a topic's Iceberg translation to a context, useful for multi-tenant or per-environment schema isolation.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably better split into two sentences

// tag::category-schema-registry[]
=== redpanda.schema.registry.context

The xref:manage:schema-reg/schema-reg-contexts.adoc[Schema Registry context] Redpanda uses to resolve schema IDs for records in this topic, for example when translating the topic to an Iceberg table. Defaults to the Schema Registry default context (`.`).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically not always true I think. It uses the context to resolve either the schema ID or the name of the schema depending on the iceberg translation mode. Cc @wdberkeley

[[resolve-schemas-within-a-context]]
=== Resolve schemas within a Schema Registry context

If you use xref:manage:schema-reg/schema-reg-contexts.adoc[Schema Registry contexts] to isolate schemas (for example, by environment or tenant), set the `redpanda.schema.registry.context` topic property to bind the topic to that context. Redpanda then resolves schema IDs referenced by records in the topic against the configured context instead of the default context (`.`).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment here. Resolves "schemas" is probably better catch all . Sometimes it looks up by ID in a context and sometime by name @kbatuigas

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants