Configure a catalog integration for Apache Iceberg™ REST catalogs

An Apache Iceberg™ REST catalog integration lets Snowflake access Apache Iceberg™ tables managed in a remote catalog that complies with the open source Apache Iceberg REST OpenAPI specification (https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml).

Authentication methods

Snowflake supports the following authentication methods for Iceberg REST catalogs:

  • OAuth

  • Bearer token or personal access token (PAT)

  • Signature Version 4 (SigV4)

Supported authentication methods vary by catalog source.

Credential rotation

To rotate the credentials for a catalog integration, you can use the ALTER CATALOG INTEGRATION command to update the credentials that Snowflake uses to authenticate with your remote catalog.

For example:

ALTER CATALOG INTEGRATION my_cat_int SET
  REST_AUTHENTICATION (
    OAUTH_CLIENT_SECRET = 'myNewSecret'
  );
Copy

Connection options

In addition to External volumes, Snowflake supports the following connection options for Iceberg REST catalogs:

Supported connection options vary by catalog source.

Catalog sources

Snowflake supports any external catalog server that complies with the Iceberg REST specification.

The following topics provide examples for commonly used REST catalogs:

Browsing a remote catalog

After you create a catalog integration for Iceberg REST, you can use the following Snowflake system functions to browse namespaces and tables in the catalog:

Language: English