Kontrola wersji Git dla notatników (starsze)

W tym artykule opisano sposób konfigurowania systemu kontroli wersji Git dla notatników (starsza funkcja). Możesz również użyć Databricks CLI lub interfejsu API obszaru roboczego do importowania i eksportowania notatników oraz wykonywania operacji Git w lokalnym środowisku programistycznym.

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 Ustawień>obszaru roboczego.
2. W sekcji Zaawansowane odznacz przełącznik Wersjonowanie Git notesu.

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.

Pracuj z wersjami notatnika

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

Łączenie notesu z usługą GitHub

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

   

2. Kliknij Git: nie połączono.

   Zostanie wyświetlone okno dialogowe Preferencje usługi Git. Przy pierwszym otwarciu notatnika stan ma wartość Niepołączony, ponieważ notatnik nie jest połączony z 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.

   Notatniki Pythona mają sugerowane domyślne rozszerzenie pliku .py. Jeśli korzystasz z .ipynb, notatnik zostanie zapisany w formacie notatnika iPython. Jeśli plik już istnieje w usłudze GitHub, możesz bezpośrednio skopiować i wkleić adres URL pliku.

7. Kliknij Zapisz, aby dokończyć łączenie notatnika. 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.

Zapisz notesnik do 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 na prawym pasku bocznym, aby otworzyć panel historii.

   

2. Kliknij pozycję Zapisz teraz , aby zapisać notes w usłudze GitHub. Pojawi się okno dialogowe „Zapisywanie wersji notatnika”.

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

4. Upewnij się, że wybrano opcję Również zatwierdź w 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ń jako część wpisu.

1. Kliknij na prawym pasku bocznym, aby otworzyć panel historii.

   

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

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

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

Odłącz notatnik

1. Kliknij na prawym pasku 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 na prawym pasku 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łąź na dole listy rozwijanej. Wskazana jest gałąź nadrzędna. Zawsze tworzysz gałąź na podstawie aktualnie wybranej gałęzi.

Utwórz pull request

1. Kliknij na prawym pasku bocznym, aby otworzyć panel historii.

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

   

3. Kliknij Utwórz PR. GitHub otwiera stronę pull requestu dla tej gałęzi.

Zmień bazę gałęzi

Możesz również zmienić bazę swojej gałęzi w usłudze Azure Databricks. Łącze Rebase jest wyświetlane, jeśli w gałęzi nadrzędnej są dostępne nowe commity. Obsługiwane jest tylko przebazowanie na domyślną gałąź repozytorium nadrzędnego.

Na przykład załóżmy, że pracujesz nad databricks/reference-apps. Tworzysz jego odgałęzienie na swoim koncie (na przykład brkyvz) i zaczynasz pracę w gałęzi o nazwie my-branch. Jeśli nowa aktualizacja zostanie wprowadzona do databricks:master, wtedy przycisk Rebase zostanie wyświetlony i będzie można wprowadzić zmiany do gałęzi brkyvz:my-branch.

Operacja rebase 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:

Różnica polega na tym, że zatwierdzenia C5 i C6 nie nakładają się na 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ć zmiany w GitHubie za pomocą przycisku Zapisz teraz.

Co się stanie, jeśli ktoś utworzył gałąź na podstawie mojej gałęzi, na której właśnie zrobiłem rebase?

Jeśli Twoja gałąź (na przykład branch-a) była bazą dla innej gałęzi (branch-b), i jeśli wykonasz rebase, nie musisz się martwić. Gdy użytkownik również wykona rebase branch-b, wszystko będzie działać. Najlepszą praktyką w tej sytuacji jest używanie osobnych gałęzi dla poszczególnych notatników.

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

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

• Możesz połączyć notatnik z dowolną gałęzią w repozytorium. Usługa Azure Databricks zaleca używanie oddzielnej gałęzi dla każdego notatnika.
• Podczas tworzenia możesz połączyć notatnik z forkiem repozytorium lub z gałęzią inną niż gałąź domyślna w repozytorium głównym. Aby zintegrować swoje zmiany z repozytorium nadrzędnym, możesz użyć linku Create PR w oknie dialogowym Preferencje Git w usłudze Azure Databricks, aby utworzyć pull request w serwisie GitHub. Link "Utwórz żądanie zmiany" pojawia się tylko wtedy, gdy nie pracujesz w gałęzi domyślnej 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:

• Notatnik może być połączony tylko ze 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ą.

Przejdź do folderów Git w usłudze Databricks

Użytkownicy, którzy muszą przejść ze starszego systemu kontroli wersji Git do folderów Git Databricks, mogą skorzystać z poniższego przewodnika:

• Przechodzenie ze starszej integracji Git do folderów Git usługi Databricks