Wprowadzenie do integracji z usługą Git

W tym artykule przedstawiono następujące podstawowe zadania w narzędziu integracji Git w usłudze Microsoft Fabric.

• Nawiązywanie połączenia z repozytorium Git
• Zatwierdzanie zmian
• Aktualizacja z usługi Git
• Odłączanie od usługi Git

Zalecamy przeczytanie omówienia integracji z Git przed rozpoczęciem.

Wymagania wstępne

Aby zintegrować usługę Git z obszarem roboczym usługi Microsoft Fabric, należy skonfigurować następujące wymagania wstępne dla usługi Fabric i Git.

Wymagania wstępne dotyczące architektury Fabric

Aby uzyskać dostęp do funkcji integracji z Git, potrzebujesz możliwości Fabric . Aby korzystać ze wszystkich obsługiwanych elementów systemu Fabric, wymagana jest odpowiednia pojemność. Jeśli jeszcze go nie masz, utwórz konto bezpłatnej wersji próbnej. Klienci, którzy mają już pojemność usługi Power BI Premium, mogą korzystać z tej pojemności, ale pamiętaj, że niektóre jednostki SKU usługi Power BI obsługują tylko elementy usługi Power BI.

Ponadto następujące opcje najemcy muszą być włączone w portalu administracyjnym:

• Użytkownicy mogą tworzyć elementy Fabric
• Użytkownicy mogą synchronizować elementy obszaru roboczego z repozytoriami Git
• Utwórz obszary robocze (tylko wtedy, gdy chcesz rozgałęzić się w nowym obszarze roboczym).
• Użytkownicy mogą synchronizować elementy obszaru roboczego z repozytoriami GitHub: tylko dla użytkowników usługi GitHub

Te przełączniki mogą być włączone przez administratora dzierżawy, administratora pojemności lub administratora obszaru roboczego, w zależności od ustawień organizacji.

Wymagania wstępne usługi Git

Integracja z usługą Git jest obecnie obsługiwana w przypadku usług Azure DevOps i GitHub. Do korzystania z integracji usługi Git z obszarem roboczym usługi Fabric potrzebne są następujące elementy w usłudze Azure DevOps lub GitHub:

Ograniczenia usługi Azure DevOps

• Aktywne konto platformy Azure zarejestrowane dla tego samego użytkownika, który korzysta ze środowiska Fabric. Utwórz bezpłatne konto.

Ograniczenia usługi GitHub

• Aktywne konto usługi GitHub. Utwórz konto usługi GitHub.

• Jeden z następujących osobistych tokenów dostępu:

  • Token o wysokiej szczegółowości (zalecany) z uprawnieniami do odczytu i zapisu zawartości w ramach uprawnień do repozytorium:

    

    Aby użyć tego tokenu w usłudze GitHub Enterprise, postępuj zgodnie z tymi instrukcjami.

  • Tworzenie klasycznego tokenu usługi GitHub z włączonymi zakresami repozytorium:

    

Łączenie obszaru roboczego z repozytorium Git

Nawiązywanie połączenia z repozytorium Git

Tylko administrator obszaru roboczego może połączyć obszar roboczy z repozytorium, 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. Aby połączyć obszar roboczy z repozytorium Azure lub GitHub, wykonaj następujące kroki:

1. Zaloguj się do Fabric i przejdź do obszaru roboczego, z którym chcesz się połączyć.

2. Przejdź do ustawień obszaru roboczego

   

3. Wybierz pozycję Integracja z usługą Git.

4. Wybierz dostawcę usługi Git. Obecnie obsługiwane są usługi Azure DevOps i GitHub.

Azure DevOps Connect

Jeśli wybierzesz usługę Azure DevOps, wybierz opcję Połącz, aby automatycznie zalogować się do konta Azure Repos powiązanego z użytkownikiem Microsoft Entra, który jest zalogowany do Fabric.

GitHub Connect

Jeśli wybierzesz pozycję GitHub, musisz zalogować się do swojego konta usługi GitHub.
Wybierz Dodaj konto, jeśli po raz pierwszy logujesz się z Fabric, lub wybierz jedno z wymienionych kont. Po zalogowaniu wybierz pozycję Połącz , aby zezwolić usłudze Fabric na dostęp do konta usługi GitHub.

Jeśli jest to pierwsze połączenie, musisz autoryzować użytkownika usługi GitHub. Podaj poniższe informacje:

• Nazwa wyświetlana — musi być unikatowa dla każdego użytkownika usługi GitHub
• Osobisty token dostępu - twój klasyczny lub szczegółowy osobisty token dostępu
• Adres URL repozytorium (opcjonalnie) — jeśli nie wprowadzisz adresu URL, możesz nawiązać połączenie z dowolnym repozytorium, do którego masz dostęp. Jeśli wprowadzisz adres URL, możesz połączyć się tylko z tym repozytorium.

Połącz się z przestrzenią roboczą

Jeśli obszar roboczy jest już połączony z usługą GitHub, postępuj zgodnie z instrukcjami dotyczącymi nawiązywania połączenia z udostępnionym obszarem roboczym.

Azure DevOps Branch Connect

1. Z menu rozwijanego określ następujące szczegóły dotyczące gałęzi, z którą chcesz nawiązać połączenie:

   • Organizacja
   • Projekt
   • Repozytorium Git.
   • Gałąź (wybierz istniejącą gałąź przy użyciu menu rozwijanego lub wybierz pozycję + Nowa gałąź , aby utworzyć nową gałąź. Jednocześnie można połączyć się tylko z jedną gałęzią).
   • Folder (wpisz nazwę istniejącego folderu lub wprowadź nazwę, aby utworzyć nowy folder. Jeśli nazwa folderu pozostanie pusta, zawartość zostanie utworzona w folderze głównym. Jednocześnie można połączyć się tylko z jednym folderem).

Połączenie z gałęzią GitHub

1. Z menu rozwijanego określ następujące szczegóły dotyczące gałęzi, z którą chcesz nawiązać połączenie:

   • Adres URL repozytorium. Jeśli nawiązano połączenie z usługą GitHub przy użyciu tokenu o określonym zakresie, adres URL zostanie automatycznie wypełniony i będzie można nawiązać połączenie tylko z tym repozytorium.
   • Gałąź (wybierz istniejącą gałąź przy użyciu menu rozwijanego lub wybierz pozycję + Nowa gałąź , aby utworzyć nową gałąź. Jednocześnie można połączyć się tylko z jedną gałęzią).
   • Folder (wpisz nazwę istniejącego folderu lub wprowadź nazwę, aby utworzyć nowy folder. Jeśli nazwa folderu pozostanie pusta, zawartość zostanie utworzona w folderze głównym. Jednocześnie można połączyć się tylko z jednym folderem).

Wybierz pozycję Połącz i zsynchronizuj.

Podczas początkowej synchronizacji, jeśli obszar roboczy lub gałąź Git jest pusta, zawartość jest kopiowana z lokalizacji niepustej do pustej. Jeśli zarówno obszar roboczy, jak i gałąź Git mają zawartość, pojawi się pytanie, w którym kierunku powinna przebiegać synchronizacja. Aby uzyskać więcej informacji na temat tej synchronizacji początkowej, zobacz Łączenie i synchronizacja.

Po nawiązaniu połączenia obszar roboczy wyświetla informacje o kontroli źródła, która umożliwia użytkownikowi wyświetlanie połączonej gałęzi, stan każdego elementu w gałęzi i czas ostatniej synchronizacji.

Aby zachować synchronizację obszaru roboczego z gałęzią Git, zatwierdź wszelkie zmiany wprowadzone w obszarze roboczym w gałęzi Git i zaktualizuj obszar roboczy za każdym razem, gdy każda osoba utworzy nowe zatwierdzenia w gałęzi Git.

Zatwierdzanie zmian w usłudze Git

Po pomyślnym nawiązaniu połączenia z folderem Git zmodyfikuj swój obszar roboczy w zwykły sposób. Wszystkie zapisane zmiany są zapisywane tylko w obszarze roboczym. Gdy wszystko będzie gotowe, możesz zatwierdzić zmiany w gałęzi Git lub cofnąć zmiany i przywrócić poprzedni stan.

Dowiedz się więcej o zatwierdzeniach.

Zatwierdź do Git

Aby zatwierdzić zmiany w gałęzi Git, wykonaj następujące kroki:

1. Przejdź do obszaru roboczego.

2. Wybierz ikonę Kontrolka źródła . Ta ikona przedstawia liczbę niezatwierdzonych zmian.

3. Wybierz pozycję Zmiany z panelu kontroli źródła. Zostanie wyświetlona lista ze wszystkimi zmienionymi elementami i ikoną wskazującą, czy element jest nowy , zmodyfikowany , konflikt lub usunięty .

4. Wybierz elementy, które chcesz zatwierdzić. Aby zaznaczyć wszystkie elementy, zaznacz górne pole.

5. Dodaj komentarz w polu . Jeśli nie dodasz komentarza, zostanie automatycznie dodany komunikat domyślny.

6. Wybierz pozycję Zatwierdź.

   

Po zatwierdzeniu zmian, elementy, które zostały zatwierdzone, są usuwane z listy, a obszar roboczy wskazuje na nowe zatwierdzenie, z którym został zsynchronizowany.

Po pomyślnym zakończeniu zatwierdzenia stan wybranych elementów zmieni się z Niezatwierdzone na Zsynchronizowane.

Cofnij zapisaną zmianę

Po zapisaniu zmian w obszarze roboczym, jeśli zdecydujesz, że nie chcesz zatwierdzać tych zmian w usłudze Git, możesz cofnąć zmiany i przywrócić te elementy do poprzedniego stanu. Aby cofnąć zmiany, wykonaj następujące kroki:

1. Przejdź do obszaru roboczego.

2. Wybierz przycisk Kontrola źródła . Ten przycisk zawiera również liczbę niezatwierdzonych zmian.

3. Wybierz Zmiany z panelu kontroli wersji. Zostanie wyświetlona lista ze wszystkimi zmienionymi elementami i ikoną wskazującą, czy zmieniony element jest nowy , zmodyfikowany , konflikt lub usunięty .

4. Wybierz zmiany, które chcesz cofnąć.

5. Wybierz pozycję Cofnij.

   

6. Wybierz ponownie pozycję Cofnij , aby potwierdzić.

   

Wybrane elementy w obszarze roboczym zostają przywrócone do stanu, w jakim były podczas ostatniej synchronizacji.

Ważne

Jeśli usuniesz element, a następnie cofniesz zmiany, element zostanie utworzony na nowo i niektóre metadane mogą zostać utracone. Na przykład oznaczenia poufności nie są zachowywane i należy je zresetować, a właściciel elementu jest przypisany do bieżącego użytkownika.

Zaktualizuj obszar roboczy z Git

Za każdym razem, gdy każda osoba zatwierdzi nową zmianę w połączonej gałęzi Git, w odpowiednim obszarze roboczym pojawi się powiadomienie. Użyj panelu kontroli wersji, aby zaimportować najnowsze zmiany, scalić je lub wycofać do przestrzeni roboczej i zaktualizować działające elementy. Zmiany folderów są również aktualizowane. Przeczytaj więcej na temat aktualizowania.

Aby zaktualizować obszar roboczy, wykonaj następujące kroki:

1. Przejdź do obszaru roboczego.
2. Wybierz ikonę Kontrolka źródła .
3. Wybierz pozycję Aktualizacje z panelu sterowania Źródła. Zostanie wyświetlona lista ze wszystkimi elementami, które zostały zmienione w gałęzi od ostatniej aktualizacji.
4. Wybierz pozycję Aktualizuj wszystko.

Po pomyślnym zaktualizowaniu lista elementów zostanie usunięta, a obszar roboczy będzie skierowany na nowy, z którym jest zsynchronizowany.

Po pomyślnym zakończeniu aktualizacji stan elementów zmieni się na Zsynchronizowane.

Odłączanie obszaru roboczego od usługi Git

Tylko administrator obszaru roboczego może odłączyć obszar roboczy od repozytorium Git. Jeśli nie jesteś administratorem, poproś administratora o pomoc dotyczącą rozłączenia. Jeśli jesteś administratorem i chcesz odłączyć repozytorium, wykonaj następujące kroki:

1. Przejdź do ustawień obszaru roboczego
2. Wybieranie integracji z usługą Git
3. Wybierz pozycję Rozłącz obszar roboczy
4. Wybierz ponownie pozycję Rozłącz, aby potwierdzić.

Uprawnienia

Akcje, które można wykonać w obszarze roboczym, zależą od uprawnień, które masz zarówno w obszarze roboczym, jak i repozytorium Git. Aby uzyskać bardziej szczegółową dyskusję na temat uprawnień, zobacz Uprawnienia.

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 usługa Git wymaga uwierzytelniania wieloskładnikowego, Fabric musi również wymagać uwierzytelniania wieloskładnikowego.
• Zestawy danych usługi Power BI połączone z usługami Analysis Services nie są obecnie obsługiwane.
• Jeśli używasz tożsamości obszaru roboczego w jednym artefaktie i zatwierdzasz ją w usłudze Git, można ją zaktualizować (z powrotem do obszaru roboczego sieci szkieletowej) tylko w obszarze roboczym połączonym z tą samą tożsamością. Należy zachować ostrożność, ponieważ ma to również wpływ na funkcje, takie jak "branch out".
• Moduły podrzędne nie są obsługiwane.
• Suwerenne chmury nie są obsługiwane.

Ograniczenia usługi Azure DevOps

• Konto usługi Azure DevOps musi być zarejestrowane dla tego samego użytkownika, który korzysta z obszaru roboczego Fabric.
• Usługa Azure DevOps nie jest obsługiwana, jeśli jest włączona opcja weryfikacji zasad warunkowego dostępu IP.
• Administrator dzierżawy musi włączyć eksporty międzyregionowe, jeśli obszar roboczy i repozytorium Git znajdują się w dwóch różnych regionach.
• Jeśli twoja organizacja skonfigurowała dostęp warunkowy, upewnij się, że usługa Power BI ma te same warunki ustawione na potrzeby uwierzytelniania, które będą działać zgodnie z oczekiwaniami.
• Rozmiar zatwierdzenia jest ograniczony do 125 MB.

Ograniczenia usługi GitHub

• Obsługiwane są tylko wersje chmury usługi GitHub. Rozwiązania lokalne nie są obsługiwane.
• Usługa GitHub nie może wymusić walidacji krzyżowych geograficznych.
• Łączny rozmiar plików do jednoczesnego zatwierdzenia jest ograniczony do 50 MB. W związku z tym, jeśli masz kilka elementów do zatwierdzenia, może czasami być konieczne podzielenie ich na kilka osobnych zatwierdzeń. Aby uzyskać więcej informacji na temat zatwierdzania plików, zobacz nasz przewodnik rozwiązywania problemów.

Ograniczenia usługi GitHub Enterprise

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

• Usługa GitHub Enterprise Cloud z miejscem przechowywania danych (ghe.com)
• GitHub Enterprise Server z niestandardową domeną nie jest obsługiwany, nawet jeśli instancja jest publicznie dostępna
• Github Enterprise Server hostowany w sieci prywatnej
• Lista dozwolonych adresów IP

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.
• Obszary robocze z zainstalowanymi aplikacjami szablonu nie mogą być połączone z usługą Git.
• Usługa MyWorkspace nie może nawiązać połączenia z dostawcą usługi Git.

Ograniczenia dla 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.
• Pobieranie raportu/zestawu danych jako pliku pbix z usługi po wdrożeniu ich przy użyciu integracji z usługą Git nie jest zalecane, ponieważ wyniki są zawodne. Zalecamy używanie programu PowerBI Desktop do pobierania raportów/zestawów danych jako pliku pbix.
• Jeśli wyświetlana nazwa elementu ma dowolną z tych cech, folder Git zostanie przemianowany na logiczny identyfikator (GUID - Global Unique Identifier) i typ:
  • Zawiera więcej niż 256 znaków
  • Kończy się kropką lub spacją.
  • Zawiera wszelkie niedozwolone znaki zgodnie z opisem w ograniczeniach nazw katalogów
• Po połączeniu obszaru roboczego z folderami z usługą Git należy zatwierdzić zmiany w repozytorium Git, jeśli struktura tego folderu 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ą lub tabulatorem.
  • 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ń

• Wygałęzienie wymaga uprawnień wymienionych w tabeli uprawnień.
• Dla tej akcji musi istnieć dostępna pojemność.
• Wszystkie ograniczenia dotyczące nazewnictwaobszarów roboczych i gałęzi mają zastosowanie podczas rozgałęziania w nowym obszarze roboczym.
• W nowym obszarze roboczym są dostępne tylko obsługiwane elementy 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 wszystkich 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 oznaczone jako poufne bez etykiety, 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 Git usługa szkieletowa usuwa pliki 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. Jeśli na przykład zmienisz nazwę kolumny modelu semantycznego w usłudze Git i zaimportujesz tę zmianę do obszaru roboczego, przy następnym zatwierdzeniu zmian w modelu semantycznym plik bim zarejestruje się zgodnie ze zmianą, a zmodyfikowana kolumna zostanie wypchnięta z tyłu columns tablicy. Dzieje się tak, ponieważ aparat AS, który generuje pliki bim, przenosi 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 LF (line feed). Jeśli miałeś pliki w repozytorium Git z podziałami wierszy CRLF, podczas zatwierdzenia 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 rozszerzonego interfejsu API odświeżania powoduje wystąpienie Git diff po każdym odświeżeniu.

Powiązana zawartość

• Omówienie procesu integracji z usługą Git
• Zarządzanie gałęziami usługi Git
• Najlepsze rozwiązania dotyczące integracji z usługą Git