Eseguire la migrazione di notebook da Azure Synapse Analytics a Fabric

Azure Synapse e Fabric supportano i notebook. La migrazione di un notebook da Azure Synapse a Fabric può essere eseguita in due modi diversi:

  • Opzione 1: è possibile usare Migration Assistant per eseguire la migrazione di notebook da Azure Synapse a Fabric usando un'esperienza più guidata e semplificata.
  • Opzione 2: è possibile esportare i notebook da Azure Synapse (con estensione ipynb) e importarli in Fabric (manualmente).
  • Opzione 3: è possibile usare uno script per esportare i notebook da Azure Synapse e importarli in Fabric usando l'API.

Per le considerazioni sui notebook, vedere le differenze tra Azure Synapse Spark e Fabric.

Prerequisiti

Se non ne hai già uno, crea un workspace Fabric nel tuo tenant.

Opzione 1: Usare Assistente migrazione

È possibile usare l'assistente migration per la migrazione da Azure Synapse a Fabric. È progettato per offrire un'esperienza guidata e semplificata per la migrazione di notebook e risorse correlate.

Opzione 2: Esportare e importare manualmente il notebook

Per esportare un notebook da Azure Synapse:

  1. Aprire Synapse Studio: accedere ad Azure. Passare all'area di lavoro di Azure Synapse e aprire Synapse Studio.
  2. Individuare il notebook: in Synapse Studio, individuare il notebook da esportare dalla sezione Notebook dell'area di lavoro.
  3. Esportare un notebook:
    • Fare clic con il pulsante destro del mouse sul notebook da esportare.
    • Selezionare Esporta>Notebook (.ipynb).
    • Scegliere una cartella di destinazione e specificare un nome per il file del notebook esportato.
  4. Una volta completata l’esportazione, il file del notebook dovrebbe essere disponibile per il caricamento.

Screenshot che mostra l'esportazione di Synapse Notebook.

Per importare il notebook esportato in Fabric:

  1. Accedere all'area di lavoro di Fabric: accedere a Fabric e accedere all'area di lavoro.
  2. Passa alla home page di Ingegneria dei dati: una volta nell'area di lavoro Fabric, passa alla home page di Ingegneria dei dati.
  3. Importare un notebook:
    • Selezionare Importa notebook. È possibile importare uno o più notebook esistenti dal computer locale a un'area di lavoro di Fabric.
    • Individua i file notebook .ipynb che hai scaricato da Azure Synapse Analytics.
    • Selezionare i file del notebook e fare clic su Carica.
  4. Aprire e usare il notebook: una volta completata l'importazione, è possibile aprire e usare il notebook nell'area di lavoro di Fabric.

Una volta importato il notebook, verificane le dipendenze:

  • Assicurarsi di usare la stessa versione di Spark.
  • Se si utilizzano notebook referenziati, è possibile usare msparkutils anche in Fabric. Tuttavia, se si importa un notebook che fa riferimento a un altro notebook, è necessario importare anche quest'ultimo. L'area di lavoro di Fabric per ora non supporta cartelle, quindi tutti i riferimenti ai notebook in altre cartelle devono essere aggiornati. Se necessario, è possibile usare le risorse del notebook.
  • Se un notebook usa librerie e configurazioni specifiche del pool, è necessario importare anche tali librerie e/o configurazioni.
  • Servizi collegati, connessioni alle origini dati e punti di montaggio.

Opzione 3: Usare l'API Fabric

Seguire questi passaggi chiave per la migrazione:

  • Prerequisiti.
  • Passaggio 1: esportare notebook da Azure Synapse a OneLake (.ipynb).
  • Passaggio 2: importare i notebook automaticamente in Fabric usando l'API Fabric.

Prerequisiti

I prerequisiti includono azioni che è necessario prendere in considerazione prima di avviare la migrazione del notebook in Fabric.

  • Un’area di lavoro Fabric.
  • Se non ne hai già uno, creare un Fabric lakehouse nell'area di lavoro.

Passaggio 1: esportare notebook dall'area di lavoro di Azure Synapse

L'obiettivo del passaggio 1 è l'esportazione dei notebook dall'area di lavoro di Azure Synapse in OneLake in formato .ipynb. Questo processo avviene come indicato di seguito:

  • 1.1) Importare il notebook da migrare nell'area lavoro di Fabric. Questo notebook esporta tutti i notebook da una determinata area di lavoro di Azure Synapse in una directory intermedia in OneLake. L'API Synapse viene usata per esportare i notebook.
  • 1.2) Configurare i parametri nel primo comando per esportare i notebook in un archivio intermedio (OneLake). Il frammento di codice seguente viene usato per configurare i parametri di origine e destinazione. Assicurarsi di sostituirli con i propri valori.
# 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) Esegui le prime due celle del notebook di esportazione/importazione per esportare i notebook su OneLake. Una volta completate le celle, viene creata questa struttura di cartelle nella directory di output intermedia.

Screenshot che mostra l'esportazione di notebook in OneLake.

Passaggio 2: importare notebook in Fabric

Il passaggio 2 avviene quando i notebook vengono importati dall'archiviazione intermedia nell'area di lavoro di Fabric. Questo processo avviene come indicato di seguito:

  • 2.1) Convalidare le configurazioni nel passaggio 1.2 per assicurarsi che siano indicati i valori corretti per l'area di lavoro di Fabric e il prefisso per importare i notebook.
  • 2.2) Eseguire la terza cella del notebook da esportare/importare per importare tutti i notebook dalla posizione intermedia.

Contenuto correlato

  • Last updated on