Migrar o conjunto de consultas KQL para a função Kusto

A partir de março de 2026, o Fabric Mapas não dá mais suporte a conjuntos de consultas KQL como uma fonte de dados para criar camadas de mapa. Para continuar usando dados Kusto em mapas, você deve criar novas camadas com base em funções KQL.

Este artigo explica como migrar uma camada de mapa existente que foi criada de uma consulta KQL para uma nova camada apoiada por uma função KQL e como configurar a camada migrada para visualização nos Mapas do Fabric. Para obter uma visão geral das fontes de dados Kusto com suporte, consulte a integração do Kusto no Fabric Maps. Para obter informações sobre como criar novas camadas de uma fonte de dados do Kusto, consulte Criar camadas usando dados kusto.

Observação

As camadas existentes criadas a partir de uma consulta KQL continuarão funcionando até 29 de junho de 2026. Para evitar interrupções de serviço, migre essas consultas para funções Kusto como descrito neste artigo.

Pré-requisitos

Antes de começar, verifique se:

• Você tem acesso a um banco de dados KQL no Microsoft Fabric.
• Você tem permissão para criar e editar mapas no Fabric.

Migrar uma consulta KQL para uma função Kusto

Para simplificar a migração de um conjunto de consultas KQL inserido, converta a consulta em uma função Kusto e atualize a camada de mapa para referenciar essa função.

Consulta original

O exemplo a seguir mostra uma consulta KQL usada em uma camada de mapa existente:

SourceTable
| where timestamp > ago(1d)

Criar uma função Kusto

No banco de dados KQL, crie uma função que encapsula a lógica de consulta:

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

Uma nova função armazenada definida pelo usuário é criada no nó Functions do banco de dados KQL. Você usará essa função na próxima etapa para criar uma nova camada de mapa.

Adicionar uma nova camada de dados da função Kusto

Depois de migrar a consulta KQL inserida para uma função Kusto, crie uma nova camada de mapa que use a função como sua fonte de dados.

1. Crie uma nova camada de dados da função Kusto seguindo as etapas em Criar camadas usando dados Kusto.
2. Defina a geometria da camada, as configurações de atualização e qualquer estilo ou formatação necessário.
3. Verifique se a nova camada é renderizada corretamente no mapa.

Depois que a nova camada for configurada e validada, você poderá remover a camada de mapa existente que foi originada do conjunto de consultas KQL inserido.

A camada de mapa agora faz referência a uma entidade Kusto com suporte, permitindo que ela continue funcionando à medida que os conjuntos de consultas KQL forem preteridos.