Co to jest integracja z usługą Microsoft Fabric Git?
W tym artykule wyjaśniono deweloperom, jak zintegrować kontrolę wersji usługi Git z narzędziem do zarządzania cyklem życia aplikacji (ALM) usługi Microsoft Fabric.
Uwaga
Niektóre elementy integracji z usługą Git są dostępne w wersji zapoznawczej. Aby uzyskać więcej informacji, zobacz listę obsługiwanych elementów.
Integracja z usługą Git w usłudze Microsoft Fabric umożliwia deweloperom integrowanie procesów programowania, narzędzi i najlepszych rozwiązań bezpośrednio z platformą Fabric. Umożliwia to deweloperom, którzy opracowują aplikacje w usłudze Fabric:
- Tworzenie kopii zapasowych i wersja ich pracy
- Przywróć poprzednie etapy zgodnie z potrzebami
- Współpraca z innymi osobami lub praca samodzielnie przy użyciu gałęzi usługi Git
- Stosowanie możliwości znanych narzędzi kontroli źródła w celu zarządzania elementami sieci szkieletowej
Integracja z kontrolą źródła jest na poziomie obszaru roboczego. Deweloperzy mogą wersjonować elementy opracowywane w obszarze roboczym w jednym procesie, z pełną widocznością wszystkich swoich elementów. Obecnie obsługiwanych jest tylko kilka elementów, ale lista obsługiwanych elementów rośnie.
Przeczytaj informacje na temat kontroli wersji i narzędzia Git , aby upewnić się, że znasz podstawowe pojęcia związane z usługą Git.
Przeczytaj więcej na temat procesu integracji z usługą Git.
Przeczytaj o najlepszym sposobie zarządzania gałęziami usługi Git.
Informacje o ochronie prywatności
Przed włączeniem integracji z usługą Git zapoznaj się z następującymi zasadami zachowania poufności informacji:
- Zasady zachowania poufności informacji firmy Microsoft
- Omówienie ochrony danych usług Azure DevOps Services
- Umowa dotycząca ochrony danych w usłudze GitHub
Obsługiwani dostawcy usługi Git
Obsługiwane są następujące dostawcy usługi Git:
- Usługa Git w usłudze Azure Repos z tą samą dzierżawą co dzierżawa sieci szkieletowej
- GitHub
- GitHub Enterprise
Obsługiwane elementy
Obecnie obsługiwane są następujące elementy:
- Potoki danych (wersja zapoznawcza)
- Przepływy danych gen2 (wersja zapoznawcza)
- EventHouse (wersja zapoznawcza)
- EventStream (wersja zapoznawcza)
- Lakehouse (wersja zapoznawcza)
- Eventhouse i baza danych KQL (wersja zapoznawcza)
- Notesy
- Raporty podzielone na strony (wersja zapoznawcza)
- Odruch (wersja zapoznawcza)
- Raporty (z wyjątkiem raportów połączonych z modelami semantycznymi hostowanymi w usługach Azure Analysis Services, SQL Server Analysis Services lub raportach wyeksportowanych przez program Power BI Desktop, które są zależne od modeli semantycznych hostowanych w usłudze MyWorkspace) (wersja zapoznawcza)
- Modele semantyczne (z wyjątkiem zestawów danych wypychania, połączenia na żywo z usługami Analysis Services, model v1) (wersja zapoznawcza)
- Definicje zadań platformy Spark (wersja zapoznawcza)
- Środowisko Spark (wersja zapoznawcza)
- Baza danych SQL (wersja zapoznawcza)
- Magazyny (wersja zapoznawcza)
Jeśli obszar roboczy lub katalog Git ma nieobsługiwane elementy, nadal można je połączyć, ale nieobsługiwane elementy są ignorowane. Nie są one zapisywane ani synchronizowane, ale nie są usuwane. Są one wyświetlane w panelu sterowania źródła, ale nie można ich zatwierdzić ani zaktualizować.
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, sieć szkieletowa 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.
- Obszary robocze z zainstalowanymi aplikacjami szablonu nie mogą być połączone z usługą Git.
- Suwerenne chmury nie są obsługiwane.
- Konto usługi Azure DevOps musi być zarejestrowane dla tego samego użytkownika, który korzysta z obszaru roboczego sieć szkieletowa.
- Administrator dzierżawy musi włączyć eksporty między lokalizacjami geograficznymi, jeśli obszar roboczy i repozytorium Git znajdują się w dwóch różnych regionach geograficznych.
- 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 Enterprise
Niektóre ustawienia usługi GitHub Enterprise nie są obsługiwane. Na przykład:
- Lista dozwolonych adresów IP
- Sieć prywatna
- Niestandardowe domeny
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. - Struktura folderów obszaru roboczego nie jest odzwierciedlana w repozytorium Git. Elementy obszaru roboczego w folderach są eksportowane do katalogu głównego.
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.
- Folder Git używa identyfikatora logicznego (Guid) jako prefiksu przed typem, jeśli nazwa wyświetlana elementu:
- Zawiera więcej niż 256 znaków
- Kończy się spacją lub znakiem .
- Zawiera dowolny z następujących znaków: " / : ? < > \ * |
Rozgałęzianie ograniczeń
- Wygałę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.
- Podczas rozgałęziania zostanie utworzony nowy obszar roboczy, a ustawienia z oryginalnego obszaru roboczego nie są kopiowane. Dostosuj ustawienia lub definicje, aby upewnić się, że nowy obszar roboczy spełnia zasady organizacji.
- W nowym obszarze roboczym są dostępne tylko obsługiwane elementy usługi 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.
Ograniczenia synchronizacji i zatwierdzania
- 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. 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 , wypycha zmienione kolumny na końcu 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 w repozytorium Git były pliki elementów z podziałami wierszy CRLF , po zatwierdzeniu z usługi te pliki zostaną zmienione na LF. Jeśli na przykład otworzysz raport na pulpicie, zapisz projekt pbip i przekaż go do usługi Git przy użyciu funkcji CRLF.
- 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
- 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.