Compartilhar via

Usar a atividade KQL para executar uma consulta

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 novo pipeline no seu ambiente de trabalho.

  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 a 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 repositório de dados de área de trabalho, poderá usar conteúdo dinâmico para configurar a seleção do banco de dados, escolhendo 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 a aba Configurações da atividade do KQL realçando a propriedade de Comando 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ê 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

  • Last updated on