Edit

Kusto integration in Fabric Maps

Fabric Maps integrates with Kusto databases to let you visualize spatial data directly from KQL tables, functions, and materialized views. This integration enables near real‑time mapping scenarios, supports rich styling and filtering, and aligns Fabric Maps with the broader Real‑Time Intelligence experience in Microsoft Fabric.

With Kusto integration, you can:

  • Create map layers directly from KQL tables, functions, or materialized views.
  • Visualize continuously updating data on a map using configurable refresh intervals.
  • Apply the same styling, labeling, clustering, and filtering capabilities used by other Fabric Maps data layers.

Important

Embedded KQL querysets are deprecated for use in Fabric Maps. You can no longer create new map layers using KQL querysets or use Application Lifecycle Management (ALM) to import or export the queryset associated with a map layer, which is now no longer supported.

Existing map layers created from KQL querysets will continue to function until June 29, 2026.

To ensure continued support, migrate your existing layers to Kusto functions, which also work with ALM. For more information, see Migrate KQL Queryset to Kusto function.

Supported Kusto entities

Fabric Maps supports the following Kusto Entity types as data sources:

  • Tables – Queryable datasets stored in a KQL database. For more information, see Tables.
  • Functions – KQL functions can be either built-in or user-defined. Fabric Maps supports user-defined, stored functions that return tabular results (table or view shape). Built-in functions and nontabular functions aren't supported. For more information, see Function types and Stored functions.
  • Materialized views – Persisted query results optimized for fast, repeated access. For more information, see Materialized views

These entities appear as distinct nodes under a connected KQL database in the Explorer, making them discoverable and reusable across map layers.

Note

Database shortcuts are also supported as a data source for a Fabric Maps.

How Kusto data becomes a map layer

When you add a Kusto entity to a map, Fabric Maps treats the query result as a vector layer. You define which columns contain latitude and longitude values, and Fabric Maps renders each row as a map feature.

A configuration wizard guides you through:

  • Previewing the query results.
  • Selecting geometry columns.
  • Defining a data refresh interval.
  • Reviewing and adding the layer to the map.

Data refresh behavior

Kusto‑backed layers can refresh automatically at a configured interval. This makes them suitable for monitoring scenarios such as telemetry, device tracking, or live operational data.

Styling and interaction

Once added, Kusto layers behave like other vector layers in Fabric Maps. You can:

  • Use marker layers and custom symbols.
  • Apply data‑driven styling and labels.
  • Enable clustering.
  • Apply interactive filters to focus on subsets of the data.

Limitations

The following limitations apply to Kusto integration in Fabric Maps:

  • The result dataset size can't exceed 20 MB.
  • Only the last 100 ingested rows are displayed for Kusto tables. The Show Table feature is intended for previewing geographic distribution only. To display more detailed or complex spatial data on the map, use Functions and Materialized Views to generate aggregated or filtered results.
  • Kusto functions with parameters aren't supported.

These constraints align with existing limits for GeoJSON‑based data layers.

Next steps