Compartilhar via

Usar a atividade KQL para executar uma consulta

  • Artigo

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

Pré-requisitos

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

Adicionar uma atividade KQL a um pipeline com a interface do usuário

Para usar uma atividade KQL em um pipeline, siga estas etapas:

Criando a atividade

  1. Crie um pipeline no seu workspace.

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

    Observação

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

    Captura de tela da interface do usuário do Fabric com o painel de Atividades e a atividade do 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 o guia Configurações gerais da atividade do KQL.

Consulte as diretrizes de Configurações Geraispara definir a guia Configurações Gerais.

Configurações de atividades KQL

  1. Selecione o guia Configurações e, em seguida, selecione a conexão do Banco de Dados KQL na lista suspensa ou crie uma nova. Se você selecionar um armazenamento de dados do workspace, poderá usar o conteúdo dinâmico para parametrizar a seleção do banco de dados, selecionando a opção Adicionar conteúdo dinâmico que aparece na lista suspensa.

  2. Em seguida, forneça uma consulta KQL para executar no banco de dados selecionado para a 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 o guia Configurações da atividade do KQL realçando a propriedade Comando e mostrando onde seu link Adicionar conteúdo dinâmico é exibido.

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

Salvar e executar ou agendar o pipeline

A atividade KQL normalmente pode ser usada com outras atividades. Após configurar quaisquer outras atividades exigidas pelo pipeline, alterne para a guia Página Inicial na parte superior do editor do 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 exibir o histórico de execuções aqui ou definir outras configurações.

Captura de tela mostrando a guia Início no editor de pipeline com o nome da guia e os botões Salvar, Executar e Agendar realçados.

Conteúdo relacionado