Migrujte poznámkové bloky z Azure Synapse Analytics do Fabric

Azure Synapse a Fabric podporují poznámkové bloky. Migrace poznámkového bloku z Azure Synapse do Fabricu lze provést dvěma různými způsoby:

  • Možnost 1: Pomocí pomocníka pro migraci můžete migrovat poznámkové bloky z Azure Synapse na Fabric s využitím efektivnějšího a řízeného prostředí.
  • Možnost 2: poznámkové bloky můžete exportovat z Azure Synapse (.ipynb) a importovat je do Fabricu (ručně).
  • Možnost 3: Pomocí skriptu můžete exportovat poznámkové bloky z Azure Synapse a importovat je do Fabric pomocí rozhraní API.

Informace týkající se poznámkových bloků najdete v článku Rozdíly mezi Azure Synapse Spark a Fabric.

Požadavky

Pokud ještě nemáte pracovní prostor Fabric, vytvořte ho ve vašem tenantovi.

Možnost 1: Použití pomocníka pro migraci

K migraci z Azure Synapse do Fabric můžete použít pomocníka migration. Je navržená tak, aby poskytovala řízené a zjednodušené prostředí pro migraci poznámkových bloků a souvisejících prostředků.

Možnost 2: Ruční export a import poznámkového bloku

Export poznámkového bloku z Azure Synapse:

  1. Otevřete Synapse Studio: Přihlaste se do Azure. Přejděte do svého pracovního prostoru Azure Synapse a otevřete Synapse Studio.
  2. Vyhledejte poznámkový blok: Ve funkci Synapse Studio vyhledejte poznámkový blok, který chcete exportovat z oddílu Poznámkové bloky vašeho pracovního prostoru.
  3. Exportovat poznámkový blok:
    • Klikněte pravým tlačítkem na poznámkový blok, který chcete exportovat.
    • Vyberte Export>Notebook (.ipynb).
    • Zvolte cílovou složku a zadejte název exportovaného souboru poznámkového bloku.
  4. Po dokončení exportu byste měli mít k dispozici soubor poznámkového bloku pro nahrání.

Screenshot ukazující export ze Synapse notebooku.

Importovat exportovaný poznámkový blok ve Fabric:

  1. Přístup k pracovnímu prostoru Fabric: Přihlaste se do Fabric a získejte přístup ke svému pracovnímu prostoru.
  2. Přejděte na domovskou stránku Data Engineering: Jakmile budete v pracovním prostoru Fabric, přejděte na domovskou stránku Data Engineering.
  3. Import poznámkového bloku:
    • Vyberte Importovat poznámkový blok. Do pracovního prostoru Fabric můžete importovat jeden nebo více existujících poznámkových bloků z místního počítače.
    • Vyhledejte soubory poznámkového bloku .ipynb, které jste stáhli z Azure Synapse Analytics.
    • Vyberte soubory poznámkového bloku a klikněte na Nahrát.
  4. Otevřete a používejte zápisník: Po dokončení importu můžete notebook otevřít a použít ve svém pracovním prostoru Fabric.

Po importu poznámkového bloku ověřte závislosti poznámkového bloku:

  • Ujistěte se, že používáte stejnou verzi Sparku.
  • Pokud používáte odkazované poznámkové bloky, můžete také ve Fabric použít msparkutils. Pokud ale naimportujete poznámkový blok, který odkazuje na jiný poznámkový blok, musíte ho také importovat. Pracovní prostor Fabric zatím nepodporuje složky, takže je potřeba aktualizovat veškeré odkazy na poznámkové bloky v jiných složkách. V případě potřeby můžete použít prostředky poznámkového bloku.
  • Pokud poznámkový blok používá knihovny a konfigurace specifické pro daný pool, musíte importovat také tyto knihovny a/nebo konfigurace.
  • Propojené služby, připojení ke zdroji dat a přípojné body.

Možnost 3: Použití rozhraní API Fabric

Při migraci postupujte podle těchto klíčových kroků:

  • Požadavky.
  • Krok 1: Export poznámkových bloků z Azure Synapse do OneLake (.ipynb).
  • Krok 2: Importujte poznámkové bloky automaticky do Fabricu pomocí rozhraní Fabric API.

Požadavky

Předpoklady zahrnují kroky, které je potřeba zvážit před zahájením migrace poznámkových bloků do Fabric.

  • Pracovní prostor Fabric.
  • Pokud ho ještě nemáte, vytvořte v pracovním prostoru Fabric lakehouse.

Krok 1: Export poznámkových bloků z pracovního prostoru Azure Synapse

Cílem kroku 1 je exportovat poznámkové bloky z pracovního prostoru Azure Synapse do OneLake ve formátu .ipynb. Tento proces je následující:

  • 1.1) Importujte migrační poznámkový blok do pracovního prostoru Fabric Tento poznámkový blok exportuje všechny poznámkové bloky z daného pracovního prostoru Azure Synapse do zprostředkujícího adresáře ve OneLake. K exportu poznámkových bloků se používá rozhraní Synapse API.
  • 1.2) Nakonfigurujte parametry v prvním příkazu pro export poznámkových bloků do zprostředkujícího úložiště (OneLake). Následující fragment kódu slouží ke konfiguraci zdrojových a cílových parametrů. Nezapomeňte je nahradit vlastními hodnotami.
# 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) Spusťte první dvě buňky poznámkového bloku pro export a import a vyexportujte poznámkové bloky do OneLake. Po dokončení buněk se vytvoří tato struktura složek v zprostředkujícím výstupním adresáři.

Snímek obrazovky s exportem poznámkového bloku ve OneLake

Krok 2: Import poznámkových bloků do Fabric

Krok 2 je, když se poznámkové bloky importují z přechodného úložiště do pracovního prostoru Fabric. Tento proces je následující:

  • 2.1) Ověřte konfigurace z kroku 1.2 a ujistěte se, že jsou pro import notebooků uvedeny správné hodnoty pracovního prostoru Fabric a předpony.
  • 2.2) Spusťte třetí buňku poznámkového bloku exportu/importu a importujte všechny poznámkové bloky z mezilehlého umístění.