Partilhar via

Migrar blocos de anotações do Azure Synapse Analytics para o Fabric

  • Artigo

O Azure Synapse e o Fabric suportam blocos de anotações. A migração de um bloco de anotações do Azure Synapse para o Fabric pode ser feita de duas maneiras diferentes:

  • Opção 1: você pode exportar blocos de anotações do Azure Synapse (.ipynb) e importá-los para o Fabric (manualmente).
  • Opção 2: você pode usar um script para exportar blocos de anotações do Azure Synapse e importá-los para o Fabric usando a API.

Para obter considerações sobre o bloco de anotações, consulte as diferenças entre o Azure Synapse Spark e o Fabric.

Pré-requisitos

Se você ainda não tiver um, crie um espaço de trabalho de malha em seu locatário.

Opção 1: Exportar e importar o bloco de notas manualmente

Para exportar um bloco de anotações do Azure Synapse:

  1. Abra o Synapse Studio: entre no Azure. Navegue até o espaço de trabalho do Azure Synapse e abra o Synapse Studio.
  2. Localize o bloco de anotações: no Synapse Studio, localize o bloco de anotações que você deseja exportar da seção Blocos de Anotações do seu espaço de trabalho.
  3. Exportar bloco de notas:
    • Clique com o botão direito do rato no bloco de notas que pretende exportar.
    • Selecione Exportar>bloco de anotações (.ipynb).
    • Escolha uma pasta de destino e forneça um nome para o arquivo de bloco de anotações exportado.
  4. Quando a exportação estiver concluída, deverá ter o ficheiro do bloco de notas disponível para carregamento.

Captura de tela mostrando a exportação do Synapse Notebook.

Para importar o bloco de anotações exportado no Fabric:

  1. Espaço de trabalho do Access Fabric: entre no Fabric e acesse seu espaço de trabalho.
  2. Navegue até a página inicial da Engenharia de Dados: Uma vez dentro do espaço de trabalho do Fabric, vá para a página inicial da Engenharia de Dados.
  3. Importar bloco de notas:
    • Selecione Importar bloco de anotações. Você pode importar um ou mais blocos de anotações existentes do computador local para um espaço de trabalho do Fabric.
    • Procure os arquivos de bloco de anotações .ipynb que você baixou do Azure Synapse Analytics.
    • Selecione os arquivos do bloco de anotações e clique em Carregar.
  4. Abrir e usar o Bloco de Anotações: Quando a importação for concluída, você poderá abrir e usar o bloco de anotações no espaço de trabalho do Fabric.

Depois que o bloco de anotações for importado, valide as dependências do bloco de anotações:

  • Certifique-se de usar a mesma versão do Spark.
  • Se você estiver usando blocos de anotações referenciados, poderá usar msparkutils também no Fabric. No entanto, se você importar um bloco de anotações que faça referência a outro, precisará importar o último também. O espaço de trabalho de malha não suporta pastas por enquanto, portanto, quaisquer referências a blocos de anotações em outras pastas devem ser atualizadas. Você pode usar recursos do bloco de anotações, se necessário.
  • Se um bloco de anotações estiver usando bibliotecas e configurações específicas do pool, você precisará importar essas bibliotecas e/ou configurações também.
  • Serviços vinculados, conexões de fonte de dados e pontos de montagem.

Opção 2: Usar a API de malha

Siga estas etapas principais para a migração:

  • Pré-requisitos.
  • Etapa 1: Exportar blocos de anotações do Azure Synapse para o OneLake (.ipynb).
  • Etapa 2: importe blocos de anotações automaticamente para o Fabric usando a API do Fabric.

Pré-requisitos

Os pré-requisitos incluem ações que você precisa considerar antes de iniciar a migração do bloco de anotações para o Fabric.

  • Um espaço de trabalho de malha.
  • Se você ainda não tiver um, crie um Fabric lakehouse em seu espaço de trabalho.

Etapa 1: Exportar blocos de anotações do espaço de trabalho do Azure Synapse

O foco da Etapa 1 é exportar os blocos de anotações do espaço de trabalho do Azure Synapse para o OneLake no formato .ipynb. Este processo é o seguinte:

  • 1.1) Importar bloco de anotações de migração para o espaço de trabalho Fabric . Este bloco de anotações exporta todos os blocos de anotações de um determinado espaço de trabalho do Azure Synapse para um diretório intermediário no OneLake. Synapse API é usado para exportar blocos de anotações.
  • 1.2) Configure os parâmetros no primeiro comando para exportar notebooks para um armazenamento intermediário (OneLake). O trecho a seguir é usado para configurar os parâmetros de origem e destino. Certifique-se de substituí-los por seus próprios valores.
# Azure config
azure_client_id = "<client_id>"
azure_tenant_id = "<tenant_id>"
azure_client_secret = "<client_secret>"

# Azure Synapse workspace config
synapse_workspace_name = "<synapse_workspace_name>"

# Fabric config
workspace_id = "<workspace_id>"
lakehouse_id = "<lakehouse_id>"
export_folder_name = f"export/{synapse_workspace_name}"
prefix = "" # this prefix is used during import {prefix}{notebook_name}

output_folder = f"abfss://{workspace_id}@onelake.dfs.fabric.microsoft.com/{lakehouse_id}/Files/{export_folder_name}"
  • 1.3) Execute as duas primeiras células do bloco de anotações de exportação/importação para exportar blocos de anotações para o OneLake. Quando as células são concluídas, essa estrutura de pastas sob o diretório de saída intermediário é criada.

Captura de tela mostrando a exportação do Notebook no OneLake.

Etapa 2: Importar blocos de anotações para o Fabric

A etapa 2 é quando os blocos de anotações são importados do armazenamento intermediário para o espaço de trabalho Malha. Este processo é o seguinte:

  • 2.1) Valide as configurações na etapa 1.2 para garantir que o espaço de trabalho do Fabric e os valores de prefixo corretos sejam indicados para importar os notebooks.
  • 2.2) Execute a terceira célula do bloco de anotações de exportação/importação para importar todos os notebooks do local intermediário.

Conteúdos relacionados