Transformar dados executando um bloco de anotações

Use a atividade de Notebooks para executar notebooks que criar no Microsoft Fabric nos pipelines do Data Factory. Os blocos de anotações permitem que você execute trabalhos do Apache Spark para trazer, limpar ou transformar seus dados como parte de seus fluxos de trabalho de dados. É fácil adicionar uma atividade do Bloco de Anotações aos seus pipelines no Fabric, e este guia orienta você em cada etapa.

Pré-requisitos

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

• Uma conta de locatário com uma assinatura ativa. Crie uma conta gratuitamente.
• Um espaço de trabalho é criado.
• Um bloco de anotações é criado em seu espaço de trabalho. Para criar um novo bloco de anotações, consulte Como criar blocos de anotações do Microsoft Fabric.

Criar uma atividade do bloco de notas

1. Crie um novo pipeline em seu espaço de trabalho.

2. Procure Bloco de Anotações no painel Atividades do pipeline e selecione-o para adicioná-lo à tela do pipeline.

   

3. Selecione a nova atividade do Bloco de Anotações na tela se ela ainda não estiver selecionada.

   

   Consulte as orientações de configurações gerais para configurar a guia Configurações gerais.

Configurar definições do notebook

Selecione a guia Configurações .

Em Conexão, selecione o método de autenticação para a execução do caderno e forneça as credenciais necessárias ou a configuração de identidade com base na sua escolha:

• Service Principal (SPN) – Recomendado para cenários de produção para garantir execução segura e automatizada sem depender das credenciais do utilizador.
• Identidade de Espaço de Trabalho (WI) – Ideal para ambientes geridos onde é necessária uma governação centralizada de identidades.

Selecione um Notebook existente na lista suspensa e, opcionalmente, especifique parâmetros a serem passados para o notebook.

Utilização da Identidade do Espaço de Trabalho do Fabric (WI) na atividade do Notebook

1. Criar a Identidade do Espaço de Trabalho Deve ativar o WI no seu espaço de trabalho (isto pode demorar algum tempo a carregar). Crie uma Identidade de Espaço de Trabalho no seu espaço de trabalho Fabric. Consulta a documentação sobre o Workspace Identity.

2. Ativar definições ao nível do inquilino No portal de administração do Fabric, ative a seguinte definição de inquilino: Os princípios de serviço podem chamar APIs públicas do Fabric. Esta configuração é necessária para que a Identidade do Espaço de Trabalho se autentique com sucesso. Consulta a documentação sobre Ativar autenticação do principal de serviço para APIs de administrador.

3. Conceder permissões de espaço de trabalho à Identidade do Espaço de Trabalho Abra o espaço de trabalho, selecione Gerir acesso e atribua permissões à Identidade do Espaço de Trabalho. O acesso dos colaboradores é suficiente para a maioria dos cenários. Consulta a documentação sobre Dar acesso aos utilizadores aos espaços de trabalho.

Definir tag de sessão

Para minimizar o tempo necessário para executar o trabalho do bloco de anotações, você pode, opcionalmente, definir uma tag de sessão. A configuração da tag session instrui o Spark a reutilizar qualquer sessão existente do Spark, minimizando o tempo de inicialização. Qualquer valor de cadeia de caracteres arbitrário pode ser usado para a tag session. Se nenhuma sessão existir, uma nova será criada usando o valor da tag.

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 para salvar seu pipeline. Selecione Executar para executá-lo diretamente ou Agendar para agendá-lo. Você também pode visualizar o histórico de execução aqui ou definir outras configurações.

Conteúdos relacionados

• Como monitorar execuções de pipeline