Skip to main content

iceberg.catalog

Open an Arraylake org's iceberg catalog as a pyiceberg catalog.

The Arraylake Iceberg REST catalog is served at {service_uri}/iceberg. A warehouse is an org, addressed as warehouse=<org>: every org has exactly one implicit catalog, holding that org's (flat, single-level) iceberg namespaces, so tables are addressed as "<namespace>.<table>".

The caller's ordinary Arraylake bearer token (an ema_... api-client token or the logged-in user's OAuth token) is the catalog credential; the catalog vends storage credentials per table, so no other configuration is needed.

get_iceberg_catalog​

def get_iceberg_catalog(*, name: str, service_uri: str, warehouse: str,
                        token: str | None) -> "RestCatalog"

Construct a pyiceberg RestCatalog for an Arraylake iceberg warehouse.

Arguments:

  • name - Catalog name (conventionally the org name).
  • service_uri - The Arraylake API base URI.
  • warehouse - The warehouse, which is the org name.
  • token - An explicit bearer token, or None to use the cached user login.

Returns:

A ready-to-use pyiceberg.catalog.rest.RestCatalog.