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

Databricks and Google BigQuery don't yet support querying external Iceberg REST catalogs natively. To use Lakehouse with these engines, you can set up foreign or external Iceberg tables that point to your Lakehouse metadata. Step-by-step setup scripts are available in the Lakehouse Solutions repository. Follow the setup guides in the repository to get started.

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:

  3. Query with AI agents: To query Lakehouse using natural language, install the atlan-lakehouse agent skill for Claude Code or other AI agents.