Správa formátu poznámkového bloku
Tento článek popisuje výchozí formát poznámkového bloku v Azure Databricks, jak změnit formát poznámkového bloku a jak spravovat potvrzení, pokud je poznámkový blok ve složce řízené zdrojem.
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 Export a import 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 poznámkového bloku má vliv na to, jaké výstupy se potvrdí do vzdáleného úložiště, jak je popsáno v table níže.
Zdrojový formát poznámkového bloku | Podrobnosti |
---|---|
zdroj | 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 ). Formát IPYNB (Jupyter) umožňuje uživateli volitelně potvrdit výstupy. IPYNB také podporuje lepší prostředí pro prohlížení poznámkových bloků Databricks ve vzdálených úložištích Git. |
K rozlišení poznámkových bloků Databricks od běžných souborů Python, Scala a SQL přidá Azure Databricks komentář "Databricks notebook source
" do horní části poznámkových bloků Pythonu, Scaly a SQL. Tento komentář zajišťuje, že Azure Databricks soubor správně parsuje jako poznámkový blok místo souboru skriptu.
Poznámka
Co jsou "výstupy"?
Výstupy jsou výsledky spuštění notebooku na platformě Databricks, zahrnující zobrazení a vizualizace table.
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 v Azure Databricks.
Pokud chcete změnit výchozí formát zdroje Azure Databricks, přihlaste se k pracovnímu prostoru Azure Databricks, klikněte na svůj profil v pravém horním rohu stránky a potom klikněte na Nastavení a přejděte na Vývojář. 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:
Otevřete poznámkový blok v pracovním prostoru.
Select Soubor z nabídky pracovního prostoru, poté selectformát poznámkového blokua 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 naleznete v Export a import poznámkových bloků Databricks.
Správa potvrzení výstupu poznámkového bloku IPYNB
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. Ve výchozím nastavení nastavení správy složek Git neumožňuje potvrzení výstupu poznámkového bloku .ipynb
. Pokud máte oprávnění správce pro pracovní prostor, můžete toto nastavení změnit:
V konzole pro správu Azure Databricks přejděte na nastavení správce >nastavení pracovního prostoru.
V části složky Gitzvolte Povolit složkám Gitu exportovat výstupy IPYNB a pak selectPovolit: Výstupy IPYNB lze zapnout.
Důležitý
Když se zahrnou výstupy, vizualizace a konfigurace řídicích panelů se 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
.
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.V dialogovém okně oznámení selectvytvořit soubor commit_outputs.
Také můžete generate konfigurační soubory z nabídky Soubor . Nabídka Soubor má ovládací prvek, který umožňuje automaticky update konfigurační soubor where, abyste mohli zadat zahrnutí nebo vyloučení výstupů pro konkrétní poznámkový blok IPYNB.
V nabídce FileselectPotvrdit výstupy poznámkových bloků
Editor poznámkových bloků
V dialogovém okně potvrďte, že chcete potvrdit výstupy poznámkového bloku.