Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O Notebook Utilities (NotebookUtils) é um pacote integrado para ajudá-lo a executar facilmente tarefas comuns no Fabric Notebook. Você pode usar NotebookUtils para trabalhar com sistemas de arquivos, para obter variáveis de ambiente, para encadear blocos de anotações e para trabalhar com segredos. O pacote NotebookUtils está disponível em notebooks PySpark (Python), Scala, SparkR e pipelines Fabric.
Note
- MsSparkUtils é oficialmente renomeado para NotebookUtils. O código existente mantém-se compatível com versões anteriores e não causa alterações graves. É fortemente recomendado atualizar para notebookutils para garantir suporte contínuo e acesso a novas funcionalidades. O namespace mssparkutils será desativado no futuro.
- O NotebookUtils foi concebido para funcionar com o Spark 3.4 (Runtime v1.2) e superiores. Todas as funcionalidades novas e atualizações serão suportadas exclusivamente pelo espaço de nomes notebookutils daqui para a frente.
Módulos NotebookUtils
O NotebookUtils fornece os seguintes módulos. Selecione um módulo para ver documentação detalhada, exemplos de código e boas práticas.
| Módulo | Namespace | Descrição |
|---|---|---|
| Utilitários do sistema de ficheiros | notebookutils.fs |
Trabalhar com ficheiros e diretórios em ADLS Gen2, Azure Blob Storage e Lakehouse storage. Inclui operações de copiar, mover, ler, escrever, eliminar e listar. |
| Montagem e desmontagem de ficheiros | notebookutils.fs |
Anexar armazenamento remoto (ADLS Gen2) aos nós Spark como pontos de montagem locais para facilitar o acesso a ficheiros. |
| Orquestração e execução do notebook | notebookutils.notebook |
Executar e encadear notebooks, permitindo também execução em paralelo com suporte a DAG, referências entre diferentes espaços de trabalho e valores de saída. |
| Gestão de cadernos | notebookutils.notebook |
Criar, obter, atualizar, eliminar e listar artefactos de cadernos de forma programática. |
| Utilitários de credenciais | notebookutils.credentials |
Obtenha tokens de acesso para os serviços Azure e recupere segredos do Azure Key Vault. |
| Utilitários do Lakehouse | notebookutils.lakehouse |
Criar, obter, atualizar, eliminar e gerir os itens e tabelas do Lakehouse de forma programática. |
| Contexto de execução | notebookutils.runtime |
Acede à informação do contexto da sessão, incluindo nome do caderno, detalhes do espaço de trabalho e contexto de execução. |
| Gestão de sessões | notebookutils.session |
Pare as sessões interativas e reinicie o interpretador em Python. |
| Utilitários da Função de Dados do Utilizador (UDF) | notebookutils.udf |
Recuperar e invocar Funções de Dados de Utilizador a partir de cadernos. |
| Utilitários de biblioteca variável | notebookutils.variableLibrary |
Aceda a variáveis e configurações geridas centralmente a partir dos itens da Biblioteca de Variáveis. |
Para obter uma visão geral de todos os módulos e métodos disponíveis, execute:
notebookutils.help()
Para obter ajuda para um módulo específico, execute:
notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()
Problemas conhecidos
- Ao usar a versão de runtime superior à 1.2 e a correr
notebookutils.help(), as APIs fabricClient e PBIClient listadas ainda não são suportadas, mas estarão disponíveis numa versão futura.