Kontrola wersji usługi Git dla notesów (starsza wersja)

Ważne

Obsługa integracji ze starszym notesem Git została usunięta 31 stycznia 2024 r. Usługa Databricks zaleca używanie folderów Git usługi Databricks do synchronizowania pracy w usłudze Databricks ze zdalnym repozytorium Git.

W tym artykule opisano sposób konfigurowania kontroli wersji usługi Git dla notesów (starsza funkcja). Możesz również użyć interfejsu wiersza polecenia usługi Databricks lub interfejsu API obszaru roboczego do importowania i eksportowania notesów oraz wykonywania operacji usługi Git w lokalnym środowisku projektowym.

Włączanie i wyłączanie przechowywania wersji usługi Git

Kontrola wersji jest włączona domyślnie. Aby przełączyć to ustawienie:

1. Przejdź do pozycji Ustawienia> Ustawienia obszaru pracy.
2. W sekcji Zaawansowane usuń zaznaczenie przełącznika Obsługa wersji notesu Git.

Configure version control (Konfigurowanie kontroli wersji)

Aby skonfigurować kontrolę wersji, utwórz poświadczenia dostępu u dostawcy usługi Git, a następnie dodaj te poświadczenia do usługi Azure Databricks.

Praca z wersjami notesu

Pracujesz z wersjami notesów w panelu historii. Otwórz panel historii, klikając prawym paskiem bocznym.

Uwaga

Nie można zmodyfikować notesu, gdy panel historii jest otwarty.

Łączenie notesu z usługą GitHub

1. Kliknij prawym paskiem bocznym. Na pasku stanu usługi Git jest wyświetlana pozycja Git: Nie połączono.

   

2. Kliknij pozycję Git: nie połączono.

   Zostanie wyświetlone okno dialogowe Preferencje usługi Git. Przy pierwszym otwarciu notesu stan to Odłącz, ponieważ notes nie znajduje się w usłudze GitHub.

   

3. W polu Stan kliknij pozycję Połącz.

4. W polu Link wklej adres URL repozytorium GitHub.

5. Kliknij listę rozwijaną Gałąź i wybierz gałąź lub wpisz nazwę nowej gałęzi.

6. W polu Ścieżka w folderze Git określ, gdzie w repozytorium ma być przechowywany plik.

   Notesy języka Python mają sugerowane domyślne rozszerzenie .pypliku . Jeśli używasz .ipynbprogramu , notes zostanie zapisany w formacie notesu iPython. Jeśli plik już istnieje w usłudze GitHub, możesz bezpośrednio skopiować i wkleić adres URL pliku.

7. Kliknij przycisk Zapisz , aby zakończyć łączenie notesu. Jeśli ten plik nie istnieje wcześniej, zostanie wyświetlony monit z opcją Zapisz ten plik w repozytorium GitHub.

8. Wpisz komunikat i kliknij przycisk Zapisz.

Zapisywanie notesu w usłudze GitHub

Zmiany wprowadzone w notesie są zapisywane automatycznie w historii wersji usługi Azure Databricks, ale zmiany nie są automatycznie utrwalane w usłudze GitHub.

1. Kliknij prawym paskiem bocznym, aby otworzyć panel historii.

   

2. Kliknij pozycję Zapisz teraz , aby zapisać notes w usłudze GitHub. Zostanie wyświetlone okno dialogowe Zapisywanie wersji notesu.

3. Opcjonalnie wprowadź komunikat opisujący zmianę.

4. Upewnij się, że wybrano pozycję Zatwierdź również w usłudze Git .

   

5. Kliknij przycisk Zapisz.

Przywracanie lub aktualizowanie notesu do wersji z usługi GitHub

Po połączeniu notesu usługa Azure Databricks synchronizuje historię z usługą Git za każdym razem, gdy ponownie otworzysz panel historii. Wersje, które są synchronizowane z usługą Git, zawierają skróty zatwierdzeń w ramach wpisu.

1. Kliknij prawym paskiem bocznym, aby otworzyć panel historii.

   

2. Wybierz wpis w panelu historii. Usługa Azure Databricks wyświetla wersję.

3. Kliknij pozycję Przywróć tę wersję.

4. Kliknij przycisk Potwierdź , aby potwierdzić, że chcesz przywrócić tę wersję.

Odłączanie notesu

1. Kliknij prawym paskiem bocznym, aby otworzyć panel historii.

2. Na pasku stanu usługi Git jest wyświetlana pozycja Git: Zsynchronizowana.

   

3. Kliknij pozycję Git: Zsynchronizowano.

   

4. W oknie dialogowym Preferencje usługi Git kliknij pozycję Odłącz.

5. Kliknij przycisk Zapisz.

6. Kliknij przycisk Potwierdź , aby potwierdzić, że chcesz odłączyć notes z kontroli wersji.

Korzystanie z gałęzi

Możesz pracować nad dowolną gałęzią repozytorium i tworzyć nowe gałęzie w usłudze Azure Databricks.

Tworzenie gałęzi

1. Kliknij prawym paskiem bocznym, aby otworzyć panel historii.

2. Kliknij pasek stanu usługi Git, aby otworzyć panel Usługi GitHub.

3. Kliknij listę rozwijaną Gałąź .

4. Wprowadź nazwę gałęzi.

   

5. Wybierz opcję Utwórz gałąź w dolnej części listy rozwijanej. Wskazana jest gałąź nadrzędna. Zawsze należy rozgałęzić z bieżącej wybranej gałęzi.

Tworzenie żądania ściągnięcia

1. Kliknij prawym paskiem bocznym, aby otworzyć panel historii.

2. Kliknij pasek stanu usługi Git, aby otworzyć panel Usługi GitHub.

   

3. Kliknij pozycję Utwórz żądanie ściągnięcia. Usługa GitHub otwiera stronę żądania ściągnięcia dla gałęzi.

Zmień bazę gałęzi

Możesz również ponownie bazować swoją gałąź w usłudze Azure Databricks. Link Rebase jest wyświetlany, jeśli nowe zatwierdzenia są dostępne w gałęzi nadrzędnej. Obsługiwane jest tylko ponowne łączenie na początku domyślnej gałęzi repozytorium nadrzędnego.

Załóżmy na przykład, że pracujesz nad .databricks/reference-apps Możesz utworzyć rozwidlenie na własnym koncie (na przykład brkyvz) i rozpocząć pracę nad gałęzią o nazwie my-branch. Jeśli nowa aktualizacja zostanie wypchnięta do databricks:masterelementu , Rebase zostanie wyświetlony przycisk i będzie można ściągnąć zmiany do gałęzi brkyvz:my-branch.

Ponowne łączenie działa nieco inaczej w usłudze Azure Databricks. Przyjmij następującą strukturę gałęzi:

Po zmianie bazy struktura gałęzi wygląda następująco:

Co się tutaj różni, jest to, że zatwierdzenia C5 i C6 nie mają zastosowania na podstawie C4. Są one wyświetlane jako zmiany lokalne w notesie. Konflikty scalania są wyświetlane w następujący sposób:

Następnie możesz ponownie zatwierdzić usługę GitHub przy użyciu przycisku Zapisz teraz .

Co się stanie, jeśli ktoś rozgałęził się z mojej gałęzi, że po prostu bazuję?

Jeśli gałąź (na przykład branch-a) była bazą dla innej gałęzi (branch-b) i bazujesz ponownie, nie musisz się martwić. Gdy użytkownik zmieni również bazę branch-bdanych, wszystko będzie działać. Najlepszym rozwiązaniem w tej sytuacji jest użycie oddzielnych gałęzi dla oddzielnych notesów.

Najlepsze rozwiązania dotyczące przeglądów kodu

Usługa Azure Databricks obsługuje rozgałęzianie usługi Git.

• Notes można połączyć z dowolną gałęzią w repozytorium. Usługa Azure Databricks zaleca używanie oddzielnej gałęzi dla każdego notesu.
• Podczas programowania możesz połączyć notes z rozwidleniem repozytorium lub z gałęzią inną niż domyślna w repozytorium głównym. Aby zintegrować zmiany nadrzędne, możesz użyć linku Tworzenie żądania ściągnięcia w oknie dialogowym Preferencje usługi Git w usłudze Azure Databricks, aby utworzyć żądanie ściągnięcia w usłudze GitHub. Link Utwórz żądanie ściągnięcia jest wyświetlany tylko wtedy, gdy nie pracujesz w domyślnej gałęzi repozytorium nadrzędnego.

Rozwiązywanie problemów

Jeśli występują błędy związane z synchronizacją historii usługi GitHub, sprawdź następujące kwestie:

• Można połączyć notes tylko z zainicjowanym repozytorium Git, które nie jest puste. Przetestuj adres URL w przeglądarce internetowej.
• Osobisty token dostępu usługi GitHub musi być aktywny.
• Aby korzystać z prywatnego repozytorium GitHub, musisz mieć uprawnienia do odczytu tego repozytorium.
• Jeśli notes jest połączony z gałęzią Usługi GitHub, która została zmieniona, zmiana nie zostanie automatycznie odzwierciedlona w usłudze Azure Databricks. Należy ręcznie połączyć notes ponownie z gałęzią.

Migrowanie do folderów Git usługi Databricks

Użytkownicy, którzy muszą przeprowadzić migrację do folderów Usługi Git usługi Databricks ze starszej wersji usługi Git, mogą skorzystać z następującego przewodnika:

• Przełączanie do folderów Git usługi Databricks ze starszej integracji z usługą Git