Skip to main content
Wherobots-managed data catalogs expose an Iceberg REST catalog API. An external engine connects to this API to find tables and access their data, while Wherobots continues to manage the catalog metadata. Queries execute in the external engine. This workflow uses tables in a Wherobots-managed catalog. Foreign catalogs connected to Wherobots, such as AWS Glue or Databricks Unity Catalog, aren’t exposed through this endpoint. To use WherobotsDB with those catalogs, see Connect WherobotsDB to external catalogs.

Check compatibility

Iceberg REST support alone doesn’t guarantee that an engine supports every table or operation. Check:
  • Authentication and storage access: The engine must authenticate to the catalog and access the table’s storage. The SedonaDB, Snowflake, and DuckDB integrations use a Wherobots API key and credentials issued by Wherobots for storage access.
  • Reads and writes: Support for reading, creating, and updating tables depends on the engine and your permissions.
  • Iceberg format version and column types: Confirm that the engine supports the table’s format version and any spatial types.
The Wherobots-specific raster type is documented in the open Spatial Extensions for Apache Iceberg Tables specification. It isn’t part of the Apache Iceberg specification, so check whether your engine supports it. For Wherobots table formats and spatial types, see Iceberg tables.

Connect SedonaDB

The SedonaDB tutorial covers querying Iceberg v2 and v3 tables from Python with the wherobots-catalog package, joining them with local data, and reading geometry columns. This integration reads tables but doesn’t write them, and it doesn’t support tables with raster columns. Follow the tutorial to install the packages, set your API key, and verify the connection before querying tables.

Connect Snowflake

The Snowflake tutorial covers reading Iceberg v2 and v3 tables, creating tables and inserting rows through a catalog-linked database, and using Iceberg v3 geometry columns as Snowflake GEOMETRY. Raster columns aren’t supported by this integration. Follow the tutorial to find your catalog ID, configure authentication, and verify the connection before querying tables.

Connect DuckDB

The DuckDB tutorial covers reading Iceberg v2 and v3 tables from Python with DuckDB’s iceberg extension, including geometry columns. This integration can’t change existing tables or read raster columns. Follow the tutorial to set your credentials, attach a catalog, and verify the connection before querying tables.