Land CDC tables in your oleander Iceberg catalog with a Streamkap destination.
Streamkap is a managed data streaming platform that uses change data capture (CDC) to continuously replicate database inserts, updates, and deletes to destinations like Apache Iceberg. Connect its Iceberg destination to your oleander catalog to keep tables in your lake up to date and ready to query across compatible engines.For a live example, Bluehouse warehouses the public Bluesky firehose through exactly this connection - a Streamkap Iceberg destination writing into an oleander catalog namespace.
In Streamkap, open Destinations, click Add, and choose Iceberg.
On the Auth tab, fill in the catalog connection:
Field
Value
Catalog Type
REST
Catalog Name
oleander
Catalog URI
https://iceberg.oleander.dev/catalog
Authentication Mode
OAuth 2.0
OAuth2 Credential
<organization-id>:<api-key>
OAuth2 Scope
catalog
OAuth2 Token Endpoint
https://oleander.dev/api/v1/oidc/token
Provide S3 Credentials
Off - oleander vends storage credentials automatically
On the Settings tab:
Field
Value
Warehouse
Your organization ID
Schema
The Iceberg namespace to write into, e.g. bluesky
Region
us-east-2
Insert Mode
Insert only for append streams, or upsert if your source has keys
Click Save, then attach the destination to a pipeline.
The OAuth2 Credential is the organization ID and API key joined with a colon. Streamkap exchanges it for a short-lived catalog token on your behalf, so you never paste a token by hand.
Streamkap creates one table per topic under the schema you chose. Query it like any other table in your catalog:
SELECT count(*) FROM oleander.bluesky.bluesky_posts;
Tables land compacted, so the catalog stays healthy without extra maintenance. For long-running streams, schedule Iceberg maintenance to expire old snapshots and keep query times flat.
