Udostępnij przez

Pulpity nawigacyjne kontroli wersji za pomocą usługi Git

Na tej stronie wyjaśniono, jak używać folderów Git usługi Databricks do kontroli wersji i wspólnego tworzenia pulpitów nawigacyjnych. Opisywane jest, jak implementować procesy ciągłej integracji i ciągłego wdrażania w celu tworzenia i wdrażania pulpitów nawigacyjnych w różnych miejscach pracy.

Ważny

Ta funkcja jest dostępna w publicznej wersji testowej.

Przegląd

Foldery Git Databricks śledzą zmiany i historię pulpitów nawigacyjnych, wspierają współpracę zespołową i umożliwiają wdrażanie pulpitów nawigacyjnych do środowiska produkcyjnego oraz odzyskiwanie poprzednich wersji.

Włączanie kontroli źródła pulpitu nawigacyjnego

Administratorzy obszaru roboczego mogą kontrolować dostęp obszaru roboczego do publicznej wersji zapoznawczej ze strony Podglądów. Domyślnie podgląd pulpitów nawigacyjnych pomocy technicznej w folderze Git jest włączony.

Jak działa integracja usługi Git z pulpitami nawigacyjnymi

Foldery Git w Databricks śledzą i zarządzają zmianami roboczych pulpitów nawigacyjnych. Wersja robocza pulpitu nawigacyjnego odzwierciedla wszystkie zmiany na śledzonym pulpicie nawigacyjnym. Usługa Git nie śledzi konfiguracji publikowania i planowania, takich jak wybór magazynu i tworzenie harmonogramu. Aby zarządzać tymi konfiguracjami, użyj interfejsu użytkownika lub zautomatyzuj zmiany w pakietach zasobów usługi Databricks lub interfejsie API REST AI/BI.

  • Aby użyć pakietów do zarządzania pulpitami nawigacyjnymi, zobacz pulpit nawigacyjny.
  • Aby opublikować i zaplanować pulpity nawigacyjne za pomocą interfejsu API REST, zobacz dokumentację interfejsu API Lakeview.

Uwaga

Interfejs API Lakeview używa wcześniejszej nazwy dla pulpitów nawigacyjnych AI/BI.

Foldery Git usługi Databricks zarządzają typowymi operacjami usługi Git dla pulpitów nawigacyjnych i innych obiektów obszaru roboczego. Aby dowiedzieć się więcej, zobacz Foldery Git usługi Azure Databricks.

Stosowanie kontroli źródła do pulpitów nawigacyjnych

Aby śledzić pulpity nawigacyjne za pomocą usługi Git, umieść je w folderze Databricks Git. Użyj jednej z następujących opcji:

  • Nowe panele kontrolne: Utwórz panel kontrolny w istniejącym folderze Git dla usługi Databricks, aby zastosować kontrolę wersji od początku.
  • Istniejące pulpity nawigacyjne: Przenieś istniejący pulpit nawigacyjny do folderu Git Databricks, aby śledzić go w Git.

Zarządzanie uprawnieniami dla pulpitów nawigacyjnych kontrolowanych przez źródło

Uprawnienia na poziomie folderu mają zastosowanie do wszystkich obiektów w tym folderze, w tym pulpitów nawigacyjnych. Pulpity nawigacyjne w folderze Git dziedziczą uprawnienia folderu nadrzędnego oprócz wszystkich uprawnień specyficznych dla pulpitu nawigacyjnego. Większość operacji usługi Git wymaga uprawnienia CAN MANAGE. Aby dowiedzieć się więcej, zobacz Listy ACL folderów i listy ACL folderów Git.

Sklonuj repozytorium do własnego folderu Git w Databricks, użyj gałęzi funkcyjnych i zgłoś pull requesty. W poniższej tabeli przedstawiono sposób używania folderów Git do zarządzania pulpitami nawigacyjnymi w różnych fazach programowania i wdrażania.

Ważny

Przełączanie gałęzi Git to operacja destrukcyjna dla pulpitów nawigacyjnych. Usługa Azure Databricks usuwa dashboardy, które nie istnieją w gałęzi docelowej. W przypadku przełączenia z powrotem, pulpity nawigacyjne pojawią się ponownie z nowymi adresami URL i identyfikatorami, co powoduje, że dotychczas opublikowane linki, zakładki i integracje interfejsu API przestają działać. Zweryfikuj gałąź docelową przed przełączeniem, a następnie zaktualizuj wszystkie odwołania.

Faza projektu Workflow Oczekiwany wynik Znane ograniczenia
Wstępne zatwierdzenie
  • Przenieś pulpit nawigacyjny do folderu Git w obszarze roboczym.
  • Zatwierdź i wypchnij do zdalnego repozytorium Git.
 Usługa Git śledzi pulpit nawigacyjny w repozytorium zdalnym.
Rozwój
  • Deweloperzy tworzą foldery Git w oddzielnych gałęziach deweloperskich, zazwyczaj w folderach domowych.
  • Zatwierdź zmiany w gałęzi deweloperskiej.
  • Połącz gałęzie rozwojowe z główną, używając pull requests.
  • Deweloperzy pracują niezależnie.
  • Usługa Git śledzi wersje pulpitu nawigacyjnego.
 Pliki pulpitu nawigacyjnego używają JSON formatu. Zapytania SQL są wyświetlane jako pojedynczy wiersz, co może utrudniać przeglądanie wniosków o połączenie.
Wdrożenie
  • Utwórz katalog Git na branchu wdrożeniowym w folderze nadrzędnym, który nie jest katalogiem użytkownika. Zobacz CI/CD z folderami Git w Databricks.
  • Przeciągnij zmiany do folderu wdrożenia.
  • Opublikuj pulpity nawigacyjne z tego folderu.
  • Usuń dostęp do edycji+ i ogranicz aktualizacje do usługi Git.
  • Udostępnianie pulpitów nawigacyjnych konsumentom.
  • Użytkownicy uzyskują dostęp do spójnej, opublikowanej wersji pulpitu nawigacyjnego.
  • Pulpity nawigacyjne można udostępniać w tym samym folderze innym grupom odbiorców.
 Usługa Databricks nie zapewnia wbudowanej obsługi synchronizowania gałęzi zdalnej z folderem Git w obszarze roboczym ani wdrażania pakietów zasobów usługi Databricks z zasobem pulpitu nawigacyjnego zdalnego. Skonfiguruj CI/CD, aby zautomatyzować:
  • Ściąganie aktualizacji z repozytorium zdalnego.
  • Publikowanie pulpitów nawigacyjnych po synchronizacji.
  • Wdrażanie pakietów zasobów usługi Databricks po aktualizacji.

Aby uzyskać więcej najlepszych rozwiązań dotyczących współpracy w folderach Git usługi Databricks, zobacz Współpraca przy użyciu folderów Git.

Ograniczenia

Kontrola źródła za pomocą pulpitów nawigacyjnych sztucznej inteligencji/analizy biznesowej ma następujące ograniczenia:

  • Możesz dodać maksymalnie 100 pulpitów nawigacyjnych w jednym folderze Git. Ten limit może ulec zmianie w publicznej wersji zapoznawczej.
  • Zadania oparte na usłudze Git, takie jak zadania odwołujące się do adresów URL usługi Git zamiast identyfikatorów zasobów obszaru roboczego lub ścieżek, nie działają z pulpitami nawigacyjnymi.
  • Serializacja pulpitu nawigacyjnego generuje długie stringi, co sprawia, że odczytywanie i przeglądanie różnic podczas pull requestów jest trudne.
  • Format pliku pulpitu nawigacyjnego okresowo zmienia się w celu uwzględnienia nowych pól i innych ulepszeń. W publicznej wersji zapoznawczej te zmiany mogą być wyświetlane jako różnice w usłudze Git, których nie zainicjowano.
  • Last updated on