Migración del conjunto de consultas KQL a la función Kusto

A partir de marzo de 2026, Fabric Maps ya no admite conjuntos de consultas KQL como origen de datos para crear capas de mapa. Para seguir usando datos de Kusto en mapas, debe crear nuevas capas basadas en funciones KQL.

En este artículo se explica cómo migrar una capa de mapa existente creada a partir de una consulta KQL a una nueva capa respaldada por una función KQL y cómo configurar la capa migrada para su visualización en Fabric Maps. Para obtener información general sobre los orígenes de datos de Kusto admitidos, consulte Integración de Kusto en Fabric Maps. Para obtener información sobre cómo crear nuevas capas a partir de un origen de datos de Kusto, consulte Creación de capas mediante datos de Kusto.

Nota:

Las capas existentes creadas a partir de una consulta KQL seguirán funcionando hasta el 29 de junio de 2026. Para evitar interrupciones del servicio, migre estas consultas a funciones de Kusto como se describe en este artículo.

Prerrequisitos

Antes de comenzar, asegúrese de que:

• Tiene acceso a una base de datos KQL en Microsoft Fabric.
• Tiene permiso para crear y editar mapas en Fabric.

Migración de una consulta KQL a una función de Kusto

Para simplificar la migración desde un conjunto de consultas KQL incrustado, convierta la consulta en una función kusto y actualice la capa de mapa para hacer referencia a esa función.

Consulta original

En el ejemplo siguiente se muestra una consulta KQL usada en una capa de mapa existente:

SourceTable
| where timestamp > ago(1d)

Crea una función Kusto

En la base de datos KQL, cree una función que encapsula la lógica de consulta:

.create-or-alter function resultFromOneDay() {
    SourceTable
    | where timestamp > ago(1d)
}

Se crea una nueva función almacenada definida por el usuario en el nodo Functions de la base de datos KQL. Usará esta función en el paso siguiente para crear una nueva capa de mapa.

Adición de una nueva capa de datos desde la función Kusto

Después de migrar la consulta KQL incrustada a una función de Kusto, cree una nueva capa de mapa que use la función como origen de datos.

1. Cree una nueva capa de datos a partir de la función Kusto siguiendo los pasos descritos en Creación de capas mediante datos de Kusto.
2. Configure la geometría de la capa, los valores de actualización y cualquier estilo o formato necesarios.
3. Compruebe que la nueva capa se representa correctamente en el mapa.

Una vez configurada y validada la nueva capa, puede quitar la capa de mapa existente que se originó desde el conjunto de consultas KQL incrustado.

La capa de mapa ahora hace referencia a una entidad Kusto compatible, lo que le permite seguir funcionando mientras los conjuntos de consultas KQL se van quedando obsoletos.