Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Notebook Utilities (NotebookUtils) é um pacote interno que ajuda a executar facilmente tarefas comuns no Fabric Notebook. Você pode usar o NotebookUtils para trabalhar com sistemas de arquivos, obter variáveis de ambiente, encadear notebooks e trabalhar com segredos. O pacote NotebookUtils está disponível no PySpark (Python) Scala, notebooks do SparkR e pipelines do Fabric.
Note
- O MsSparkUtils é renomeado oficialmente para NotebookUtils. O código existente permanece compatível com versões anteriores e não causa alterações significativas. É altamente recomendável atualizar para notebookutils para garantir o suporte contínuo e o acesso a novos recursos. O namespace mssparkutils será desativado no futuro.
- O NotebookUtils foi projetado para funcionar com o Spark 3.4 (Runtime v1.2) e superior. Todos os novos recursos e atualizações têm suporte exclusivo com o namespace notebookutils daqui para frente.
Módulos NotebookUtils
O NotebookUtils fornece os módulos a seguir. Selecione um módulo para ver a documentação detalhada, os exemplos de código e as práticas recomendadas.
| Módulo | Namespace | Descrição |
|---|---|---|
| Utilitários do sistema de arquivos | notebookutils.fs |
Trabalhe com arquivos e diretórios no ADLS Gen2, no Armazenamento de Blobs do Azure e no Armazenamento do Lakehouse. Inclui operações de cópia, movimentação, leitura, gravação, exclusão e lista. |
| Montagem e desmontagem de arquivos | notebookutils.fs |
Anexe o armazenamento remoto (ADLS Gen2) aos nós do Spark como pontos de montagem locais para acesso simplificado a arquivos. |
| Execução e orquestração do notebook | notebookutils.notebook |
Execute e encadeie notebooks simultaneamente, incluindo execução paralela com suporte a DAG, referências entre diferentes workspaces e valores de retorno. |
| Gerenciamento de bloco de anotações | notebookutils.notebook |
Crie, obtenha, atualize, exclua e liste artefatos de notebook programaticamente. |
| Utilitários de credenciais | notebookutils.credentials |
Obtenha tokens de acesso para os serviços do Azure e recupere segredos do Azure Key Vault. |
| Utilitários Lakehouse | notebookutils.lakehouse |
Crie, obtenha, atualize, exclua e gerencie itens e tabelas do Lakehouse programaticamente. |
| Contexto de runtime | notebookutils.runtime |
Acesse informações de contexto de sessão, incluindo nome do bloco de anotações, detalhes do workspace e contexto de execução. |
| Gerenciamento de sessão | notebookutils.session |
Interrompa as sessões interativas e reinicie o interpretador do Python. |
| Utilitários da UDF (Função de Dados do Usuário) | notebookutils.udf |
Obter e invocar Funções de Dados de Usuário de notebooks. |
| Utilitários de biblioteca de variáveis | notebookutils.variableLibrary |
Acesse variáveis gerenciadas centralmente e a configuração de 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 acima da 1.2 e em execução
notebookutils.help(), as APIs fabricClient e PBIClient listadas ainda não têm suporte, mas estarão disponíveis em uma versão futura.