Skip to main content
Alpha: Tableflow support and these docs may change.
Confluent Tableflow materializes Kafka topics as Iceberg tables. Registering its REST catalog makes those topics queryable from the lake.
Tableflow catalogs are read-only: writes, loads, and DDL are refused. Only AWS clusters using Confluent Managed Storage are supported.

​
Setup

​
1. Get the endpoint and an API key

In Confluent Cloud:
  1. Open Tableflow → API access and copy the REST Catalog Endpoint. It looks like https://tableflow.<region>.aws.confluent.cloud/iceberg/catalog/organizations/<org-id>/environments/<env-id>.
  2. Create an API key with the Tableflow resource scope. Keep the key and secret.

​
2. Register the catalog

  1. Open Settings → Lake and find External catalogs.
  2. Select Confluent Tableflow and fill in the fields:
oleander checks the key against Confluent before saving. The key and secret are stored encrypted and are not shown again; re-enter both when editing the catalog. Or from the CLI, piping the secret on stdin:

​
Query

Tables appear under the Kafka cluster ID, not the cluster name, with one table per topic. Test the catalog from the CLI:
Drop --engine duckdb to let oleander pick the engine automatically.