Edit

Share via


Enable Eventhouse endpoint for lakehouse

The Eventhouse endpoint for lakehouse is a powerful capability in Microsoft Fabric that enables users to query Lakehouse tables with exceptional speed and ease.

Use the Eventhouse endpoint to query lakehouse data, discover real-time insights across your data estate, and streamline analysis of structured, semi-structured, and unstructured data.

Benefits

Enable the Eventhouse endpoint to get:

  • Instant schema sync: The endpoint syncs tables and schema changes within seconds with no manual setup. See the list of sync statuses.
  • Mirrored schema: Access current and future Lakehouse data through a mirrored schema in a dedicated KQL database view.
  • Rich consumption and visualization options: Use Copilot, NL2KQL, dashboards, embedded queries, and visual data exploration.
  • Reflected in Workspace and OneLake catalog trees: The endpoint eventhouse and database appear as new branches in your lakehouse tree.
  • Fast, scalable queries: Run analytics in KQL or SQL using advanced table operators and commands.
  • Advanced insights: Run time series analysis, detect anomalies, and use Python for advanced processing.

After you enable the endpoint, it tracks the source lakehouse data and optimizes it for Eventhouse-like performance and flexibility. Each lakehouse table is attached to a OneLake shortcut in the Eventhouse endpoint with Query acceleration policies that optimize the source data.

Performance

Use the Eventhouse endpoint immediately after you create it. The first queries can run more slowly while the service caches data. Within 10 seconds, the endpoint is fully synced. As more data is cached, the query performance improves. You can check the sync status on the System Overview or Databases page, and check the status for each Shortcut. See sync statuses.

Permissions

Users with contributor or owner permission on the parent data source get contributor permission on the Eventhouse endpoint. They can manage cache and retention settings.

Sharing

To be able to share the endpoint, configure share settings for both the Eventhouse endpoint, the KQL database, and the Lakehouse source data.

Prerequisites

  • A workspace in a capacity with Microsoft Fabric enabled
  • A Lakehouse with tables in your workspace or in your OneLake catalog

Enable the Eventhouse endpoint

After you enable the endpoint, it appears as a child item of the Lakehouse in both the workspace and the OneLake catalog.

  1. Select the Lakehouse you want to query. You can enable the Eventhouse endpoint from your Fabric workspace, your OneLake catalog, or from the Lakehouse ribbon.

    • From your Fabric Workspace, browse to the Lakehouse, and from the more options menu ... select Eventhouse endpoint.

      Screenshot of enabling the Eventhouse endpoint from the Workspace.

    • From the OneLake catalog, browse to the Lakehouse, and from the more options menu ... select Eventhouse endpoint.

      Screenshot of enabling the Eventhouse endpoint from the OneLake catalog.

    • From the OneLake catalog, select the Lakehouse, and from the Lakehouse toolbar select Analyze Data > Eventhouse endpoint.

      Screenshot of enabling the Eventhouse endpoint from the Lakehouse ribbon.

  2. The Eventhouse Endpoint opens with a welcome message. Select Close to view and start querying the Eventhouse.

    Screenshot of the welcome message for the Eventhouse endpoint.

The new Eventhouse endpoint has these characteristics:

  • The Eventhouse is named Eventhouse Endpoint and is read-only.
  • The KQL database is named <Lakehouse_Name>_EventhouseEndpoint.
  • The embedded KQL queryset is named <Lakehouse_Name>_EventhouseEndpoint_queryset.
  • Shortcuts reference OneLake tables.
    • Query each shortcut directly by using the table function.
    • If the lakehouse has multiple schemas, the schema name shows in each shortcut name. For example, if the schemas are sales and marketing and each has a table named customers, the shortcuts are sales_customers and marketing_customers.

The workspace and the OneLake catalog show the endpoint and the KQL database as child items of the Lakehouse.

Screenshot of the Eventhouse endpoint and KQL database as child items of the Lakehouse in the OneLake catalog.

Query the Eventhouse endpoint

From the Eventhouse endpoint, run queries, create visualizations, and perform advanced analytics using KQL or SQL.

Screenshot of the KQL queryset with a get table schema query.

Disable the Eventhouse endpoint

Remove the Eventhouse endpoint from the workspace or the OneLake catalog. The Eventhouse endpoint and the KQL database are deleted. The Lakehouse remains unchanged.

  1. Open the Fabric workspace.

  2. Browse to the Eventhouse Endpoint branch of the Lakehouse tree, and from the more options menu ... select Delete.

    Screenshot of the Lakehouse tree with the more options menu open and Delete highlighted.

  3. In the confirmation dialog, select Delete.

Re-enable the Eventhouse endpoint

If you delete the Eventhouse endpoint, you can re-enable it at any time. The new endpoint creates a new Eventhouse and KQL database. The new database doesn't retain any previous queries, visualizations, or dashboards. If you try to re-enable the endpoint while the previous endpoint is still being deleted, you see a message to wait a few seconds. After the previous endpoint is deleted, you can re-enable it.

Message stating that the endpoint is being deleted and to wait a few seconds.

Sync statuses

The Eventhouse endpoint syncs the source Lakehouse tables and schema changes within seconds. The sync status is displayed in the System Overview and databases page, and in each table shortcut. Here's an example of a sync status:

Screenshot showing the sync status in the System Overview and databases page.

Sync statuses for the Eventhouse endpoint:

Sync status Desription
synced All OneLake shortcuts are synchronized. Source link: {link}
workInProgress Synchronization in progress. ${syncing} of ${total} OneLake shortcuts are currently syncing. Some OneLake shortcuts are still warming up. Source link: {link}
warmingUp Eventhouse endpoint is warming up. More than 50% of some OneLake shortcuts are warming up. The system is aligning with the source engine. Source link: {link}

Sync statuses for shortcut:

Sync status Desription
synced This shortcut is fully synchronized. Over 98% of the data is in sync with the source. Source link: {link}
workInProgress Synchronization is underway. Between 20% and 98% of the data is currently synced with the source. Source link: {link}
warmingUp Synchronization is in progress. Less than 20% of the data is currently synced with the source. Source link: {link}

Considerations and limitations

  • You can't currently enable the Eventhouse endpoint from within an open lakehouse.
  • The System overview page of the Eventhouse endpoint doesn't show any statistics.
  • Updates to the Eventhouse endpoint cache policy aren't supported
  • Changing the source table schema won't be reflected at the Eventhouse endpoint.