Ří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.

Důležitý

Tato funkce je ve verzi Public Preview.

Přehled

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é.

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í sad prostředků Databricks nebo rozhraní REST API a 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.
Rozvoj	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 se složkou Git v pracovním prostoru ani pro nasazení Databricks Asset Bundles s prostředkem řídicího panelu ze vzdáleného umístění. Nastavte automatizaci CI/CD: Načítání aktualizací ze vzdáleného úložiště Publikování řídicích panelů po synchronizaci Nasazení balíčků prostředků Databricks po provedení aktualizace

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.