Skip to content

Commit 53a0809

Browse files
committed
Conditionalize xref
1 parent bcd8329 commit 53a0809

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

modules/manage/partials/iceberg/use-iceberg-catalogs.adoc

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,15 @@
1-
To read from the Redpanda-generated xref:manage:iceberg/topic-iceberg-integration.adoc[Iceberg table], your Iceberg-compatible client or tool needs access to the catalog to retrieve the table metadata and know the current state of the table. The catalog provides the current table metadata, which includes locations for all the table's data files. You can configure Redpanda to either connect to a REST-based catalog, or use a file-system based catalog.
1+
ifdef::env-byoc[:about-iceberg-doc: manage:iceberg/about-iceberg-topics.adoc]
2+
ifndef::env-byoc[:about-iceberg-doc: manage:iceberg/topic-iceberg-integration.adoc]
3+
4+
To read from the Redpanda-generated xref:{about-iceberg-doc}[Iceberg table], your Iceberg-compatible client or tool needs access to the catalog to retrieve the table metadata and know the current state of the table. The catalog provides the current table metadata, which includes locations for all the table's data files. You can configure Redpanda to either connect to a REST-based catalog, or use a file-system based catalog.
25

36
ifdef::env-byoc[]
47
NOTE: The Iceberg integration for Redpanda Cloud is a beta feature. It is not supported for production deployments. To test a REST-based catalog with your cloud cluster, contact https://support.redpanda.com/hc/en-us/requests/new[Redpanda support^].
58
endif::[]
69

710
For production deployments, Redpanda recommends using an external REST catalog to manage Iceberg metadata. This enables built-in table maintenance, safely handles multiple engines and tools accessing tables at the same time, facilitates data governance, and maximizes data discovery. However, if it is not possible to use a REST catalog, you may use the file-system based catalog, which does not require you to maintain a separate service to access the Iceberg data. In either case, you use the catalog to load, query, or refresh the Iceberg table as you produce to the Redpanda topic. See the documentation for your query engine or Iceberg-compatible tool for specific guidance on adding the Iceberg tables to your data warehouse or lakehouse using the catalog.
811

9-
After you have selected a catalog type at the cluster level and xref:manage:iceberg/topic-iceberg-integration.adoc#enable-iceberg-integration[enabled the Iceberg integration] for a topic, you cannot switch to another catalog type.
12+
After you have selected a catalog type at the cluster level and xref:{about-iceberg-doc}#enable-iceberg-integration[enabled the Iceberg integration] for a topic, you cannot switch to another catalog type.
1013

1114
ifndef::env-byoc[]
1215
== Connect to a REST catalog

0 commit comments

Comments
 (0)