Como usar blocos de anotações do Microsoft Fabric

O notebook Microsoft Fabric é um item de código primário para o desenvolvimento de trabalhos do Apache Spark e experimentos de aprendizado de máquina. É uma superfície interativa baseada na Web usada por cientistas de dados e engenheiros de dados para escrever código, beneficiando-se de visualizações ricas e texto Markdown. Os engenheiros de dados escrevem código para ingestão de dados, preparação de dados e transformação de dados. Os cientistas de dados também usam notebooks para criar soluções de aprendizado de máquina, incluindo a criação de experimentos e modelos, rastreamento de modelos e implantação.

Com um notebook Fabric, você pode:

• Comece com zero esforço de configuração.
• Explore e processe dados facilmente com uma experiência intuitiva de baixo código.
• Mantenha os dados seguros com funcionalidades de segurança empresariais integradas.
• Analise dados em formatos brutos (CSV, txt, JSON, etc.), formatos de arquivo processados (parquet, Delta Lake, etc.), usando recursos poderosos do Spark.
• Seja produtivo com recursos de criação aprimorados e visualização de dados integrada.

Este artigo descreve como usar blocos de anotações em experiências de ciência de dados e engenharia de dados.

Criar blocos de notas

Você pode criar um novo bloco de anotações ou importar um bloco de anotações existente.

Criar um novo Notebook

Como outros processos padrão de criação de itens de malha, você pode criar facilmente um novo bloco de anotações na página inicial do Fabric Data Engineering, na opção Novo espaço de trabalho ou no Create Hub.

Importar blocos de notas existentes

Você pode importar um ou mais blocos de anotações existentes do computador local para um espaço de trabalho do Fabric na página inicial de Engenharia de Dados ou Ciência de Dados. Os blocos de anotações de malha reconhecem os arquivos .ipynb padrão do Jupyter Notebook e os arquivos de origem, como .py, .scala e .sql, e criam novos itens de bloco de anotações de acordo.

Exportar um bloco de notas

Pode exportar o seu bloco de notas para outros formatos padrão. O notebook Synapse pode ser exportado para:

• O arquivo de bloco de anotações padrão (.ipynb) usado para blocos de anotações Jupyter.
• Um ficheiro HTML (.html) que pode ser aberto diretamente a partir de um navegador.
• Um arquivo Python (.py).
• Um ficheiro Latex (.tex).

Guardar um bloco de notas

No Fabric, por padrão, um bloco de anotações salva automaticamente depois que você o abre e edita; Você não precisa se preocupar em perder alterações de código. Você também pode usar Salvar uma cópia para clonar outra cópia no espaço de trabalho atual ou para outro espaço de trabalho.

Se preferir guardar um bloco de notas manualmente, pode mudar para a opção Guardar manual para ter uma ramificação local do item do seu bloco de notas e, em seguida, utilizar Guardar ou CTRL+s para guardar as alterações.

Você também pode alternar para o modo de salvamento manual selecionando Editar ->Salvar opções ->Manual. Para ativar uma ramificação local do seu bloco de notas e, em seguida, guardá-la manualmente, selecione Guardar ou utilize o atalho de teclado Ctrl+s .

Conecte casas de lago e notebooks

Os cadernos de tecido agora suportam interações próximas com lagos; você pode facilmente adicionar uma casa de lago nova ou existente do explorador Lakehouse.

Você pode navegar para diferentes lakehouses no Lakehouse explorer e definir uma lakehouse como padrão, fixando-a. Seu padrão é então montado no diretório de trabalho do tempo de execução, e você pode ler ou gravar no lakehouse padrão usando um caminho local.

Nota

Você deve reiniciar a sessão depois de fixar uma nova lakehouse ou renomear a lakehouse padrão.

Adicionar ou remover uma casa no lago

Selecionar o ícone X ao lado do nome de uma casa de lago o remove da guia do bloco de anotações, mas o item de casa de lago ainda existe no espaço de trabalho.

Selecione Adicionar lakehouse para adicionar mais lakehouses ao bloco de anotações, adicionando uma existente ou criando uma nova lakehouse.

Explore um arquivo lakehouse

A subpasta e os arquivos na seção Tabelas e Arquivos da visualização Lago aparecem em uma área de conteúdo entre a lista lakehouse e o conteúdo do bloco de anotações. Selecione pastas diferentes na seção Tabelas e Arquivos para atualizar a área de conteúdo.

Operações de pastas e arquivos

Se você selecionar um arquivo (.csv, .parquet, .txt, .jpg, .png, etc.) com um clique direito do mouse, você pode usar a API Spark ou Pandas para carregar os dados. Uma nova célula de código é gerada e inserida abaixo da célula de foco.

Você pode facilmente copiar um caminho com um formato diferente do arquivo ou pasta de seleção e usar o caminho correspondente em seu código.

Recursos do bloco de notas

O explorador de recursos do notebook fornece um sistema de arquivos semelhante ao Unix para ajudá-lo a gerenciar suas pastas e arquivos. Ele oferece um espaço de sistema de arquivos gravável onde você pode armazenar arquivos de pequeno porte, como módulos de código, modelos semânticos e imagens. Você pode acessá-los facilmente com código no bloco de anotações como se estivesse trabalhando com seu sistema de arquivos local.

Esta pasta interna é uma pasta predefinida do sistema para cada instância do bloco de anotações. Ele preserva até 500MB de armazenamento para armazenar as dependências do notebook atual. Estas são as principais capacidades dos recursos do bloco de notas:

• Você pode usar operações comuns, como criar/excluir, carregar/baixar, arrastar/soltar, renomear, duplicar e pesquisar na interface do usuário.
• Você pode usar caminhos relativos, como builtin/YourData.txt para exploração rápida. O mssparkutils.nbResPath método ajuda você a compor o caminho completo.
• Você pode facilmente mover seus dados validados para uma casa de lago através da opção Gravar em lakehouse . O Fabric incorporou rich code snippets para tipos de arquivo comuns para ajudá-lo a começar rapidamente.
• Esses recursos também estão disponíveis para uso no caso de execução do bloco de anotações de referência via mssparkutils.notebook.run().

Nota

• Atualmente, o Fabric oferece suporte ao carregamento de determinados tipos de arquivos por meio da interface do usuário, incluindo, .py, .whl, .jar, .txt, .json, .yml, .xml, .csv, .html, .png, .jpg e arquivos .xlsx. Você pode gravar na pasta interna com tipos de arquivo que não estão na lista via código, no entanto, os blocos de anotações de malha não suportam a geração de trechos de código em tipos de arquivo não suportados.
• Cada tamanho de arquivo precisa ser inferior a 50MB, e a pasta interna permite até 100 instâncias de arquivo/pasta no total.
• Ao usar mssparkutils.notebook.run()o , use o mssparkutils.nbResPath comando para acessar o recurso do bloco de anotações de destino. O caminho relativo "builtin/" sempre apontará para a pasta interna do bloco de anotações raiz.

Colaborar num bloco de notas

O bloco de anotações Fabric é um item colaborativo que suporta vários usuários editando o mesmo bloco de anotações.

Quando abre um bloco de notas, entra no modo de coedição por predefinição e todas as edições do bloco de notas são guardadas automaticamente. Se seus colegas abrirem o mesmo bloco de anotações ao mesmo tempo, você verá o perfil, a saída da execução, o indicador do cursor, o indicador de seleção e o rastreamento de edição. Usando os recursos de colaboração, você pode facilmente realizar programação em pares, depuração remota e cenários de tutoria.

Partilhar um bloco de notas

Partilhar um bloco de notas é uma forma conveniente de colaborar com os membros da equipa. As funções de espaço de trabalho autorizadas podem exibir ou editar/executar blocos de anotações por padrão. Você pode compartilhar um bloco de anotações com as permissões especificadas concedidas.

1. Selecione Compartilhar na barra de ferramentas do bloco de anotações.

   

2. Selecione a categoria correspondente de pessoas que podem ver este bloco de notas. Você pode escolher as permissões Compartilhar, Editar ou Executar para os destinatários.

   

3. Depois de selecionar Aplicar, você pode enviar o bloco de anotações diretamente ou copiar o link para outras pessoas. Os destinatários podem então abrir o bloco de notas com a vista correspondente concedida pelo seu nível de permissão.

   

4. Para gerir ainda mais as permissões do seu bloco de notas, selecione Lista de itens>da área de trabalho Mais opções e, em seguida, selecione Gerir permissões. Nessa tela, você pode atualizar o acesso e as permissões existentes do bloco de anotações.

   

Comentar uma célula de código

Comentar é outro recurso útil para cenários colaborativos. Atualmente, o Fabric oferece suporte à adição de comentários no nível da célula.

1. Selecione o botão Comentários na barra de ferramentas do bloco de anotações ou no indicador de comentário da célula para abrir o painel Comentários .

   

2. Selecione o código na célula de código, selecione Novo no painel Comentários , adicione comentários e, em seguida, selecione Publicar comentário para salvar.

   

3. Se precisar deles, encontre as opções Editar comentário, Resolver thread e Excluir thread selecionando a opção Mais ao lado do seu comentário.

Marcar outras pessoas num comentário

"Marcação" refere-se a mencionar e notificar um usuário em um thread de comentários, aprimorando a colaboração de forma eficiente nos detalhes.

1. Selecione uma seção de código em uma célula e um novo thread de comentários.

2. Insira o nome de usuário e escolha o correto na lista de sugestões se quiser mencionar alguém para discussão sobre uma determinada seção.

3. Partilhe as suas ideias e publique-as .

4. Uma notificação por e-mail será acionada e o usuário clicará no link Abrir comentários para localizar rapidamente essa célula.

5. Além disso, autorize e configure as permissões para usuários ao marcar alguém que não tem acesso, garantindo que seus ativos de código sejam bem gerenciados.

Nota

Para um item de comentário, o usuário marcado não receberá mais uma notificação por e-mail se você atualizar o comentário dentro de uma hora. Mas ele enviará uma notificação por e-mail para o novo usuário marcado.

Alternar o modo de bloco de notas

Os blocos de anotações de malha suportam dois modos entre os quais você pode alternar facilmente: Modo de edição e Modo de visualização .

• Modo de edição: pode editar e executar as células e colaborar com outras pessoas no bloco de notas.
• Modo de visualização: só pode ver o conteúdo da célula, a saída e os comentários do bloco de notas. Todas as operações que fazem alterações no bloco de anotações são desabilitadas.

Conteúdos relacionados

• Criar e executar cadernos