Skip to main content

Preflight checks for Iceberg

Before crawling Iceberg, you can run preflight checks to check for any permissions or configuration issues before running the crawler. The following preflight checks are performed:

Authentication check​

This check verifies that the provided credentials (REST catalog URI and token if required) are valid by attempting to connect to the Iceberg catalog and list namespaces.

✅ Authentication successful

❌ Authentication failed: <error-message>

Catalog permissions check​

This check verifies that the authenticated connection has the necessary permissions to access the catalog and list tables within namespaces.

✅ Catalog permissions successful

❌ Catalog permissions insufficient: <error-message>

Common failure reasons include:

  • Insufficient scope permissions
  • Catalog not found or inaccessible
  • Network connectivity issues
  • Invalid warehouse configuration