Skip to main content

Enable Lakehouse

The Lakehouse enables you to instantly run SQL queries, build dashboards, and power AI applications directly on Atlan metadata without creating pipelines or data extracts.

This guide walks you through how to enable the Lakehouse for your Atlan workspace so you can start running queries on your Atlan metadata.

Query engine compatibility

If you use an engine that currently doesn't support querying external Iceberg REST catalogs, such as Databricks or Google BigQuery, contact your Atlan Customer Success team. Databricks and BigQuery support for Lakehouse is currently experimental and available through a custom setup.

Prerequisites​

Before you begin, make sure:

  • You have the Admin or Workflow Admin role in your Atlan workspace.

Enable lakehouse​

To start using the Lakehouse, you first need to enable it through the Atlan Marketplace.

  1. In your Atlan workspace, navigate to the Workflow page in the left-hand navigation bar.

  2. In the Workflow page, open the Marketplace tab.

  3. In the Marketplace tab, select the Atlan Lakehouse tile. You can also use the search bar to find the Atlan Lakehouse tile.

  4. Click Enable. When prompted, enter your tenant name in the format company.atlan.com, and then click Confirm.

After you click Confirm, Lakehouse setup starts. This process may take a few hours to complete, depending on your data volume. You receive an email notification once the Lakehouse is successfully enabled.

Next steps​

After the Lakehouse is enabled for your workspace, connect an Iceberg REST-compatible client to start querying your metadata.

  1. Get connection details: In the Marketplace, open the Atlan Lakehouse tile and select View connection details. Note the catalog URI, catalog name, and OAuth credentials to configure your client.

  2. Connect your query engine: Follow the guide for your specific engine to connect to the Lakehouse catalog: