Skip to main content
Community Hub

Preflight checks for Iceberg

TL;DR

Technical validations performed before crawling Iceberg data lakehouse resources.

Your AI can read this via Docs MCPcurl -fsSL "https://docs.atlan.com/install-docs-mcp" | bashConnect

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