Overstappen van ODBC naar ADBC-stuurprogramma's in Power BI en Fabric

Power BI en Microsoft Fabric stappen voor ondersteunde gegevensbronverbindingen over van verouderde ingebouwde ODBC-stuurprogramma's naar Apache Arrow Database Connectivity (ADBC)-stuurprogramma's. ADBC biedt een set standaardinterfaces voor interactie met pijlgegevens. Dit is met name efficiënt bij het ophalen van grote gegevenssets met minimale overhead en geen serialisatie of kopiëren. De ADBC-stuurprogramma's bevatten ook beveiligingsverbeteringen, zoals geheugenveiligheid en garbagecollection.

U kunt ADBC vandaag gebruiken per verbinding en beheerders kunnen het standaardgedrag op schaal beheren met behulp van een tenantinstelling die werkruimtebeheerders kunnen overschrijven voor testen en valideren.

Connectoren en wijzigingen in stuurprogramma's

De volgende tabel bevat de connectors die overstappen van ingesloten ODBC-stuurprogramma's naar vervangende stuurprogramma's. In de meeste gevallen is het vervangende stuurprogramma een ADBC-stuurprogramma.

Wie wordt beïnvloed

Dit wordt beïnvloed als u een van de connectors gebruikt die overstappen naar ADBC (zoals Databricks, Snowflake of Google BigQuery) en:

• U hebt geen implementatie expliciet gekozen in de verbinding (de Implementation parameter is niet opgegeven) of
• Uw organisatie wil gecentraliseerde controle over of ADBC of ODBC de standaardinstelling is voor ondersteunde connectors.

Deze standaardwaarde is van toepassing op elke locatie waar u een verbinding maakt, met inbegrip van semantische modellen, Gegevensstromen Gen2 en gepagineerde rapporten.

Hoe te migreren

U kunt op drie manieren migreren, gesorteerd op hoeveel controle u wilt:

• Opt-in per verbinding: Voeg Implementation="2.0" toe aan individuele verbindingen om ADBC in uw eigen tempo te valideren.
• Tenantinstelling: stel de standaardinstelling voor de hele organisatie in via de beheerportal.
• Werkruimte-overschrijving: Overschrijf de tenantstandaard op werkruimteniveau voor validatie naast elkaar.

Aanmelding per verbinding

U kunt kiezen voor ADBC door Implementation="2.0" toe te voegen aan ondersteunde verbindingen. Met deze methode kunt u ADBC in uw eigen tempo valideren voor afzonderlijke verbindingen.

Zie de connectorspecifieke documentatie die is gekoppeld aan de tabel Connectors en wijzigingen in stuurprogramma's voor gedetailleerde instructies voor het aanmelden per verbinding voor een specifieke connector.

Tenantinstelling

Tenantbeheerders kunnen de standaardinstelling van de organisatie instellen met behulp van de instelling voor de beheerportal:

Gebruikers kunnen verbinding maken met gegevensbronnen met behulp van Apache Arrow-databaseconnectiviteit (ADBC)

• Uitgeschakeld (standaard): Hiermee selecteert u de verouderde ODBC-stuurprogramma's als de standaardoptie.
• Ingeschakeld: Hiermee selecteert u de nieuwe ADBC-stuurprogramma's als de standaardoptie.

Met deze instelling bepaalt u ook het gedrag van de testverbinding voor elk verbindingstype in de tenant.

Overschrijven van werkruimte

De tenantinstelling delegeert naar werkruimten, zodat werkruimtebeheerders de standaardinstellingen kunnen overschrijven en gedrag kunnen vergelijken zonder elke afzonderlijke verbinding te wijzigen. Deze aanpak maakt validatie naast elkaar mogelijk. U kunt bijvoorbeeld één werkruimte gebruiken om de standaardinstellingen van ADBC te testen terwijl u een andere werkruimte op ODBC-standaardwaarden houdt.

Hoe de implementatie wordt gekozen

Als u expliciet de Implementation parameter in de verbinding opgeeft, heeft die waarde altijd voorrang op de standaardinstellingen van de tenant of werkruimte.

In de volgende tabel ziet u hoe het stuurprogramma is geselecteerd:

Werking van de on-premises data gateway

De ADBC-instellingen voor de tenant en werkruimte zijn van toepassing op vernieuwingspaden die worden uitgevoerd in de cloudservice. Query's die via een on-premises gegevensgateway worden gerouteerd, blijven het stuurprogramma gebruiken dat is gebundeld met de installatie van de gateway, en dat is momenteel ODBC voor de connectoren die in dit artikel worden vermeld. Vernieuwingen via gateways schakelen niet over naar ADBC wanneer de tenant- of werkruimte-instelling is ingeschakeld en dit is verwacht gedrag.

Twee gevolgen om rekening mee te houden bij het plannen van uw migratie:

• Als u een gateway gebruikt om de overgang naar ADBC te testen, worden vernieuwingen via de gateway niet weergegeven op het ADBC-pad. Test ADBC met behulp van een cloudverbinding om het end-to-end ADBC-gedrag nauwkeurig te valideren.
• Klanten die op ODBC moeten blijven staan (bijvoorbeeld om een privékoppelingspad via de gateway te behouden), kunnen de wijziging uitstellen door vernieuwingen door te zetten via de on-premises gateway waarop de ODBC-stuurprogramma's zijn geïnstalleerd. Dit is een uitstel, geen permanente opt-out: zodra ODBC-stuurprogramma's zijn verwijderd uit toekomstige gatewayinstallaties (zie sleuteldatums), worden gateways die zijn vastgemaakt aan eerdere releases uiteindelijk niet ondersteund. Plan gateway-upgrades en ADBC-validatie overeenkomstig.

Aanbevolen controlelijst voor migratie

1. Audit uw werkruimte met pq-adbc-advisor om elke verbinding te inventariseren die het verouderde stuurprogramma vastlegt en per item een risicoclassificatie te bekijken. Zie Uw werkruimte controleren met pq-adbc-advisor.
2. Kies een pilotwerkruimte en schakel ADBC daar eerst in met behulp van de werkruimte-override om belangrijke datasets en verversingsscenario’s te valideren. Als u het end-to-end ADBC-pad wilt valideren, test u met behulp van een cloudverbinding . Zie het gedrag van de on-premises gegevensgateway voor de reden waarom vernieuwingen via de gateway op ODBC blijven staan.
3. Valideer in Power BI Desktop. Installeer de huidige versie van Power BI Desktop, die het ADBC-stuurprogramma bevat voor elke relevante connector waarvoor de standaardinschakeling is doorgevoerd. Er is geen schakelaar op bestandsniveau om ADBC af te dwingen voor een bestaande query. Als u een bestaande query via ADBC wilt laten lopen, verwijdert u de query, voegt u de bron opnieuw toe en selecteert u de velden opnieuw. Aantal rijen, kolomtypen en vernieuwingsduur vernieuwen en vergelijken met uw ODBC-basislijn.
4. Voor kritieke verbindingen die u onmiddellijk wilt valideren, schakelt u dit voor elke verbinding afzonderlijk in met Implementation="2.0".
5. Zodra de validatie is voltooid, bepaalt u of ADBC standaard moet worden ingeschakeld op tenantniveau.

Uw werkruimte controleren met pq-adbc-advisor

Voordat u migreert, moet u weten wat u moet wijzigen. pq-adbc-advisor is een alleen-lezen Fabric-notebook dat een werkruimte scant en een impactrapport per item genereert waarin staat welke semantische modellen, gegevensstromen en gegevenspijplijnen nog gebruikmaken van het verouderde ODBC-stuurprogramma en wat u voor elk item moet doen.

Wat het impactrapport u geeft

Het impactrapport geeft u het volgende:

• Een inventaris van elke aanroep van de migrerende connector in de werkruimte over de connectors die overschakelen naar ADBC.

• Een cutover-risicoclassificatie voor elk item:

  Risico	Wat het risico betekent	Wat moet u doen?
  Mislukt	De M-querypinnen Implementation="1.0" en het item hebben geen gatewaybinding. Bij cutover werkt deze vernieuwing niet meer.	Verwijder [Implementation="1.0"] uit de bronstap of koppel het item aan een gateway vóór de cutover.
  Controle nodig	Ofwel legt de M-query ODBC vast, maar is er een gateway gekoppeld (overleeft de cutover, maar moet nog steeds worden omgezet), ofwel bouwt de M-query een ruwe DSN-tekenreeks die ADBC niet letterlijk verwerkt.	Test het ADBC-pad in een kopie van het item en rol het daarna uit. Voor gevallen met DSN-tekenreeksen die niet door de standaardconnector worden afgedekt, escaleer naar het escalatiepostvak dat in de accelerator wordt vermeld.
  Ready	De M-query zet ADBC (Implementation="2.0") al vast, of is niet vastgezet en de tenantwissel handelt dit netjes af.	Geen actie. Scan opnieuw na cutover om te bevestigen.

• Dekking voor gegevenspijplijnen en Gegevensstroom Gen2, niet alleen semantische modellen.

• Oplossingstracering voor scans: elke scan bevat zowel een basislijn voor de eerste uitvoering als een teller voor huidige uitvoering, dus een nieuwe scan geeft aan wat er sinds de eerste pas is opgeschoond.

Wat het impactrapport niet doet

Het impactrapport doet het volgende niet:

• Herschrijf M-expressies.
• Activeert verversingen zelfstandig (er is een afzonderlijk toegangspunt voor opt-in beschikbaar voor validatie).
• Verzend M-code, itemnamen, eindpunt-URL's, aanmeldingsgegevens of de inhoud van vernieuwingsfoutberichten buiten de werkruimte.

Elke scan verzendt anonieme tellingen naar het Power Query team, zodat ze de acceptatie kunnen meten en prioriteit kunnen geven aan de dekking van de connector. De scan verzendt alleen SHA-256-hash-tenant- en gebruikers-id's, zonder standaard onbewerkte waarden. Als u zich op elk gewenst moment wilt afmelden, schakelt u telemetrie uit zoals beschreven in de accelerator. De opt-out blijft behouden tijdens het opnieuw opstarten van de kernel.

Het impactrapport uitvoeren

De eenvoudigste manier om het hulpprogramma te gebruiken, is via het startersnotitieblok in de Microsoft Fabric Werkset.

1. Download het startersnotitieblok en importeer deze in een Fabric werkruimte.
2. Koppel het notitieblok aan de werkruimte die u wilt inventariseren.
3. Voer het notebook van boven naar beneden uit. Het installeert pq-adbc-advisor in de sessie, scant de werkruimte, geeft het impactrapport direct weer en slaat een HTML-kopie van het rapport op in het standaardlakehouse als u er een koppelt.
4. Breng uw oplossingen aan.
5. Voer het notebook opnieuw uit. In het rapport worden de resolutie-delta's weergegeven: hoeveel pinnen u hebt opgeschoond sinds uw eerste scan.

Als u beheerdersmachtigingen hebt en elke werkruimte in de tenant wilt opruimen, documenteert de accelerator een scanoptie voor de hele tenant die gebruikmaakt van de Fabric-beheerscanner-API. Tenantscans duren doorgaans 15-30 minuten voor een middelgrote tenant.

Zie de accelerator-repository voor bugs, functieverzoeken en hiaten in connectordekking.

Belangrijke data

• Juli 2026 (gepland): brede implementatie van de tenantinstelling begint. Het gedrag van de werkruimte erft deze instelling en kan, waar dit wordt ondersteund, door werkruimtebeheerders worden opgeheven.
• Oktober 2026 (gepland): Microsoft plannen om de tenantinstelling standaard in fasen in te schakelen, afhankelijk van de gereedheid van de implementatie.
• Vroege Q1 2027 (gepland): Microsoft plannen om ODBC-stuurprogramma's uit de service te verwijderen, afhankelijk van de gereedheid voor de implementatie. Als u ODBC (Implementation="1.0" of werkruimte-instelling Uit) moet blijven gebruiken, moet u een gateway gebruiken om query's met ODBC uit te voeren.
• Voorjaar 2027 (gepland): De ODBC-stuurprogramma's waarnaar in dit artikel wordt verwezen, zullen naar verwachting niet langer worden meegeleverd met Power BI Desktop of de gateway.

Voordat mijlpalen worden afgedwongen, Microsoft van plan om vooraf op de hoogte te worden gesteld, zodat klanten migratie- en validatieactiviteiten kunnen voltooien.

Veelgestelde vragen

Kan ik ADBC nu testen?

Yes. Installeer de huidige Power BI Desktop en voeg een bron binnen het bereik opnieuw toe: nieuwe query's worden onmiddellijk naar ADBC gerouteerd. Voor tests aan de servicezijde gebruikt u de werkruimte-override om ADBC in te schakelen op een pilotwerkruimte en via een cloudverbinding te valideren.

Hoe vind ik elke plaats waar ik nog steeds het verouderde ODBC-stuurprogramma gebruik?

Voer pq-adbc-advisor uit op uw werkruimte. Het is een alleen-lees-Fabric-notebook waarmee alle semantische modellen, gegevensstromen en Data Pipelines worden geïnventariseerd die nog steeds gebruikmaken van de verouderde driver. Het classificeert elk per cutover-risico en laat zien wat u kunt wijzigen. Behandel het als uw beginpuntdiagnose, niet als laatste controle. Zie Uw werkruimte controleren met pq-adbc-advisor. Beheerders kunnen via de Scanner API voor Fabric-beheerders een tenantbrede scan uitvoeren. Raadpleeg de acceleratordocumentatie voor meer informatie.

Ben ik hierdoor getroffen als ik de on-premises gegevensgateway al gebruik?

De ADBC-instellingen voor de tenant en werkruimte zijn alleen van toepassing op uitvoeringen in de service; ze zijn niet van invloed op vernieuwingsbewerkingen die via een lokale gegevensgateway worden gerouteerd. Vernieuwingen via gateways blijven ODBC gebruiken via cutover voor de connectors in dit artikel. Bekijk het gedrag van de on-premises gegevensgateway. ODBC-stuurprogramma's zullen uit toekomstige gateway-installaties worden verwijderd — raadpleeg belangrijke data voor de planning.

Hoe kan ik me afmelden voor de ADBC-overgang?

U kunt zich niet permanent uitsluiten. Met de tenantinstelling kunt u de standaardomschakeling tijdens de validatieperiode uitstellen, maar zodra ODBC in de service is uitgeschakeld, geldt de wijziging voor iedereen. Als u ODBC wilt blijven gebruiken na de omschakeling aan de servicezijde, moet u vernieuwingen via een on-premises gegevensgateway laten verlopen waarop ODBC-stuurprogramma's zijn geïnstalleerd. Deze wijziging is alleen een uitstel. ODBC-stuurprogramma's zijn gepland om te worden verwijderd uit toekomstige gatewayinstallaties.

Waarom wijzigt de ADBC-instelling van de werkruimte mijn Power BI Desktop-bestand niet?

Er is geen wisselknop per bestand voor ADBC in Power BI Desktop. Bestaande query's in een bureaubladbestand blijven behouden op het stuurprogramma waarop ze zijn gemaakt totdat de query opnieuw wordt gemaakt. Als u ADBC wilt valideren voor een bestaande query, verwijdert u de query, voegt u de bron opnieuw toe en selecteert u de velden opnieuw. Nieuwe query’s in de huidige Desktop-release worden automatisch naar ADBC doorgestuurd voor connectors waarvoor de standaardomschakeling is doorgevoerd.

Worden mijn bestaande M-query's opnieuw geschreven met de ADBC-instelling voor de werkruimte?

No. De tenant- en werkruimte-instellingen wijzigen welk stuurprogramma is geselecteerd tijdens de uitvoering van query's, maar ze wijzigen de M-expressie zelf niet: hostnamen, poorten, verbindingsparameters en connectorargumenten in uw M blijven exact zoals geschreven. Dit gedrag is van toepassing op zowel nieuw aangemaakte als bestaande verbindingen: elke verbinding die Implementation niet expliciet vastzet in M, volgt de standaard van de werkruimte/tenant op het moment dat deze omschakelt.

Verbindingen die de driver vastzetten in M, hebben voorrang op de standaardinstelling van de werkruimte/tenant. Een verbinding met Implementation="1.0" blijft op ODBC en Implementation="2.0" blijft op ADBC staan, ongeacht de werkruimte- of tenantinstelling. Als u een van deze wilt wijzigen, bewerkt u de M.

Zie de connectorspecifieke documentatie waarnaar wordt verwezen in de tabel Connectors en stuurprogrammawijzigingen voor connectorspecifiek gedrag (inclusief eventuele poort- of optieverschillen tussen de ODBC- en ADBC-stuurprogramma's).

Verwante inhoud

• Databricks connector
• Azure Databricks-connector
• Google BigQuery connector
• Google BigQuery-connector (Microsoft Entra ID)
• Impala connector
• Snowflakeconnector
• pq-adbc-advisor accelerator (Microsoft Fabric Toolbox)