Skip to main content

Preflight checks for Starburst Enterprise

Before running the Starburst Enterprise crawler, you can run preflight checks to perform the necessary technical validations. The connector validates connectivity to your Starburst Enterprise instance.

Data products authentication check​

This check verifies that the provided credentials can access the Starburst Enterprise data products API used for extracting domains and data products.

The connector attempts to authenticate and query the /api/v1/dataProduct/domains endpoint.

✅ Data products authentication successful

❌ Data products authentication failed: <error-message>

SQL authentication check​

This check verifies that the provided credentials can connect to the Starburst Enterprise SQL interface.

The connector attempts to establish a SQL connection and query the system.metadata.catalogs table.

✅ SQL authentication successful

❌ SQL authentication failed: <error-message>

Catalog access check​

This check validates that the connector can access and enumerate catalogs via the SQL interface.

The connector queries system.metadata.catalogs to retrieve the list of available catalogs and verifies read access.

✅ Catalog access verified: <n> catalog(s) accessible

❌ Catalog access failed: <error-message>

Domain access check​

This check verifies that the connector can enumerate domains and data products from your Starburst Enterprise instance.

The connector queries the domains and data products endpoints to verify permissions.

✅ Domain access verified: <n> domain(s), <m> data product(s) accessible

❌ Domain access failed: <error-message>

See also​