Udostępnij za pośrednictwem

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

  • Artykuł

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.

Uprawnienia

  • Administrator organizacji musi włączyć integrację z usługą Git.
  • Administrator dzierżawy musi włączyć eksport między lokalizacjami geograficznymi, jeśli obszar roboczy i repozytorium usługi Azure znajdują się w dwóch różnych regionach. To ograniczenie nie ma zastosowania do usługi GitHub.
  • Uprawnienia, które masz zarówno w obszarze roboczym, jak i usłudze Git, jak pokazano w następnych sekcjach, określają akcje, które można wykonać.

Poniższa lista zawiera różne role obszaru roboczego w zależności od ich uprawnień w repozytorium Git:

  • Administrator: może wykonać dowolną operację w obszarze roboczym, ograniczoną tylko przez rolę usługi Git.
  • 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 Git. W przypadku akcji związanych z połączeniem obszaru roboczego (na przykład nawiązywania połączenia, rozłączania lub przełączania gałęzi) skontaktuj się z administratorem.
  • Przeglądający: Nie może wykonywać żadnych działań. Przeglądarka nie widzi żadnych informacji związanych z usługą Git w obszarze roboczym.

Role obszaru roboczego

W poniższej tabeli opisano uprawnienia wymagane w obszarze roboczym Fabric do wykonywania różnych operacji:

Operacja Rola obszaru roboczego
Łączenie obszaru roboczego z repozytorium Git Administracja
Synchronizowanie obszaru roboczego z repozytorium Git Administracja
Odłącz obszar roboczy od repozytorium Git Administracja
Zmień gałąź w obszarze roboczym (lub jakakolwiek zmiana ustawienia połączenia) Administracja
Wyświetlanie szczegółów połączenia z usługą Git Administrator, członek, współautor
Zobacz stan Git w obszarze roboczym Administrator, członek, współautor
Aktualizacja z usługi Git Wszystkie następujące role:

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)

OPIERANIE SIĘ na zależnościach zewnętrznych (jeśli ma to zastosowanie)
Zatwierdzanie zmian przestrzeni roboczej w Git Wszystkie następujące role:

Użytkownik z uprawnieniem do edytowania w obszarze roboczym (uprawnienie do pisania we wszystkich elementach)

Właściciel elementu (jeśli przełącznik dzierżawy blokuje aktualizacje dla osób niebędących właścicielami)

OPIERANIE SIĘ na zależnościach zewnętrznych (jeśli ma to zastosowanie)
Tworzenie nowej gałęzi Git z poziomu Fabric Administracja
Rozgałęzij do innego obszaru roboczego Administrator, członek, współautor

Role usługi Git

W poniższej tabeli opisano uprawnienia usługi Git potrzebne do wykonywania różnych typowych operacji:

Operacja Uprawnienia usługi Git
Łączenie obszaru roboczego z repozytorium Git Odczyt=Zezwól
Synchronizowanie obszaru roboczego z repozytorium Git Odczyt=Zezwól
Odłącz obszar roboczy od repozytorium Git Nie są potrzebne żadne uprawnienia
Przełącz gałąź w obszarze roboczym (lub dowolną zmianę ustawienia połączenia) Read=Allow (w repozytorium docelowym/katalogu/gałęzi)
Wyświetlanie szczegółów połączenia z usługą Git Odczyt lub Brak
Zobacz obszar roboczy "Status Git" Odczyt=Zezwól
Aktualizacja z usługi Git Czytaj=Zezwól
Zatwierdzanie zmian obszaru roboczego w usłudze Git Czytaj=Zezwól
Wkład=Zezwolić
zasady gałęzi powinny zezwalać na bezpośrednie zatwierdzanie zmian
Tworzenie nowej gałęzi Git z poziomu Fabric Rola=Zapisywanie
Utwórz gałąź =Zezwalaj
Rozgałęzij do innego obszaru roboczego Odczyt=Zezwól
Utwórz gałąź =Zezwalaj

Nawiązywanie połączenia i synchronizowanie

Tylko administrator obszaru roboczego może połączyć obszar roboczy z repozytoriami Git, 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.

Gdy połączysz obszar roboczy z Git, Fabric synchronizuje zawartość między dwoma lokalizacjami, aby były takie same. Podczas tej początkowej synchronizacji, jeśli przestrzeń robocza lub gałąź Git jest pusta, a druga ma zawartość, to zawartość jest kopiowana z miejsca, które nie jest puste, do tego, które jest puste. 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 zawartością z Git, będzie ona zastępować aktualną zawartość obszaru roboczego, co spowoduje jej utratę. Ponieważ gałąź Git można zawsze przywrócić do poprzedniego stanu, a obszaru roboczego nie, jeśli wybierzesz tę opcję, zostaniesz poproszony o potwierdzenie.

Zrzut ekranu przedstawiający okno dialogowe z pytaniem o kierunek synchronizacji, jeśli zarówno usługa Git, jak i obszar roboczy mają zawartość.

Jeśli nie wybierzesz zawartości do zsynchronizowania, nie możesz kontynuować pracy.

Zrzut ekranu z powiadomieniem, że nie można kontynuować pracy, dopóki obszar roboczy nie zostanie zsynchronizowany.

Folderów

Uwaga

Jeśli obszar roboczy zawiera foldery, a połączony folder Git nie ma jeszcze podfolderów, są one uważane za inne. Otrzymujesz status niezatwierdzonych zmian w panelu kontroli wersji i musisz zatwierdzić zmiany w Git przed zaktualizowaniem obszaru roboczego. W przypadku pierwszej aktualizacji struktura folderów Git zastępuje strukturę folderów obszaru roboczego. Aby uzyskać więcej informacji, zobacz Bezpieczne zarządzanie zmianami folderów.

Bezpieczne obsługa zmian folderów

Jeśli obszar roboczy zawiera foldery, a połączony folder Git nie ma jeszcze podfolderów, są one uważane za inne, ponieważ struktura folderów jest inna. pl-PL: Po połączeniu obszaru roboczego z folderami z Gitem otrzymasz status niezatwierdzonych zmian w panelu kontroli wersji i musisz zatwierdzić zmiany w Gicie przed zaktualizowaniem obszaru roboczego.

Jeśli nie możesz wprowadzić zmian bezpośrednio w połączonej gałęzi z powodu polityki lub uprawnień gałęzi, zalecamy użycie opcji Sprawdź gałąź:

  1. Utwórz nową gałąź: Użyj funkcji utworzenia gałęzi, aby utworzyć gałąź ze zaktualizowanym stanem obszaru roboczego Fabric.
  2. Zatwierdź zmiany folderów: wszelkie zmiany folderów obszaru roboczego można zatwierdzić w tej nowej gałęzi.
  3. Połącz zmiany: Użyj swojego zwykłego wniosku o pobranie (pull request - PR) i procesów scalania, aby włączyć te aktualizacje do pierwotnej gałęzi.

Nawiązywanie połączenia z udostępnionym obszarem roboczym

Jeśli spróbujesz nawiązać połączenie z obszarem roboczym, który jest już połączony z usługą Git, może zostać wyświetlony następujący komunikat:

Zrzut ekranu przedstawiający komunikat o błędzie z informacją o zalogowaniu się do konta usługi Git.

Przejdź do karty Konta po prawej stronie panelu sterowania źródłami, wybierz konto i połącz się z nim.

Zrzut ekranu przedstawiający kartę Konta z użytkownikiem nawiązującym połączenie z kontem usługi GitHub.

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.

Zrzut ekranu przedstawiający elementy w obszarze roboczym z ich statusem Git.

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

  • Zsynchronizowany (element jest ten sam zarówno w obszarze roboczym, jak i w 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 taki sam w obu miejscach, ale musi zostać zaktualizowany do najnowszego komitu

Informacje o synchronizacji

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

  • Połączona gałąź
  • Czas ostatniej synchronizacji
  • Łącze do ostatniego komitu, z którym jest synchronizowany obszar roboczy

Zrzut ekranu przedstawiający informacje o synchronizacji wyświetlane w dolnej części ekranu po nawiązaniu połączenia z usługą Git.

Okienko kontroli źródła

W górnej części ekranu znajduje się ikona systemu kontroli wersji. Przedstawia liczbę elementów, które różnią się między obszarem roboczym a gałęzią Git. Po wprowadzeniu zmian w obszarze roboczym lub gałęzi Git liczba jest aktualizowana. Po zsynchronizowaniu obszaru roboczego z gałęzią Git ikona kontroli źródła wyświetla 0.

Zrzut ekranu przedstawiający ikonę kontroli źródła z brakiem zmienionych elementów.

Wybierz ikonę kontroli źródła, aby otworzyć panel kontrolny.

Okienko kontroli źródła ma trzy karty po stronie:

Zatwierdzenia i aktualizacje

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

Panel Zatwierdzanie i aktualizowanie zawiera dwie sekcje.

Zmiany pokazują liczbę elementów, które zostały zmienione w obszarze roboczym i muszą zostać zatwierdzone w usłudze Git.
Aktualizacje pokazują liczbę elementów zmodyfikowanych w gałęzi Git i należy je zaktualizować do obszaru roboczego.

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

  • Nowy
  • Zmodyfikowano
  • Usunięte
  • konflikt

Przycisk Odśwież znajdujący się na górze panelu zaktualizuje listę zmian i aktualizacji.

Zrzut ekranu panelu kontroli źródła pokazujący stan zmienionych elementów.

Zatwierdzenie

  • Elementy w obszarze roboczym, które zostały zmienione, są wymienione w sekcji Zmiany . Jeśli istnieje więcej niż jeden zmieniony element, możesz wybrać elementy, które mają być zatwierdzane w gałęzi Git.
  • Jeśli w gałęzi Git wprowadzono aktualizacje, komity są zablokowane do momentu zaktualizowania obszaru roboczego.

Zaktualizuj

  • 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.

Odgałęzienia

Karta Gałęzie w panelu sterowania Źródło umożliwia zarządzanie gałęziami i wykonywanie akcji powiązanych z gałęzią. Zawiera ona dwie główne sekcje:

  • Akcje, które można wykonać w bieżącej gałęzi:

    Zrzut ekranu przedstawiający zakładkę rozgałęzień w panelu kontroli źródła.

  • Powiązane gałęzie.
    Karta Gałęzie zawiera również listę powiązanych obszarów roboczych, które można wybrać i do których można się przełączyć. Powiązany obszar roboczy jest takim, który ma te same właściwości połączenia co bieżąca gałąź, takie jak ta sama organizacja, projekt, repozytorium i folder Git.
    Ta funkcja umożliwia przechodzenie do obszarów roboczych połączonych z innymi gałęziami związanymi z kontekstem bieżącej pracy bez konieczności wyszukiwania ich na liście obszarów roboczych usługi Fabric.
    Aby otworzyć odpowiedni obszar roboczy, wybierz element na liście.

    Zrzut ekranu przedstawiający listę powiązanych gałęzi, do których użytkownik może się przełączyć.

Aby uzyskać więcej informacji, zobacz Rozgałęzianie ograniczeń.

Szczegóły klienta

Na karcie Szczegóły konta są wyświetlane szczegóły konta usługi GitHub, z którymi jest połączony użytkownik. Ma dwie sekcje. W górnej sekcji przedstawiono dostawcę Usługi Git i nazwę konta. W dolnej sekcji przedstawiono repozytorium i gałąź, z którą jest połączony obszar roboczy. Obecnie ta karta jest dostępna tylko dla obszarów roboczych połączonych z usługą GitHub.

Szczegóły konta usługi GitHub obejmują:

  • Szczegóły konta Git

    • Dostawca
    • Nazwa konta

  • Repozytorium Git

  • Oddział

Zrzut ekranu karty kont w panelu kontrolnym Source, przedstawiający szczegóły Git oraz nazwy repozytorium i gałęzi.

Rozważania i ograniczenia

Ogólne ograniczenia integracji z usługą Git

  • Metoda uwierzytelniania w usłudze Fabric musi być co najmniej tak silna, jak metoda uwierzytelniania dla usługi Git. Jeśli na przykład Git wymaga uwierzytelniania wieloskładnikowego, Fabric również musi wymagać uwierzytelniania wieloskładnikowego.
  • Zestawy danych usługi Power BI połączone z usługami Analysis Services nie są obecnie obsługiwane.
  • Obszary robocze z zainstalowanymi aplikacjami szablonu nie mogą być połączone z usługą Git.
  • Moduły podrzędne nie są obsługiwane.
  • Suwerenne chmury nie są obsługiwane.
  • Konto usługi Azure DevOps musi być zarejestrowane na tego samego użytkownika, który korzysta z obszaru roboczego Fabric.
  • Usługa Azure DevOps nie jest obsługiwana, jeśli włączono sprawdzanie poprawności zasad dostępu warunkowego ip.
  • Administrator dzierżawy musi włączyć eksporty między regionami, jeśli obszar roboczy i repozytorium Git znajdują się w dwóch różnych regionach geograficznych.
  • Jeśli organizacja skonfigurowała dostęp warunkowy , upewnij się, że usługa Power BI ma te same warunki ustawione, aby uwierzytelnianie działało zgodnie z oczekiwaniami.
  • Rozmiar zatwierdzenia ogranicza się do 125 MB.

Ograniczenia usługi GitHub Enterprise

Niektóre ustawienia usługi GitHub Enterprise nie są obsługiwane. Na przykład:

Ograniczenia obszaru roboczego

  • Tylko administrator obszaru roboczego może zarządzać połączeniami z repozytorium Git, 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 zawodzą.
  • Maksymalny rozmiar pliku to 25 MB.
  • Struktura folderów jest utrzymywana do 10 poziomów głębokości.
  • 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 ma dowolną z tych cech, folder Git jest przemianowany na identyfikator logiczny (Guid) i typ:
  • Po połączeniu obszaru roboczego zawierającego foldery z usługą Git należy zatwierdzić zmiany w repozytorium Git, jeśli struktura folderów jest inna.

Ograniczenia nazw katalogów

  • Nazwa katalogu, który nawiązuje połączenie z repozytorium Git, ma następujące ograniczenia dotyczące nazewnictwa:

    • Nazwa katalogu nie może zaczynać się ani kończyć spacją ani kartą.
    • Nazwa katalogu nie może zawierać żadnego z następujących znaków: "/:<>\*?|

  • Folder elementu (folder zawierający pliki elementów) nie może zawierać żadnego z następujących znaków: ":<>\*?|. Jeśli zmienisz nazwę folderu na coś, co zawiera jeden z tych znaków, usługa Git nie może nawiązać połączenia ani zsynchronizować z obszarem roboczym i wystąpi błąd.

Rozgałęzianie ograniczeń

  • Rozgałęzienie wymaga uprawnień wymienionych w tabeli uprawnień.
  • Dla tej akcji musi istnieć dostępna pojemność.
  • Wszystkie ograniczenia dotyczące nazewnictwa obszarów roboczych i gałęzi mają zastosowanie podczas rozgałęziania w nowym obszarze roboczym.
  • W nowym obszarze roboczym są dostępne tylko elementy obsługiwane przez Git.
  • Lista powiązanych gałęzi zawiera tylko gałęzie i obszary robocze, do których masz uprawnienia do wyświetlania.
  • Integracja z usługą Git musi być włączona.
  • Podczas rozgałęziania zostanie utworzona nowa gałąź, a ustawienia z oryginalnej gałęzi nie są kopiowane. Dostosuj ustawienia lub definicje, aby upewnić się, że nowe zasady organizacji są zgodne.
  • Podczas rozgałęziania do istniejącego obszaru roboczego:
    • Docelowy obszar roboczy musi obsługiwać połączenie z Git.
    • Użytkownik musi być administratorem docelowego obszaru roboczego.
    • Docelowy obszar roboczy musi mieć pojemność.
    • Obszar roboczy nie może mieć aplikacji wzorcowych.
  • Pamiętaj, że przenosząc się do innego obszaru roboczego, wszystkie elementy, które nie są zapisane w usłudze Git, mogą być utracone. Zalecamy zatwierdzenie wszelkich elementów, które chcesz zachować przed rozgałęzianiem.

Ograniczenia synchronizacji i zatwierdzania

  • Możesz synchronizować tylko w jednym kierunku naraz. 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, które nie mają przypisanej etykiety poufności, poproś administratora o pomoc.
  • Działa z ograniczonymi elementami. Nieobsługiwane elementy w folderze są ignorowane.
  • Duplikowanie nazw nie jest dozwolone. Nawet jeśli usługa Power BI zezwala na duplikowanie nazw, aktualizacja, zatwierdzanie lub cofanie akcji kończy się niepowodzeniem.
  • B2B nie jest obsługiwany.
  • Rozwiązywanie konfliktów jest częściowo wykonywane w usłudze Git.
  • Podczas procesu zatwierdzania w usłudze Fabric Git, usługa Fabric usuwa pliki znajdujące się w folderze elementu, które nie są częścią definicji elementu. Niepowiązane pliki, które nie są w folderze elementu, nie są usuwane.
  • Po zatwierdzeniu zmian możesz zauważyć nieoczekiwane zmiany w elemencie, którego nie wprowadzono. Te zmiany są semantycznie nieistotne i mogą wystąpić z kilku powodów. Na przykład:.
    • Ręczne zmienianie pliku definicji elementu. Te zmiany są prawidłowe, ale mogą być inne niż w przypadku wykonania w edytorach. Na przykład, jeśli zmienisz nazwę kolumny modelu semantycznego w Git i zaimportujesz tę zmianę do obszaru roboczego, przy następnym zatwierdzeniu zmian w modelu semantycznym, plik bim zostanie zarejestrowany jako zmieniony, a zmodyfikowana kolumna zostanie przesunięta na koniec tablicy columns. Dzieje się tak, ponieważ silnik AS, który generuje pliki bim, wypycha zmienione kolumny na koniec tablicy. Ta zmiana nie ma wpływu na sposób działania elementu.
    • Zatwierdzanie pliku, który używa podziałów wierszy CRLF . Usługa używa podziałów wierszy typu LF ("line feed"). Jeśli w repozytorium Git były pliki z końcami linii CRLF, po zatwierdzeniu z poziomu usługi te pliki zostaną zmienione na LF. Jeśli na przykład otworzysz raport na pulpicie, zapisz plik projektu (.pbip) i przekaż go do usługi Git przy użyciu CRLF.
  • Odświeżanie modelu semantycznego przy użyciu interfejsu API odświeżania rozszerzonego powoduje różnice w usłudze Git po każdym odświeżeniu.

Powiązana zawartość