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. Depois de configurar outras atividades necessárias para o pipeline, você pode salvar e executar ou agendar o pipeline.

Alterne para a guia Página Inicial na parte superior do editor de pipeline e selecione o botão Salvar. Selecione Executar para executá-lo diretamente ou Agendar para agendar execuções em intervalos ou horários específicos. Para obter mais informações sobre execuções de pipeline, consulte: cronograma de execuções de pipeline.

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.

Depois de executar, você pode monitorar a execução do pipeline e exibir o histórico de execução na guia Saída abaixo da tela.

Limitações conhecidas

  • Limitação de implantação entre workspaces: Quando um pipeline que contém uma atividade KQL é implantado entre workspaces usando pipelines de implantação, as propriedades de serviço vinculado específicas do workspace não são remapeadas e continuam a referenciar o workspace de origem. Isso 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 workspace (Biblioteca de Variáveis) para todas as propriedades de conexão específicas do workspace e referenciá-las por meio de endpointVariableLibrary, artifactIdVariableLibrary e workspaceIdVariableLibrary.

Conteúdo relacionado

  • Last updated on