Řídicí panely správy verzí pomocí Gitu

Tato stránka vysvětluje, jak používat složky Git Databricks pro správu verzí a vývoj řídicích panelů pro spolupráci. Popisuje také, jak implementovat procesy CI/CD pro vývoj a nasazení řídicích panelů v různých pracovních prostorech.

Přehled

Tato funkce je ve verzi Public Preview.

Složky Gitu Databricks sledují změny a historii řídicích panelů, podporu týmové spolupráce a umožňují nasadit řídicí panely do produkčního prostředí a obnovit předchozí verze.

Zapnout ovládání zdrojového kódu na řídicím panelu

Správci pracovních prostorů můžou řídit přístup k verzi Public Preview ze stránky Preview. Ve výchozím nastavení jsou řídicí panely podpory ve složce Git ve verzi Preview zapnuté.

Alternativní: Ruční správa verzí

Pokud nemůžete povolit verzi Public Preview, ke sledování verzí řídicího panelu použijte následující ruční pracovní postup:

1. Exportujte řídicí panel jako soubor JSON. Formát souboru je lvdash.json. Pokyny k exportu najdete v tématu Export, import nebo nahrazení řídicího panelu .
2. Přidejte tento soubor do systému správy verzí, jako je Git.
3. Upravte soubor. Hodnoty v textovém souboru můžete upravovat přímo nebo je nahrát zpět do pracovního prostoru a provádět změny v uživatelském rozhraní.
4. Uložte nový soubor. Pokud jste v uživatelském rozhraní provedli změny, exportujte nový soubor. Pomocí systému správy verzí můžete sledovat změny a verze řídicího panelu.
5. Aktualizujte existující řídicí panel. Z návrhu existujícího řídicího panelu:
   1. Klikněte na v pravém horním rohu a potom klikněte na Nahradit nástěnku.
   2. V dialogovém okně Nahradit řídicí panel klikněte na Zvolit soubor. Potom klikněte na Přepsat.

Jak funguje integrace Gitu s řídicími panely

Složky Gitu Databricks sledují a spravují změny konceptů řídicích panelů. Návrh řídicího panelu zahrnuje všechny změny ve sledovaném řídicím panelu. Git nesleduje konfigurace publikování a plánování, jako je výběr skladu a vytvoření plánu. Ke správě těchto konfigurací použijte uživatelské rozhraní nebo automatizujte změny pomocí deklarativních automatizačních sad nebo rozhraní REST API AI/BI.

• Pokud chcete použít sady pro správu řídicích panelů, přečtěte si řídicí panel.
• Pokud chcete publikovat a plánovat řídicí panely pomocí rozhraní REST API, přečtěte si referenční informace k rozhraní API Lakeview .

Poznámka:

Rozhraní API Lakeview používá předchozí název pro řídicí panely AI/BI.

Složky Gitu Databricks spravují běžné operace Gitu pro řídicí panely a další objekty pracovního prostoru. Další informace najdete ve složkách Git v Azure Databricks.

Použití správy zdrojového kódu na řídicí panely

Pokud chcete sledovat řídicí panely pomocí Gitu, umístěte je do složky Git Databricks. Použijte jednu z následujících možností:

• Nové řídicí panely: Vytvořte řídicí panel v existující složce Databricks Git, abyste mohli použít správu zdrojového kódu od začátku.
• Existující řídicí panely: Přesuňte existující řídicí panel do složky Git Databricks, abyste ho mohli sledovat pomocí Gitu.

Správa oprávnění pro řídicí panely řízené zdrojem

Oprávnění na úrovni složky platí pro všechny objekty v této složce, včetně řídicích panelů. Řídicí panely ve složce Git dědí oprávnění nadřazené složky kromě oprávnění specifických pro řídicí panel. Většina operací Git vyžaduje oprávnění CAN MANAGE. Další informace najdete v tématech Seznamy ACL složek a seznamy ACL složek Gitu.

Doporučený pracovní postup vývoje

Naklonujte úložiště do vlastní složky Git Databricks, použijte větve funkcí a odešlete žádosti o přijetí změn. Následující tabulka popisuje, jak pomocí složek Git spravovat řídicí panely během různých fází vývoje a nasazení.

Důležité

Přepínání větví Gitu je destruktivní operace pro řídicí panely. Azure Databricks odebere řídicí panely, které v cílové větvi neexistují. Pokud přepnete zpátky, řídicí panely se znovu zobrazí s novými adresami URL a ID, které přeruší publikované odkazy, záložky a integrace rozhraní API. Před přepnutím a následnou aktualizací všech odkazů ověřte cílovou větev.

Fáze projektu	Workflow	Očekávaný výsledek	Známá omezení
Počáteční potvrzení	Přesuňte řídicí panel do složky Git v pracovním prostoru. Proveďte commit a pushněte do vzdáleného úložiště Git.	Git sleduje řídicí panel ve vzdáleném úložišti.
Vývoj	Vývojáři vytvářejí složky Gitu na samostatných vývojových větvích, obvykle ve svých domovských složkách. Potvrďte změny ve vývojové větvi. Sloučení vývojových větví do hlavního pomocí pull requestů.	Vývojáři pracují nezávisle. Git sleduje verze dashboardu.	Soubory řídicího panelu používají JSON formát. Dotazy SQL se zobrazují jako jeden řádek, což může ztěžovat kontrolu pull requestů.
Nasazení	Vytvořte složku Git ve větvi nasazení ve složce nejvyšší úrovně, která není uživatelská. Viz CI/CD se složkami Git Databricks. Přetáhněte změny do složky nasazení. Publikujte řídicí panely z této složky. Odeberte přístup pro úpravy a omezte aktualizace na Git. Sdílejte řídicí panely se spotřebiteli.	Uživatelé mají přístup k konzistentní a publikované verzi řídicího panelu. Řídicí panely můžete sdílet ve stejné složce s různými cílovými skupinami.	Databricks neposkytuje integrovanou podporu pro synchronizaci vzdálené větve s Git složkou ve workspace ani pro nasazení declarativních automatizačních balíků s prostředkem řídicího panelu na dálku. Nastavte automatizaci CI/CD: Načítání aktualizací ze vzdáleného úložiště Publikování řídicích panelů po synchronizaci Nasazení deklarativních balíčků automatizace po aktualizaci

Další osvědčené postupy pro spolupráci ve složkách Databricks Git najdete v tématu Spolupráce pomocí složek Git.

Omezení

Správa zdrojového kódu s řídicími panely AI/BI má následující omezení:

• Do jednoho Git adresáře je možné uložit maximálně 100 nástěnek. Tento limit se může během verze Public Preview změnit.
• Úlohy založené na Git, jako jsou úlohy odkazující na adresy URL Git místo ID prostředků pracovního prostoru nebo cest, nejsou kompatibilní s řídicími panely.
• Serializace řídicího panelu generuje dlouhé řetězce, což ztěžuje čtení a kontrolu rozdílů během pull requestů.
• Formát souboru řídicího panelu se pravidelně mění tak, aby zahrnoval nová pole a další vylepšení. Během veřejného náhledu se tyto změny můžou zobrazovat jako rozdíly v Gitu, které jste nezačali.