Partilhar via


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 quaisquer outras atividades necessárias para o pipeline, alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar para salvar o pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode visualizar o histórico de execução aqui ou definir outras configurações.

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.