Use a atividade do Lote do Azure para executar um comando em uma instância do Lote do Azure

A atividade do Lote do Azure no Data Factory para o Microsoft Fabric permite que você execute um comando em uma instância do Lote do Azure. Se você estiver migrando para o Fabric Data Factory do ADF ou do Synapse, essa atividade será chamada de atividade personalizada.

Pré-requisitos

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

Adicionar uma atividade Lote do Azure a um pipeline usando a interface do usuário

Para usar uma atividade do Lote do Azure em um pipeline, conclua as seguintes etapas:

Criar a atividade

  1. Crie uma nova linha de processamento em seu espaço de trabalho.

  2. Pesquise pelo Lote do Azure no painel Atividades do pipeline e selecione-o para adicioná-lo à tela do pipeline.

    Nota

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

    Captura de tela da interface do usuário do Fabric com o painel Atividades e a atividade Lote do Azure realçadas.

  3. Selecione a nova atividade do Lote do Azure na superfície do editor de pipeline, se ela ainda não estiver selecionada.

    Captura de tela que mostra a guia Configurações gerais da atividade do Lote do Azure.

Consulte as diretrizes de Configurações gerais para definir a guia de configurações Gerais.

Configurações de atividade do Lote do Azure

Selecione a guia Configurações e você poderá escolher uma conexão existente ou criar uma Conexão do Lote do Azure, fornecer um Comando a ser executado e uma Conexão de recurso com uma conta de armazenamento. Você também pode especificar um Caminho de pasta específico dentro da conta de armazenamento e um Tempo de retenção em dias para que os dados sejam mantidos lá, bem como adicionar suas próprias propriedades estendidas.

A atividade Lote do Azure dá suporte a tipos de conexão WI, SPN e OAuth.

Captura de tela mostrando a guia Configurações da atividade do Lote do Azure.

Usando a Identidade do Workspace do Fabric na atividade do Lote do Azure

  1. Criar a identidade do Workspace

    Você deve habilitar a WI em seu workspace (isso pode levar um momento para ser carregado). Crie uma Identidade de Espaço de Trabalho no espaço de trabalho do Fabric. Observe que a WI deve ser criada no mesmo ambiente de trabalho que o Pipeline.

    Confira a documentação sobre a Identidade do Workspace.

  2. Habilitar configurações no nível do locatário

    Habilite a seguinte configuração de locatário (está desabilitada por padrão): Principais de serviço podem chamar APIs públicas do Fabric.

    Você pode habilitar essa configuração no portal de administração do Fabric. Para obter mais informações sobre essa configuração, consulte o artigo sobre a habilitação da autenticação do principal de serviço para APIs administrativas.

  3. Conceder permissões de workspace à Identidade do Workspace

    Abra o workspace, selecione Gerenciar acesso e atribua permissões à Identidade do Workspace. O acesso de colaborador é suficiente para a maioria das situações.

    Confira a documentação em Conceder aos usuários acesso aos workspaces.

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 Home 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.

Problemas conhecidos

  • A opção WI nas configurações de conexões não aparece em algumas instâncias. Esse é um bug no qual uma correção está sendo trabalhada no momento.
  • Usar um Principal de Serviço para executar um notebook que contém código de Link Semântico tem limitações funcionais e oferece suporte apenas a um subconjunto de recursos de Link Semântico. Consulte as funções de link semântico com suporte para obter detalhes. Para usar outros recursos, é recomendável autenticar manualmente o link semântico com um principal de serviço.
  • Alguns clientes podem não ver o menu suspenso de Identidade do Workspace (WI) ou podem vê-lo, mas não conseguem criar uma conexão. Esse comportamento ocorre devido a um problema conhecido em um de nossos componentes de plataforma subjacentes. A correção está sendo trabalhada atualmente.