Przejście z ODBC na sterownik ADBC w Power BI i Fabric

W programach Power BI i Microsoft Fabric obsługiwane połączenia ze źródłami danych są przenoszone ze starszych, wbudowanych sterowników ODBC na sterowniki Apache Arrow Database Connectivity (ADBC). ADBC zapewnia zestaw standardowych interfejsów do pracy z danymi Arrow, co jest szczególnie efektywne przy pobieraniu dużych zbiorów danych z minimalnym obciążeniem, bez konieczności serializacji ani kopiowania. Sterowniki ADBC obejmują również ulepszenia zabezpieczeń, takie jak bezpieczeństwo pamięci i odzyskiwanie pamięci.

Note

Kontrolki dzierżawy i obszaru roboczego opisane w tym artykule są włączane w fazach i mogą nie być jeszcze dostępne we wszystkich dzierżawach. To przejście dotyczy tylko łączników wymienionych w tym artykule i nie zmienia zachowania łącznika ODBC w przypadku używania oddzielnie zainstalowanego sterownika ODBC. Zmiana w tym artykule polega na odejściu od osadzonych sterowników, które są dostarczane z Power BI.

Już dziś można wdrożyć ADBC dla każdego połączenia, a administratorzy mogą kontrolować domyślne zachowanie na dużą skalę za pomocą ustawienia na poziomie dzierżawy, które administratorzy obszarów roboczych mogą nadpisać na potrzeby testowania i weryfikacji.

Zmiany łączników i sterowników

W poniższej tabeli wymieniono łączniki przechodzące z osadzonych sterowników ODBC do sterowników zastępczych. W większości przypadków zamienny sterownik to sterownik ADBC.

Łącznik Bieżący sterownik Sterownik zastępczy
Databricks Simba Spark ODBC Databricks ADBC
Azure Databricks Simba Spark ODBC Databricks ADBC
Dremio Simba Drill ODBC FlightSQL ADBC
Google BigQuery i Google BigQuery (Microsoft Entra ID) Simba Google BigQuery ODBC BigQuery ADBC
Hive Simba Hive ODBC Przestarzałe
Impala Simba Impala ODBC HiveServer2 ADBC
Snowflake Simba Snowflake ODBC Snowflake ADBC
Spark Simba Spark ODBC HiveServer2 ADBC

Kto ma wpływ

Dotyczy to Ciebie, jeśli używasz któregokolwiek z konektorów przechodzących na ADBC (takich jak Databricks, Snowflake lub Google BigQuery) i:

  • Nie wybrano wyraźnie implementacji w połączeniu (parametr Implementation nie jest określony) lub
  • Twoja organizacja chce scentralizowanej kontroli nad tym, czy usługa ADBC czy ODBC jest domyślną wartością obsługiwanych łączników.

To ustawienie domyślne ma zastosowanie wszędzie tam, gdzie tworzysz połączenie, w tym w modelach semantycznych, przepływach danych generacji 2 i raportach stronicowanych.

Jak przeprowadzić migrację

Migrację można przeprowadzić na trzy sposoby, uporządkowane według żądanej kontroli:

Zgoda na połączenie

Możesz wyrazić zgodę na usługę ADBC, dodając Implementation="2.0" do obsługiwanych połączeń. Takie podejście umożliwia zweryfikowanie usługi ADBC we własnym tempie dla poszczególnych połączeń.

Aby uzyskać szczegółowe instrukcje dotyczące włączania dla poszczególnych połączeń w przypadku określonego konektora, zobacz dokumentację dotyczącą tego konektora, do której prowadzi odsyłacz w tabeli Łączniki i zmiany sterowników.

Ustawienie dzierżawy

Administratorzy dzierżawy mogą ustawić wartość domyślną dla organizacji za pomocą ustawienia w portalu administracyjnym:

Użytkownicy mogą łączyć się ze źródłami danych przy użyciu łączności bazy danych Apache Arrow (ADBC)

  • Wyłączone (ustawienie domyślne): wybiera starsze sterowniki ODBC jako opcję domyślną.
  • Włączone: wybiera nowe sterowniki ADBC jako opcję domyślną.

To ustawienie kontroluje również działanie funkcji Test Connection dla każdego typu połączenia w obrębie dzierżawy.

Nadpisanie obszaru roboczego

Ustawienie dzierżawy jest delegowane do obszarów roboczych, dzięki czemu administratorzy obszarów roboczych mogą zastąpić ustawienie domyślne i porównać działanie bez modyfikowania poszczególnych połączeń. Takie podejście umożliwia walidację równoległą. Na przykład można użyć jednego obszaru roboczego do testowania domyślnych ustawień ADBC, a innego obszaru roboczego z domyślnymi ustawieniami ODBC.

Sposób wybierania implementacji

Jeśli jawnie określisz parametr Implementation w połączeniu, ta wartość ma zawsze pierwszeństwo przed ustawieniami domyślnymi dzierżawy lub obszaru roboczego.

W poniższej tabeli przedstawiono sposób wybierania sterownika:

Warunek Użyty sterownik
Implementation="2.0" ADBC
Implementation nie określono, a ustawienie dla obszaru roboczego to Włączone ADBC
Implementation="1.0" ODBC
Implementation nie określono, a ustawienie obszaru roboczego to Wyłączone ODBC

Zachowanie lokalnej bramy danych

Ustawienia ADBC dzierżawcy i obszaru roboczego mają zastosowanie do ścieżek odświeżania uruchamianych w usłudze w chmurze. Zapytania kierowane przez lokalną bramę danych nadal używają sterownika dołączonego do instalacji bramy, którym obecnie dla łączników wymienionych w tym artykule jest ODBC. Odświeżanie kierowane przez bramę nie przełącza się do usługi ADBC po włączeniu ustawienia dzierżawy lub obszaru roboczego i jest to oczekiwane zachowanie.

Podczas planowania migracji należy pamiętać o dwóch konsekwencjach:

  • Jeśli używasz bramy do testowania przejścia do ADBC, odświeżenia wykonywane za pośrednictwem bramy nie będą odzwierciedlać ścieżki dostępu ADBC. Przetestuj usługę ADBC przy użyciu połączenia w chmurze , aby dokładnie zweryfikować kompleksowe zachowanie usługi ADBC.
  • Klienci, którzy muszą pozostać przy ODBC (na przykład aby zachować ścieżkę łącza prywatnego przez bramę), mogą odroczyć tę zmianę, nadal kierując odświeżanie przez bramę lokalną z zainstalowanymi sterownikami ODBC. Jest to odroczenie, a nie trwała rezygnacja: po usunięciu sterowników ODBC z przyszłych instalacji bramy (zobacz kluczowe daty) bramy przypięte do wcześniejszych wersji z czasem przestaną być obsługiwane. Zaplanuj odpowiednio aktualizacje bramy i walidację ADBC.
  1. Przeprowadź audyt obszaru roboczego za pomocą narzędzia pq-adbc-advisor, aby zinwentaryzować każde połączenie korzystające ze starszego sterownika i wyświetlić klasyfikację ryzyka dla każdego elementu. Zobacz Audit your workspace with pq-adbc-advisor (Przeprowadź inspekcję obszaru roboczego za pomocą narzędzia pq-adbc-advisor).
  2. Wybierz pilotażowy obszar roboczy i najpierw włącz tam ADBC za pomocą funkcji zastępowania obszaru roboczego, aby zweryfikować kluczowe zestawy danych i scenariusze odświeżania danych. Aby kompleksowo zweryfikować ścieżkę ADBC, przetestuj za pomocą połączenia w chmurze — zobacz Zachowanie lokalnej bramy danych, aby dowiedzieć się, dlaczego odświeżanie kierowane przez bramę pozostaje przy ODBC.
  3. Zweryfikuj w programie Power BI Desktop. Zainstaluj najnowszą wersję programu Power BI Desktop, która zawiera sterownik ADBC dla każdego obsługiwanego łącznika, dla którego domyślnie włączono tę funkcję. Nie ma przełącznika dla pojedynczego pliku, który pozwala wymusić użycie ADBC w istniejącym zapytaniu — aby skierować istniejące zapytanie do ADBC, usuń zapytanie, ponownie dodaj źródło i ponownie wybierz pola. Odśwież i porównaj liczby wierszy, typy kolumn i czas trwania odświeżania względem punktu odniesienia ODBC.
  4. W przypadku każdego krytycznego połączenia, które chcesz natychmiast zweryfikować, włącz tę opcję osobno dla każdego połączenia za pomocą Implementation="2.0".
  5. Po zakończeniu walidacji zdecyduj, czy domyślnie włączyć usługę ADBC na poziomie dzierżawy.

Przeprowadzanie inspekcji obszaru roboczego za pomocą narzędzia pq-adbc-advisor

Przed przeprowadzeniem migracji musisz wiedzieć, co należy zmienić. pq-adbc-advisor to notesnik Fabric tylko do odczytu, który skanuje obszar roboczy i zwraca raport wpływu dla poszczególnych elementów, pokazujący, które modele semantyczne, przepływy danych i potoki danych nadal są przypięte do starszego sterownika ODBC oraz co należy zrobić w każdym przypadku.

Note

Ta diagnostyka jest diagnostyką punktu początkowego, a nie ostateczną inspekcją. Potraktuj raport wpływu jako pierwszy krok do zidentyfikowania większości prac. Obsługa konektorów się rozszerza, a nadal istnieją przypadki brzegowe, których standardowe konektory nie odwzorowują jeszcze w pełni. Narzędzie wyraźnie oznacza te przypadki i kieruje Cię do skrzynki pocztowej, do której zespół je przekierowuje. W przypadku kluczowych raportów produkcyjnych zweryfikuj ścieżkę ADBC w kopii obiektu przed przełączeniem na produkcję.

Co daje raport wpływu

Raport wpływu daje następujące informacje:

  • Wykaz każdego wywołania migrowanego łącznika w obszarze roboczym dla wszystkich łączników przechodzących na ADBC.

  • Klasyfikacja ryzyka jednorazowego dla każdego elementu:

    Ryzyko Co oznacza ryzyko Co zrobić
    Zakończy się niepowodzeniem Zapytanie M przypina element Implementation="1.0", a element nie ma powiązania z bramą. W momencie przełączenia to odświeżanie przestaje działać. Usuń [Implementation="1.0"] z kroku źródłowego lub przypisz element do bramy przed przełączeniem.
    Przegląd potrzeb Albo zapytanie M jest przypięte do ODBC, ale skojarzona jest brama (co przetrwa przełączenie, ale nadal należy to przełączyć), albo M tworzy surowy ciąg DSN, którego ADBC nie przetwarza dosłownie. Przetestuj ścieżkę ADBC na kopii elementu, a następnie ją wdroż. W przypadkach użycia ciągów DSN, których standardowy łącznik nie obsługuje, eskaluj do skrzynki eskalacyjnej wskazanej w akceleratorze.
    Ready Zapytanie języka M już przypina usługę ADBC (Implementation="2.0") lub jest odpięte, a przełącznik dzierżawy obsługuje go w sposób czysty. Brak akcji. Ponownie przeskanuj po przełączeniu, aby to potwierdzić.

  • Obsługa potoków danych i Dataflow Gen2, nie tylko modeli semantycznych.

  • Śledzenie rozwiązywania problemów między skanowaniami — każde skanowanie zawiera zarówno stan bazowy z pierwszego uruchomienia, jak i licznik bieżącego uruchomienia, więc ponowne skanowanie pokazuje, co zostało usunięte od pierwszego skanowania.

Co raport wpływu nie robi

Raport dotyczący wpływu nie obejmuje:

  • Zapisz ponownie dowolne wyrażenia języka M.
  • Samodzielnie wywołuje odświeżanie (do walidacji udostępniono oddzielny punkt wejścia wymagający dobrowolnego włączenia).
  • Nie wysyłaj kodu M, nazw elementów, adresów URL punktów końcowych, poświadczeń ani treści komunikatów o błędach odświeżania poza obszar roboczy.

Każde skanowanie wysyła anonimowe liczby do zespołu Power Query, aby móc mierzyć wdrożenie i ustalać priorytety pokrycia łączników. Skanowanie wysyła wyłącznie identyfikatory dzierżawy i użytkownika zahaszowane przy użyciu SHA-256, domyślnie bez surowych wartości. Aby w dowolnym momencie zrezygnować z udziału, wyłącz telemetrię zgodnie z opisem w akceleratorze. Wyłączenie pozostaje aktywne po ponownym uruchomieniu jądra.

Jak uruchomić raport wpływu

Najprostszym sposobem użycia narzędzia jest skorzystanie z notesu startowego w Microsoft Fabric Toolbox.

  1. Pobierz notes startowy i zaimportuj go do obszaru roboczego Fabric.
  2. Dołącz notes do obszaru roboczego, w którym chcesz utworzyć spis.
  3. Uruchom notatnik od góry do dołu. Zostanie ona zainstalowana pq-adbc-advisor w sesji, przeskanuje obszar roboczy, renderuje wbudowany raport wpływu i zapisuje kopię HTML raportu w domyślnym środowisku lakehouse, jeśli go dołączysz.
  4. Wprowadź poprawki.
  5. Uruchom ponownie zeszyt. Raport pokazuje zmiany w rozwiązaniu — liczbę pinów, które usunąłeś od czasu pierwszego skanowania.

Jeśli masz uprawnienia administratora i chcesz przeskanować każdy obszar roboczy w obrębie dzierżawy, w akceleratorze opisano opcję skanowania całej dzierżawy, która używa interfejsu API skanera administracyjnego usługi Fabric. Skanowanie dzierżawcy średniej wielkości zwykle trwa od 15 do 30 minut.

W przypadku błędów, próśb o nowe funkcje i braków w obsłudze konektorów zobacz repozytorium akceleratora.

Daty klucza

  • Lipiec 2026 (planowane): rozpoczyna się szerokie wdrożenie ustawienia dzierżawy. Zachowanie obszaru roboczego dziedziczy to ustawienie i może zostać nadpisane przez administratorów obszaru roboczego, jeśli ta funkcja jest obsługiwana.
  • Październik 2026 r. (planowany): Microsoft planuje rozpocząć etapowe domyślne włączanie ustawienia dzierżawy, w zależności od gotowości wdrożenia.
  • Na początku kwartału 2027 r. (planowane): Microsoft planuje rozpocząć usuwanie sterowników ODBC z usługi, z zastrzeżeniem gotowości do wdrożenia. Jeśli musisz pozostać przy ODBC (Implementation="1.0" lub w ustawieniu obszaru roboczego Wyłączone), musisz użyć bramy, aby nadal uruchamiać zapytania przy użyciu ODBC.
  • Wiosna 2027 r. (planowana): Sterowniki ODBC wymienione w tym artykule nie będą już dostarczane z programem Power BI Desktop ani z bramą.

Przed terminami egzekwowania Microsoft planuje zapewnić wcześniejsze powiadomienie, aby klienci mogli zakończyć działania związane z migracją i walidacją.

Często zadawane pytania

Czy mogę teraz przetestować usługę ADBC?

Yes. Zainstaluj bieżącą wersję programu Power BI Desktop i dodaj ponownie dowolne obsługiwane źródło — nowe zapytania są natychmiast kierowane do ADBC. W przypadku testów po stronie usługi użyj nadpisania obszaru roboczego, aby włączyć ADBC w pilotażowym obszarze roboczym i zweryfikować je przy użyciu połączenia z chmurą.

Jak mogę znaleźć każde miejsce, w których nadal używam starszego sterownika ODBC?

Uruchom polecenie pq-adbc-advisor względem obszaru roboczego. Jest to notes tylko do odczytu Fabric, który zawiera spis każdego modelu semantycznego, przepływu danych i potoku danych, który nadal używa starszego sterownika. Klasyfikuje je według ryzyka jednorazowego i pokazuje, co należy zmienić. Traktuj go jako diagnostykę punktu początkowego, a nie ostateczną inspekcję. Zobacz Audit your workspace with pq-adbc-advisor (Przeprowadź inspekcję obszaru roboczego za pomocą narzędzia pq-adbc-advisor). Administratorzy mogą uruchamiać skanowanie w całej dzierżawie za pośrednictwem interfejsu API Fabric Admin Scanner. Aby uzyskać szczegółowe informacje, zobacz dokumentację akceleratora.

Czy mam problem, jeśli korzystam już z lokalnej bramy danych?

Ustawienia ADBC na poziomie dzierżawy i obszaru roboczego mają zastosowanie tylko do uruchomień w usłudze — nie wpływają na odświeżanie kierowane za pośrednictwem lokalnej bramy danych. Odświeżenia kierowane przez bramę danych nadal używają ODBC do momentu przełączenia w przypadku łączników opisanych w tym artykule. Zobacz Zachowanie lokalnej bramy danych. Planowane jest usunięcie sterowników ODBC z przyszłych instalacji bramy — śledź kluczowe daty, aby znać terminy.

Jak zrezygnować z migracji do ADBC?

Nie można trwale zrezygnować z tej funkcji. Ustawienie dzierżawy umożliwia odroczenie domyślnego przełączenia w okresie weryfikacji, ale gdy ODBC zostanie wyłączone w usłudze, zmiana będzie dotyczyć wszystkich. Aby nadal korzystać z ODBC po przełączeniu po stronie usługi, należy kierować operacje odświeżania za pośrednictwem lokalnej bramy danych z zainstalowanymi sterownikami ODBC. Ta zmiana to jedynie odroczenie — planowane jest usunięcie sterowników ODBC z przyszłych instalacji bramy.

Dlaczego ustawienie ADBC obszaru roboczego nie zmienia pliku Power BI Desktop?

W programie Power BI Desktop nie ma przełącznika ADBC dla poszczególnych plików. Istniejące zapytania w pliku programu Desktop pozostają powiązane ze sterownikiem, przy użyciu którego zostały utworzone, dopóki nie zostaną utworzone ponownie. Aby zweryfikować usługę ADBC dla istniejącego zapytania, usuń zapytanie, ponownie dodaj źródło i ponownie wybierz pola. Nowe zapytania w bieżącej wersji Desktop są automatycznie kierowane do ADBC w przypadku łączników, dla których to ustawienie zostało już włączone domyślnie.

Czy ustawienie ADBC obszaru roboczego ponownie zapisuje istniejące zapytania M?

Nie. Ustawienia dzierżawcy i obszaru roboczego zmieniają, który sterownik jest wybierany w momencie wykonywania zapytania, ale nie modyfikują samego wyrażenia M — nazwy hostów, porty, parametry połączenia i argumenty konektora w kodzie M pozostają dokładnie takie, jak zostały zapisane. To zachowanie dotyczy zarówno nowo utworzonych, jak i istniejących połączeń: każde połączenie, które nie przypina jawnie wartości Implementation w języku M, przyjmuje ustawienie domyślne obszaru roboczego/dzierżawy w momencie jego przełączenia.

Połączenia przypięte do sterownika w języku M mają pierwszeństwo przed domyślnym ustawieniem obszaru roboczego/dzierżawy. Połączenie z Implementation="1.0" pozostaje przy ODBC, a połączenie z Implementation="2.0" pozostaje przy ADBC, niezależnie od ustawienia obszaru roboczego lub dzierżawcy. Aby zmienić jeden z tych elementów, zmodyfikuj M.

Aby uzyskać informacje o zachowaniu specyficznym dla łącznika (w tym różnice między portami lub opcjami między sterownikami ODBC i ADBC), zobacz dokumentację specyficzną dla łącznika połączoną z tabelą Łączniki i zmiany sterowników .

Treści powiązane

  • Last updated on