Usar a atividade KQL para executar uma consulta

A atividade KQL no Data Factory for Microsoft Fabric permite executar uma consulta no Kusto Query Language (KQL) em uma instância do Azure Data Explorer.

Pré-requisitos

Para começar, você deve preencher os seguintes pré-requisitos:

Adicionar uma atividade KQL a um pipeline com a interface de utilizador

Para usar uma atividade KQL num pipeline, conclua as seguintes etapas:

Criação da atividade

  1. Crie um novo pipeline em seu espaço de trabalho.

  2. Procure por KQL no painel Atividades do pipeline e selecione-o para adicioná-lo ao painel do pipeline.

    Nota

    Talvez seja necessário expandir o menu e rolar para baixo para ver a atividade do KQL, conforme destacado na captura de tela abaixo.

    Captura de ecrã da interface do utilizador do Fabric com o painel Atividades e a atividade KQL realçados.

  3. Selecione a nova atividade KQL na tela do editor de pipeline se ela ainda não estiver selecionada.

    Captura de tela mostrando a guia Configurações gerais da atividade KQL.

Consulte a orientação de definições Gerais para configurar o separador Definições Gerais.

Configurações de atividade do KQL

  1. Selecione a guia Configurações e, em seguida, selecione sua conexão com o Banco de Dados KQL na lista suspensa ou crie uma nova. Caso selecione um repositório de dados do espaço de trabalho, poderá usar conteúdo dinâmico para parametrizar a seleção do banco de dados ao selecionar a opção Adicionar conteúdo dinâmico que aparece na lista de opções suspensas.

  2. Em seguida, forneça uma consulta KQL para executar no banco de dados selecionado da propriedade Command. Você pode usar conteúdo dinâmico na consulta selecionando o link Adicionar conteúdo dinâmico que aparece quando a caixa de texto é selecionada.

    Captura de tela mostrando a guia Configurações da atividade KQL destacando a propriedade Command e mostrando onde o link Adicionar conteúdo dinâmico aparece.

  3. Finalmente, especifique um tempo limite de comando ou deixe o tempo limite padrão de 20 minutos. Você também pode usar conteúdo dinâmico para essa propriedade.

Guardar e executar ou agendar o pipeline

A atividade KQL normalmente pode ser usada com outras atividades. Depois de configurar todas as outras atividades necessárias para o seu pipeline, pode guardá-lo, executá-lo ou agendá-lo.

Altere para o separador Início no topo do editor de pipeline e selecione o botão de guardar para salvar o seu pipeline. Selecione Executar para executar diretamente ou Agendar para agendar corridas em horários ou intervalos específicos. Para obter mais informações sobre execuções de pipeline, consulte: agendar execuções de pipeline.

Captura de tela mostrando a guia Página Inicial no editor de pipeline com os botões Nome da guia, Salvar, Executar e Agendar realçados.

Depois de executar, podes monitorizar a execução do pipeline e ver o histórico de execuções a partir do separador Output abaixo da tela.

Limitações conhecidas

  • Limitação de implementação entre espaços de trabalho: Quando um pipeline contendo uma atividade KQL é implementado entre espaços de trabalho usando pipelines de implementação, as propriedades do serviço ligado específicas do espaço de trabalho não são mapeadas novamente e continuam a referenciar o espaço de trabalho de origem. Isto pode fazer com que as execuções de pipeline no workspace de destino falhem com UserErrorKustoReadFailed / EntityNotFoundException.

A solução alternativa é usar variáveis de espaço de trabalho (Biblioteca de Variáveis) para todas as propriedades de ligação específicas do espaço de trabalho e referencia-as via endpointVariableLibrary, artefactIdVariableLibrary e workspaceIdVariableLibrary.

Conteúdos relacionados

  • Last updated on