Condividi tramite

Eseguire la migrazione di notebook da Azure Synapse Analytics a Fabric

  • Articolo

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 esportare notebook da Azure Synapse (.ipynb) e importarli in Fabric (manualmente).
  • Opzione 2: è possibile usare uno script per esportare 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 esiste ancora, creare un'area di lavoro di Fabric nel tenant.

Opzione 1: esportare e importare manualmente un 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 un notebook Synapse.

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. Passare alla home page Ingegneria dei dati: una volta all'interno dell'area di lavoro di Fabric, passare alla home page 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.
    • Cercare i file del notebook con estensione ipynb scaricati 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, convalidare le dipendenze del notebook:

  • Assicurarsi di usare la stessa versione di Spark.
  • Se si usano notebook a cui si fa riferimento, è 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 all'origine dati e punti di montaggio.

Opzione 2: 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 esiste ancora, creare un lakehouse Fabric 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) Eseguire le prime due celle del notebook da esportare/improtare per esportare i notebook in OneLake. Una volta completate le celle, viene creata questa struttura di cartelle nella directory di output intermedia.

Screenshot che mostra l'esportazione del 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