Instrumentpaneler för versionskontroll med Git

Den här sidan beskriver hur du använder Databricks Git-mappar för utveckling av versionskontroll och samarbetsinstrumentpaneler. Den beskriver också hur du implementerar CI/CD-processer för att utveckla och distribuera instrumentpaneler på olika arbetsytor.

Viktig

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Överblick

Databricks Git-mappar spårar ändringar och historik för instrumentpanelen, supportteamets samarbete och gör att du kan distribuera instrumentpaneler till produktion och återställa tidigare versioner.

Aktivera källkontroll för instrumentpanelen

Arbetsyteadministratörer kan styra arbetsytans åtkomst till den offentliga förhandsversionen från sidan Förhandsversioner. Som standard är förhandsversionen av instrumentpaneler för support i Git-mappen På (Aktiverad) .

Så här fungerar Git-integrering med instrumentpaneler

Databricks Git-mappar spårar och hanterar ändringar i utkastdashboards. Instrumentpanelsutkastet återspeglar alla ändringar i en spårad instrumentpanel. Git spårar inte publicerings- och schemaläggningskonfigurationer, till exempel val av lager och schemaskapande. Om du vill hantera dessa konfigurationer använder du användargränssnittet eller automatiserar ändringar med Databricks-tillgångspaket eller AI/BI REST API.

• Information om hur du använder paket för instrumentpanelshantering finns på instrumentpanelen.
• Information om hur du publicerar och schemalägger instrumentpaneler med REST-API:et finns i Referens för Lakeview API.

Anmärkning

Lakeview-API:et använder det tidigare namnet för AI/BI-instrumentpaneler.

Databricks Git-mappar hanterar vanliga Git-åtgärder för instrumentpaneler och andra arbetsyteobjekt. Mer information finns i Azure Databricks Git-mappar.

Tillämpa källkontroll på instrumentpaneler

Placera instrumentpanelerna i en Databricks Git-mapp för att spåra dem med Git. Använd något av följande alternativ:

• Nya instrumentpaneler: Skapa instrumentpanelen i en befintlig Databricks Git-mapp för att tillämpa källkontroll från början.
• Befintliga instrumentpaneler: Flytta en befintlig instrumentpanel till en Databricks Git-mapp för att spåra den med Git.

Hantera behörigheter för källkontrollerade instrumentpaneler

Behörigheter på mappnivå gäller för alla objekt i mappen, inklusive instrumentpaneler. Instrumentpaneler i en Git-mapp ärver den överordnade mappens behörigheter utöver alla instrumentpanelsspecifika behörigheter. De flesta Git-åtgärder kräver behörigheten CAN MANAGE. Mer information finns i Mapp-ACL:er och Git-mapp-ACL:er.

Rekommenderat arbetsflöde för utveckling

Klona lagringsplatsen till din egen Databricks Git-mapp, använd funktionsgrenar och skicka pull-begäranden. I följande tabell beskrivs hur du använder Git-mappar för att hantera instrumentpaneler under olika faser av utveckling och distribution.

Viktig

Att byta Git-grenar kan orsaka problem för dashboards. Azure Databricks tar bort instrumentpaneler som inte finns på målgrenen. Om du växlar tillbaka visas instrumentpaneler igen med nya URL:er och ID:n, vilket bryter publicerade länkar, bokmärken och API-integrationer. Kontrollera målgrenen innan du växlar, och uppdatera sedan alla referenser.

Projektfas	Arbetsflöde	Förväntat resultat	Kända begränsningar
Inledande commit	Flytta instrumentpanelen till en Git-mapp på arbetsytan. Utför commit och pusha till fjärr-Git-repositoriet.	Git spårar instrumentpanelen på en fjärrlagringsplats.
Utveckling	Utvecklare skapar Git-mappar på separata utvecklingsgrenar, vanligtvis i sina hemmappar. Genomför ändringar i utvecklingsgrenen. Sammanfoga utvecklingsgrenar till huvudgrenar med hjälp av pull-begäranden.	Utvecklare arbetar oberoende av varandra. Git spårar dashboardversioner.	Instrumentpanelsfiler använder JSON format. SQL-frågor visas som en enda rad, vilket kan göra det svårt att granska dem i pull-begäranden.
Deployment	Skapa en Git-mapp på grenen för distribution i en överordnad mapp som inte är för användare. Se CI/CD med Databricks Git-kataloger. Hämta ändringar i distributionsmappen. Publicera instrumentpaneler från den här mappen. Ta bort redigering+ åtkomst och begränsa uppdateringar till Git. Dela instrumentpaneler med konsumenter.	Konsumenter får åtkomst till en konsekvent, publicerad version av instrumentpanelen. Du kan dela instrumentpaneler i samma mapp med olika målgrupper.	Databricks ger inte inbyggt stöd för synkronisering av en fjärrgren med en Git-mapp på arbetsytan eller distribution av Databricks-tillgångspaket med en instrumentpanelsresurs från fjärranslutning. Konfigurera CI/CD-automatisering för att automatisera: Hämta uppdateringar från fjärrlagringsplatsen. Publicera dashboards efter synkronisering. Distribuera Databricks-tillgångspaket efter en uppdatering.

Mer metodtips för samarbete i Databricks Git-mappar finns i Samarbeta med Git-mappar.

Begränsningar

Källkontroll med AI/BI-instrumentpaneler har följande begränsningar:

• Du kan committa högst 100 dashboards i en enda Git-mapp. Den här gränsen kan ändras under den offentliga förhandsversionen.
• Git-baserade jobb, till exempel jobb som refererar till Git-URL:er i stället för arbetsytans tillgångs-ID eller sökvägar, fungerar inte med instrumentpaneler.
• Instrumentpanelens serialisering genererar långa strängar, vilket gör det svårt att läsa och granska skillnader under pull-begäranden.
• Instrumentpanelens filformat ändras regelbundet för att inkludera nya fält och andra förbättringar. Under den offentliga förhandsversionen kan dessa ändringar visas som skillnader i Git som du inte initierade.