Sdílet prostřednictvím


Migrace poznámkových bloků z Azure Synapse Analytics do prostředků infrastruktury

Poznámkové bloky podporují Azure Synapse a Prostředky infrastruktury. Migraci poznámkového bloku z Azure Synapse do prostředků infrastruktury je možné provést dvěma různými způsoby:

  • Možnost 1: Poznámkové bloky můžete exportovat z Azure Synapse (.ipynb) a importovat je do prostředků infrastruktury (ručně).
  • Možnost 2: Pomocí skriptu můžete exportovat poznámkové bloky z Azure Synapse a importovat je do prostředků infrastruktury pomocí rozhraní API.

Důležité informace o poznámkových blocích najdete v rozdílech mezi Azure Synapse Sparkem a prostředky infrastruktury.

Požadavky

Pokud ho ještě nemáte, vytvořte ve svém tenantovi pracovní prostor Fabric.

Možnost 1: 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. Export poznámkového bloku:
    • Klikněte pravým tlačítkem na poznámkový blok, který chcete exportovat.
    • Vyberte Exportovat>poznámkový blok (.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í.

Snímek obrazovky znázorňující export poznámkového bloku Synapse

Import exportovaného poznámkového bloku v prostředcích infrastruktury:

  1. Přístup k pracovnímu prostoru Prostředky infrastruktury: Přihlaste se k Prostředkům infrastruktury a získejte přístup k pracovnímu prostoru.
  2. Přejděte na Datoví technici domovské stránky: Jakmile budete v pracovním prostoru Fabric, přejděte na Datoví technici domovskou stránku.
  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žijte poznámkový blok: Po dokončení importu můžete poznámkový blok otevřít a použít v pracovním prostoru Prostředky infrastruktury.

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 použít také nástroje msparkutils v prostředcích infrastruktury. 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 by se měly aktualizovat žádné 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 fond, musíte tyto knihovny nebo konfigurace také importovat.
  • Propojené služby, připojení ke zdroji dat a přípojné body.

Možnost 2: Použití rozhraní FABRIC API

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: Automatické importování poznámkových bloků do prostředků infrastruktury pomocí rozhraní FABRIC API

Požadavky

Požadavky zahrnují akce, které je potřeba zvážit před zahájením migrace poznámkového bloku do prostředků infrastruktury.

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) Import poznámkového bloku migrace 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 prostředků infrastruktury

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 v kroku 1.2 a ujistěte se, že jsou pro import poznámkových bloků označené správné hodnoty pracovního prostoru Fabric a předpony.
  • 2.2) Spusťte třetí buňku poznámkového bloku pro export a import a importujte všechny poznámkové bloky z zprostředkujícího umístění.