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

A atividade Lote do Azure no Fabric Data Factory permite que você execute um comando contra uma instância do Lote do Azure. Se você está migrando para o Fabric Data Factory a partir do Azure Data Factory ou Azure Synapse, essa atividade é chamada de Atividade Personalizada.

Pré-requisitos

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

• Você deve ter acesso a um tenant do Microsoft Fabric com uma capacidade provisionada. Você pode experimentar o Fabric com uma avaliação gratuita.
• Um workspace do Fabric atribuído a essa capacidade.

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.

   

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

   

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.

Usando a identidade do espaço de trabalho do Fabric na atividade do Lote do Azure

1. Criar a identidade do espaço de trabalho

   Você deve ativar a identidade do workspace no seu espaço de trabalho (isso pode levar um tempo para carregar). Crie uma identidade de espaço de trabalho no seu espaço de trabalho Fabric. Observe que a identidade do espaço de trabalho deve ser criada no mesmo espaço de trabalho em que seu pipeline está.

   Confira a documentação sobre identidade do espaço de trabalho.

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. Conceda permissões da área de trabalho à identidade da área de trabalho

   Abra o espaço de trabalho, selecione Gerenciar acesso e atribua permissões à identidade do espaço de trabalho. 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.

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 de identidade do espaço de trabalho nas configurações de conexões não aparece em alguns casos. 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 da identidade do workspace, ou podem vê-lo, mas não conseguir 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.

Conteúdo relacionado

• Como monitorar execuções de pipeline