Správa formátu poznámkového bloku Databricks

Ve výchozím nastavení se poznámkové bloky v Databricks vytvářejí ve formátu .ipynb (IPython nebo Jupyter). Místo toho můžete použít zdrojový formát.

Poznámkové bloky můžete nadále importovat a exportovat v různých formátech. Viz Import a export poznámkových bloků Databricks.

formáty poznámkového bloku

Databricks podporuje vytváření a úpravy poznámkových bloků ve dvou formátech: IPYNB (výchozí) a zdroj.

Zdrojové soubory, včetně poznámkových bloků, můžete spravovat pomocí složek Git. Jen některé typy prostředků Databricks jsou podporovány ve složkách Gitu. Formát ovlivňuje způsob, jakým se poznámkové bloky zapisují do vzdálených úložišť, jak je popsáno v následující tabulce.

Zdrojový formát notebooku	Popis
odeslat k provedení	Základní formát, který zachycuje pouze zdrojový kód s příponou, která signalizuje jazyk kódu, například .py, .scala, .r a .sql.
IPYNB (Jupyter)	Bohatý formát, který zachycuje zdrojový kód, prostředí poznámkového bloku, definice vizualizací, widgety poznámkových bloků a volitelné výstupy. Poznámkový blok IPYNB může obsahovat kód v libovolném jazyce podporovaném poznámkovými bloky Databricks (i přes část py z .ipynb). Pomocí formátu IPYNB můžete volitelně verzovat výstup poznámkového bloku společně s poznámkovým blokem.

Formát IPYNB také podporuje lepší prostředí pro prohlížení poznámkových bloků Databricks ve vzdálených úložištích Git. Pokud používáte GitHub nebo GitLab, můžete povolit funkce, které poskytují vylepšené rozdíly poznámkových bloků ve změnových žádostech, což usnadňuje prohlížení změn v poznámkovém bloku a přezkoumání kódu.

Další informace o podpoře GitHub pro bohaté rozdíly poznámkových bloků IPYNB najdete v tématu Feature Preview: Rich Jupyter Notebook Diffs. Další informace o podpoře poznámkových bloků IPYNB v GitLabu najdete v tématu Jupyter Notebook soubory.

Pokud chcete odlišit poznámkové bloky zdrojového formátu od běžných souborů Python, Scala a SQL, Azure Databricks přidá do horní části poznámkových bloků Python, Scala a SQL komentář "Databricks notebook source". Tento komentář zajistí, že Azure Databricks soubor správně parsuje jako poznámkový blok, nikoli jako soubor skriptu.

Změna výchozího nastavení formátu poznámkového bloku

Poznámkové bloky IPYNB jsou výchozím formátem při vytváření nového poznámkového bloku na Azure Databricks.

Pokud chcete změnit výchozí formát zdroje Azure Databricks, přihlaste se do pracovního prostoru Azure Databricks, v pravém horním rohu stránky klikněte na svůj profil a potom klikněte na Settings a přejděte na Developer. Změňte výchozí formát sešitu pod nadpisem nastavení Editoru .

Převod formátu poznámkového bloku

Existující poznámkový blok můžete převést do jiného formátu prostřednictvím uživatelského rozhraní Azure Databricks.

Převod existujícího poznámkového bloku do jiného formátu:

1. Otevřete poznámkový blok v pracovním prostoru.

2. V nabídce pracovního prostoru vyberte Soubor , vyberte Formát poznámkového bloku a zvolte požadovaný formát. Můžete zvolit Jupyter (.ipynb) (doporučeno) nebo zdroj (.scala, .py, .sql, .r). Aktuální formát poznámkového bloku je zobrazený šedě a má vedle něj značku zaškrtnutí.

   

Další informace o typech poznámkových bloků podporovaných v Azure Databricks najdete v tématu Import a export poznámkových bloků Databricks.

Správa záznamů výstupu poznámkového bloku IPYNB

Výstupy jsou výsledky spuštění poznámkového bloku na platformě Databricks, včetně zobrazení tabulek a vizualizací. U poznámkových bloků IPYNB ve zdrojových složkách můžete spravovat, jak se výstupy poznámkového bloku zapisují do vzdáleného úložiště.

Povolit potvrzení výstupu poznámkového bloku .ipynb

Výstupy je možné potvrdit pouze v případě, že tuto funkci povolil správce pracovního prostoru. Výchozí nastavení pro správu složek Git nedovoluje potvrzení výstupu z poznámkových bloků. Pokud máte oprávnění správce pro pracovní prostor, můžete toto nastavení změnit:

1. Klikněte na své uživatelské jméno v horním panelu pracovního prostoru Azure Databricks a vyberte Nastavení.

2. V sekci Administrátor pracovního prostoru, klikněte na Vývoj.

3. V sekci Repos nastavte Povolit repos exportovat výstup IPYNB na Povolit: výstupy IPYNB lze přepnout na zapnuto.

   

Důležitý

Při zahrnutí výstupů se vizualizace a konfigurace řídicích panelů zahrnou do .ipynb poznámkových bloků, které vytvoříte.

Správa potvrzení výstupních artefaktů souboru poznámkového bloku IPYNB

Konfigurační .databricks/commit_outputs soubor ve vašem repozitáři řídí, které .ipynb výstupy notebooku se commitují. Poté, co správce pracovního prostoru povolí výstupní commity, můžete tento soubor vytvořit v dialogu Gitu:

1. Otevřete dialogové okno Git pro složku Git, která obsahuje soubor .ipynb notebooku, ale žádný soubor .databricks/commit_outputs.

2. V informačním upozornění nahoře v dialogu klikněte na Vytvořit commit_outputs konfigurační soubor.

   

Můžete také použít nabídku File k zahrnutí nebo vyloučení výstupů pro konkrétní poznámkový blok IPYNB. Pokud konfigurační soubor neexistuje, Azure Databricks jej vytvoří při výběru. Použijte tuto možnost, pokud jste upozornění v dialogu Git zavřeli.

1. V menu Soubor vyberte Commit notebook outputs. Položka menu je dostupná pouze pro IPYNB zápisníky ve složce Git, poté co správce pracovního prostoru povolí výstupní commity.

   Editor poznámkových bloků

2. V konfiguračním dialogu Konfigurace výstupů odevzdání vyberte Zahrnout výstupy nebo Vyloučit výstupy a poté klikněte na Změnit.