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. Přejděte na nastavení Admin>Nastavení pracovního prostoru v konzole pro správu Azure Databricks.

2. V části složky Gitzvolte Povolit složkám Git exportovat výstupy IPYNB a pak vyberte Povolit: Výstupy IPYNB lze přepínat.

   

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

Když potvrdíte .ipynb soubor, Databricks vytvoří konfigurační soubor, který vám umožní řídit způsob potvrzení výstupů: .databricks/commit_outputs.

1. Pokud máte soubor poznámkového bloku .ipynb, ale ve vzdáleném úložišti nemáte žádný konfigurační soubor, přejděte do dialogového okna Stav Gitu.

2. V dialogovém okně oznámení vyberte Vytvořit konfigurační soubor commit_outputs.

   

Konfigurační soubory můžete také vygenerovat z nabídky Soubor. Nabídka Soubor má funkci pro automatickou aktualizaci konfiguračního souboru, kde můžete zadat zahrnutí nebo vyloučení výstupů pro konkrétní poznámkový blok IPYNB.

1. V nabídce File (Soubor) vyberte Potvrdit výstupy poznámkových bloků.

   Editor poznámkových bloků

2. V dialogovém okně potvrďte, že chcete potvrdit výstupy poznámkového bloku.