Podstawowe pojęcia dotyczące integracji z usługą Git

Artykuł
10/04/2023

W tym artykule opisano podstawowe pojęcia dotyczące usługi Git i proces integracji usługi Git z obszarem roboczym usługi Microsoft Fabric.

Ważne

Usługa Microsoft Fabric jest dostępna w wersji zapoznawczej.

Uprawnienia

Aby można było korzystać z integracji z usługą Git, musi być ona włączona przez administratora organizacji.
Jeśli obszar roboczy i repozytorium znajdują się w dwóch różnych regionach, eksportowanie między obszarami geograficznymi musi być włączone przez administratora dzierżawy. Aby uzyskać więcej informacji, zobacz Użytkownicy mogą eksportować elementy do repozytoriów Git w innych lokalizacjach geograficznych.
Akcje, które można wykonać w obszarze roboczym, zależą od uprawnień , które masz zarówno w obszarze roboczym, jak i w usłudze Azure DevOps.

Uprawnienia usługi Azure DevOps

Na poniższej liście przedstawiono różne role obszaru roboczego w zależności od uprawnień usługi Azure DevOps:

Administracja: Może wykonać dowolną operację w obszarze roboczym, ograniczoną tylko przez rolę usługi Azure DevOps.
Członek/współautor: po nawiązaniu połączenia z obszarem roboczym członek/współautor może zatwierdzać i aktualizować zmiany w zależności od roli usługi Azure DevOps. W przypadku akcji związanych z połączeniem obszaru roboczego (na przykład nawiązywania połączenia, rozłączania lub przełączania gałęzi) poszukaj pomocy z Administracja.
Osoba przeglądająca: Nie można wykonać żadnych akcji. Przeglądarka nie widzi żadnych informacji związanych z usługą Git w obszarze roboczym.

Uprawnienia wymagane do typowych operacji

W poniższej tabeli opisano uprawnienia wymagane do wykonywania różnych typowych operacji:

Operacja	Rola obszaru roboczego	Uprawnienia usługi Git
Połączenie obszaru roboczego do repozytorium Git	Administrator	Read=Allow
Synchronizowanie obszaru roboczego z repozytorium Git	Administrator	Read=Allow
Odłącz obszar roboczy od repozytorium Git	Administrator	Nie są potrzebne żadne uprawnienia
Przełącz gałąź w obszarze roboczym (lub dowolną zmianę ustawienia połączenia)	Administrator	Read=Allow (w repozytorium docelowym/katalogu/gałęzi)
Wyświetlanie szczegółów połączenia z usługą Git	Administracja, członek, współautor	Odczyt lub Brak
Zobacz obszar roboczy "Stan usługi Git"	Administracja, członek, współautor	Read=Allow
Aktualizacja z usługi Git	Wszystkie następujące elementy: Współautor w obszarze roboczym (uprawnienie DO ZAPISU we wszystkich elementach) Właściciel elementu (jeśli przełącznik dzierżawy blokuje aktualizacje dla osób niebędących właścicielami) TWORZENIE na zależnościach zewnętrznych (jeśli ma to zastosowanie)	Read=Allow
Zatwierdzanie zmian obszaru roboczego w usłudze Git	Wszystkie następujące elementy: Współautor w obszarze roboczym (uprawnienie DO ZAPISU we wszystkich elementach) Właściciel elementu (jeśli przełącznik dzierżawy blokuje aktualizacje dla osób niebędących właścicielami) TWORZENIE na zależnościach zewnętrznych (jeśli ma to zastosowanie)	Read=Allow Współtworzenie =Zezwalaj zasady gałęzi powinny zezwalać na bezpośrednie zatwierdzanie
Tworzenie nowej gałęzi Git z poziomu sieci szkieletowej	Administrator	Role=Write Utwórz gałąź =Zezwalaj

Połączenie i synchronizacja

Tylko administrator obszaru roboczego może połączyć obszar roboczy z usługą Azure Repos, ale po nawiązaniu połączenia każda osoba z uprawnieniami może pracować w obszarze roboczym. Jeśli nie jesteś administratorem, poproś administratora o pomoc dotyczącą nawiązywania połączenia.

Po połączeniu obszaru roboczego z usługą Git sieć szkieletowa synchronizuje się między dwiema lokalizacjami, aby miały tę samą zawartość. Podczas tej początkowej synchronizacji, jeśli obszar roboczy lub gałąź Usługi Git jest pusta, podczas gdy druga ma zawartość, zawartość jest kopiowana z lokalizacji nonempty do pustej. Jeśli zarówno obszar roboczy, jak i gałąź Usługi Git mają zawartość, musisz zdecydować, w jakim kierunku powinna iść synchronizacja.

Jeśli zatwierdzisz obszar roboczy w gałęzi Git, cała obsługiwana zawartość obszaru roboczego zostanie wyeksportowana do usługi Git i zastąpi bieżącą zawartość usługi Git.
Jeśli zaktualizujesz obszar roboczy przy użyciu zawartości usługi Git, zawartość obszaru roboczego zostanie zastąpiona i utracisz zawartość obszaru roboczego. Ponieważ gałąź Usługi Git zawsze można przywrócić do poprzedniego etapu, gdy obszar roboczy nie może, jeśli wybierzesz tę opcję, zostanie wyświetlony monit o potwierdzenie.

Screenshot of dialog asking which direction to sync if both Git and the workspace have content.

Jeśli nie wybierzesz synchronizowania zawartości, nie możesz kontynuować pracy, dopóki nie zrobisz tego:

Screenshot notification that you can't continue working until workspace is synced.

Stan usługi Git

Po nawiązaniu połączenia obszar roboczy wyświetla kolumnę Stanu usługi Git, która wskazuje stan synchronizacji każdego elementu w obszarze roboczym w odniesieniu do elementów w gałęzi zdalnej.

Screenshot if items in a workspace with their Git status outlined.

Każdy element ma jeden z następujących stanów:

Zsynchronizowane (element jest taki sam w obszarze roboczym i gałęzi Git)
Konflikt (element został zmieniony zarówno w obszarze roboczym, jak i w gałęzi Git)
Nieobsługiwany element
Niezatwierdzone zmiany w obszarze roboczym
Wymagana aktualizacja z usługi Git
Element jest identyczny w obu miejscach, ale musi zostać zaktualizowany do ostatniego zatwierdzenia

Informacje o synchronizacji

Jeśli masz połączenie, w dolnej części ekranu pojawią się następujące informacje:

gałąź Połączenie
Czas ostatniej synchronizacji
Łącze do ostatniego zatwierdzenia, z którymi jest synchronizowany obszar roboczy

Screenshot of sync information that appears on the bottom of the screen when connected to Git.

Zatwierdzenia i aktualizacje

Okienko kontroli źródła

W górnej części ekranu znajduje się ikona kontrolki Źródło. Przedstawia liczbę elementów, które różnią się w obszarze roboczym i gałęzi Git. Po zsynchronizowaniu obszaru roboczego z gałęzią Git ikona kontroli źródła wyświetla wartość 0.

Screenshot of the source control icon showing zero items changed.

Po wprowadzeniu zmian w obszarze roboczym lub gałęzi Git ikona kontroli źródła pokazuje liczbę różnych elementów. Wybierz ikonę kontroli źródła, aby otworzyć okienko Kontrola źródła.

W okienku Kontrola źródła karta Zmiany zawiera liczbę elementów, które zostały zmienione w obszarze roboczym i muszą zostać zatwierdzone w usłudze Git, a karta Aktualizacje zawiera liczbę elementów zmodyfikowanych w gałęzi Git i należy je zaktualizować do obszaru roboczego.

Na każdej karcie zmienione elementy są wyświetlane z ikoną wskazującą stan:

Nowy
Zmodyfikowano
Usunięte
Konflikt

Screenshot of the source control panel showing the status of the changed items.

Zatwierdzenie

Jeśli istnieje więcej niż jeden element do zatwierdzenia, możesz wybrać elementy, które mają być zatwierdzane w gałęzi Git.
Jeśli w gałęzi Git wprowadzono aktualizacje, zatwierdzenia są wyłączone do momentu zaktualizowania obszaru roboczego.

Aktualizuj

W przeciwieństwie do zatwierdzania i cofania, polecenie Aktualizuj zawsze aktualizuje całą gałąź i synchronizuje się z najnowszym zatwierdzeniem. Nie można wybrać określonych elementów do zaktualizowania.
Jeśli zmiany zostały wprowadzone w obszarze roboczym i w gałęzi Git w tym samym elemencie, aktualizacje są wyłączone do momentu rozwiązania konfliktu.

Dowiedz się więcej o tym, jak zatwierdzać i aktualizować . Przeczytaj więcej na temat procesu aktualizacji i sposobu rozwiązywania konfliktów.

Rozważania i ograniczenia

Ogólne ograniczenia

Konto usługi Azure DevOps musi być zarejestrowane dla tego samego użytkownika, który korzysta z obszaru roboczego sieć szkieletowa.
Metoda uwierzytelniania w usłudze Power BI musi być co najmniej tak silna, jak metoda uwierzytelniania dla usługi Azure DevOps. Jeśli na przykład usługa Azure DevOps wymaga uwierzytelniania wieloskładnikowego, usługa Power BI musi również wymagać uwierzytelniania wieloskładnikowego.
Modele zapytań bezpośrednich i złożonych w zestawach danych usługi Power BI i usługach Analysis Services nie są obecnie obsługiwane.
Prywatne wizualizacje niestandardowe nie są obsługiwane.

Ograniczenia obszaru roboczego

Tylko administrator obszaru roboczego może zarządzać połączeniami z repozytorium platformy Azure, takimi jak łączenie, rozłączanie lub dodawanie gałęzi. Po nawiązaniu połączenia każda osoba z uprawnieniami może pracować w obszarze roboczym.

Ograniczenia gałęzi i folderów

Maksymalna długość nazwy gałęzi to 244 znaki.
Maksymalna długość pełnej ścieżki dla nazw plików to 250 znaków. Dłuższe nazwy kończą się niepowodzeniem.
Maksymalny rozmiar pliku to 25 MB.
Nie można pobrać raportu/zestawu danych jako pliku pbix z usługi po wdrożeniu ich przy użyciu integracji z usługą Git.
Jeśli nazwa wyświetlana elementu:
- Zawiera więcej niż 256 znaków
- Kończy się znakiem ." lub spacją
- Zawiera dowolny z następujących znaków: ", , /:, , ?*<>\\|
Identyfikator logiczny (Guid) jest dodawany jako prefiks przed typem podczas nazewnictwa folderu w usłudze Git.

Ograniczenia synchronizacji i zatwierdzania

Limit rozmiaru zatwierdzenia wynosi 125 MB.
Synchronizacja w jednym kierunku jest dostępna tylko w jednym kierunku. Nie można jednocześnie zatwierdzać i aktualizować.
Etykiety poufności nie są obsługiwane, a eksportowanie elementów z etykietami poufności może być wyłączone. Aby zatwierdzić elementy z etykietami poufności bez etykiety poufności, poproś administratora o pomoc.
Działa z ograniczonymi elementami. Jeśli nieobsługiwane elementy znajdują się w folderze, są ignorowane.
Duplikowanie nazw nie jest dozwolone — nawet jeśli usługa Power BI zezwala na to, aktualizacja, zatwierdzenie lub cofanie akcji kończy się niepowodzeniem.
B2B nie jest obsługiwany.
Rozwiązywanie konfliktów jest częściowo wykonywane w usłudze Git.