Overgang fra ODBC til ADBC-drivere i Power BI og Fabric

Power BI og Microsoft Fabric overfører understøttede datakildeforbindelser fra ældre indlejrede ODBC-drivere til Apache Arrow Database Connectivity (ADBC) drivere. ADBC indeholder et sæt standardgrænseflader til interaktion med piledata, hvilket især er effektivt til hentning af store datasæt med minimale omkostninger og ingen serialisering eller kopiering. ADBC-driverne indeholder også sikkerhedsforbedringer, såsom hukommelsessikkerhed og affaldsindsamling.

Bemærkning

De lejer- og arbejdsområdekontroller, der er beskrevet i denne artikel, aktiveres i faser og er muligvis endnu ikke tilgængelige i alle lejere. Denne overgang gælder kun for de stik, der er nævnt i denne artikel, og ændrer ikke ODBC-stikkets adfærd, når du bruger en separat installeret ODBC-driver. Ændringen i denne artikel er overgangen væk fra indlejrede drivere, der leveres med Power BI.

Du kan i dag adoptere ADBC pr. forbindelse, og administratorer kan styre standardadfærden i stor skala ved hjælp af en lejerindstilling, som arbejdsområdeadministratorer kan tilsidesætte til test og validering.

Stik og driverændringer

Følgende tabel viser de stik, der er ved at gå fra indlejrede ODBC-drivere til erstatningsdrivere. I de fleste tilfælde er erstatningsdriveren en ADBC-driver.

Stik Nuværende kører Erstatningsdriver
Dataklodser Simba Spark ODBC Databricks ADBC
Azure Databricks- Simba Spark ODBC Databricks ADBC
Dremio Simba Drill ODBC FlightSQL ADBC
Google BigQuery og Google BigQuery (Microsoft Entra ID) Simba Google BigQuery ODBC BigQuery ADBC
Bikube Simba Hive ODBC Forældet
Impala Simba Impala ODBC HiveServer2 ADBC
Snowflake Simba Snowflake ODBC Snowflake ADBC
Spark Simba Spark ODBC HiveServer2 ADBC

Hvem er berørt

Du er påvirket, hvis du bruger nogen af de connectors, der skifter til ADBC (såsom Databricks, Snowflake eller Google BigQuery) og:

  • Du har ikke eksplicit valgt en implementering i forbindelsen (parameteren Implementation er ikke specificeret), eller
  • Din organisation ønsker centraliseret kontrol over, om ADBC eller ODBC er standard for understøttede connectors.

Denne standard gælder, hvor du opretter en forbindelse, inklusive semantiske modeller, Dataflows Gen2 og paginerede rapporter.

Sådan migrerer du

Du kan migrere på tre måder, ordnet efter hvor meget kontrol du ønsker:

Per-forbindelses opt-in

Du kan tilmelde dig ADBC ved at tilføje Implementation="2.0" til understøttede forbindelser. Denne tilgang giver dig mulighed for at validere ADBC i dit eget tempo for individuelle forbindelser.

For detaljerede instruktioner om at vælge ind per forbindelse for et specifikt stik, se den stikspecifikke dokumentation, der er linket i tabellen Stik og driverændringer .

Lejerindstilling

Lejeradministratorer kan indstille organisationens standard ved hjælp af indstillingen Admin-portalen:

Brugere kan forbinde til datakilder ved at bruge Apache Arrow databaseforbindelse (ADBC)

  • Deaktiveret (standard): Vælger de ældre ODBC-drivere som standardindstilling.
  • Aktiveret: Vælger de nye ADBC-drivere som standardindstilling.

Denne indstilling styrer også Test Connection-adfærden for hver forbindelsestype inden for lejeren.

Workspace-overstyring

Lejerindstillingen delegerer til arbejdsområder, så arbejdsområdeadministratorer kan tilsidesætte standarden og sammenligne adfærd uden at ændre hver enkelt forbindelse. Denne tilgang muliggør side-om-side validering. For eksempel kan du bruge ét arbejdsområde til at teste ADBC-standardindstillinger, mens et andet arbejdsområde forbliver på ODBC-standardindstillinger.

Hvordan implementeringen vælges

Hvis du eksplicit specificerer parameteren Implementation i forbindelsen, har den værdi altid forrang over lejer- eller arbejdsområdets standardindstillinger.

Følgende tabel viser, hvordan driveren vælges:

Betingelse Brugt driver
Implementation="2.0" ADBC
Implementation ikke specificeret og arbejdsområdeindstillingen er Tændt ADBC
Implementation="1.0" ODBC
Implementation ikke specificeret, og arbejdsområdeindstillingen er Slået fra ODBC

Funktionsmåde for datagateway i det lokale miljø

ADBC-indstillingerne for lejer og arbejdsområde gælder for opdateringsstier, der kører i cloudtjenesten. Forespørgsler, der dirigerer gennem en datagateway i det lokale miljø, bruger fortsat driveren, der er bundtet med gatewayinstallationen, som i dag er ODBC for de connectors, der er angivet i denne artikel. Gatewayrutede opdateringer skifter ikke til ADBC, når lejer- eller arbejdsområdeindstillingen er aktiveret, og dette er forventet funktionsmåde.

To konsekvenser, du skal være opmærksom på, når du planlægger din migrering:

  • Hvis du bruger en gateway til at teste overgangen til ADBC, afspejler opdateringer via gatewayen ikke ADBC-stien. Test ADBC ved hjælp af en cloudforbindelse for at validere ADBC-funktionsmåden fra ende til anden.
  • Kunder, der skal forblive i ODBC (f.eks. for at bevare en sti med private links via gatewayen), kan udskyde ændringen ved fortsat at distribuere opdateringer via gatewayen i det lokale miljø, hvor ODBC-driverne er installeret. Dette er en udsættelse, ikke en permanent framelding: Når ODBC-drivere fjernes fra fremtidige gatewayinstallationer (se Nøgledatoer), bliver gateways, der er fastgjort til tidligere versioner, til sidst ikke understøttet. Planlæg gatewayopgraderinger og ADBC-validering i overensstemmelse hermed.
  1. Overvåg dit arbejdsområde med pq-adbc-advisor for at få en oversigt over alle forbindelser, der fastgør den ældre driver, og se en risikoklassificering pr. element. Se Overvåg dit arbejdsområde med pq-adbc-advisor.
  2. Vælg et pilot-arbejdsområde og aktiver ADBC der først, brug arbejdsområde-override til at validere nøgledatasæt og opdatere scenarier. Hvis du vil validere ADBC-stien fra ende til anden, skal du teste ved hjælp af en cloudforbindelse – se funktionsmåden for datagatewayen i det lokale miljø for at se, hvorfor gatewayrutede opdateringer forbliver på ODBC.
  3. Valider i Power BI Desktop. Installér den aktuelle Power BI Desktop-version, som leveres adbc-driveren for hver connector i området, der har bestået standardbladring. Der er ingen til/fra-knap pr. fil, der gennemtvinger ADBC på en eksisterende forespørgsel – for at dirigere en eksisterende forespørgsel til ADBC, slette forespørgslen, tilføje kilden igen og vælge felterne igen. Opdater og sammenlign rækkeantal, kolonnetyper og opdateringsvarighed med den oprindelige ODBC-plan.
  4. For alle kritiske forbindelser, du ønsker at validere med det samme, så vælg per forbindelse til Implementation="2.0".
  5. Når valideringen er færdig, skal du beslutte, om ADBC skal aktiveres som standard på lejerniveau.

Overvåg dit arbejdsområde med pq-adbc-advisor

Før du migrerer, skal du vide, hvad du skal ændre. pq-adbc-advisorer en skrivebeskyttet Fabric notesbog, der scanner et arbejdsområde og returnerer en effektrapport pr. element, der viser, hvilke semantiske modeller, dataflow og datapipelines der stadig fastgør den ældre ODBC-driver, og hvad du skal gøre ved hver enkelt.

Bemærkning

Denne diagnosticering er et udgangspunkt for diagnosticering, ikke en endelig overvågning. Behandl virkningsrapporten som det første gennemløb for at finde størstedelen af arbejdet. Connectordækningen udvides, og der er hjørnecases, som standardconnectorer endnu ikke kan tilknyttes rent. Værktøjet markerer disse sager eksplicit og peger dig på en postkasse, hvor teamet distribuerer dem. I forbindelse med produktionsrapporter med høj værdi skal du validere ADBC-stien i en kopi af varen, før du vender produktionen over.

Hvad effektrapporten giver dig

Effektrapporten giver dig:

  • En oversigt over hvert migrerende connectorkald i arbejdsområdet på tværs af connectorerne, der skifter til ADBC.

  • En komplet risikoklassificering for hvert element:

    Risiko Hvad risikoen betyder Sådan gør du
    Vil mislykkes M-forespørgslens pins, Implementation="1.0" og elementet har ingen gatewaybinding. Ved cutover holder denne opdatering op med at fungere. Fjern [Implementation="1.0"] fra kildetrinnet, eller bind elementet til en gateway før cutover.
    Kræver gennemsyn Enten fastgør M-forespørgslen ODBC, men en gateway er bundet (overlever cutover, men skal stadig spejlvendes), eller M opretter en rå DSN-streng, som ADBC ikke bruger ordret. Test ADBC-stien i en kopi af elementet, og udrul derefter. I DSN-strengsager, som standardconnectoren ikke dækker, skal du eskalere til den eskaleringspostkasse, der er angivet i acceleratoren.
    Færdig M-forespørgslen fastgør allerede ADBC (Implementation="2.0"), eller den er frigjort, og lejerkontakten håndterer den rent. Ingen handling. Scan igen efter cutover for at bekræfte.

  • Dækning af datapipelines og Dataflow Gen2, ikke kun semantiske modeller.

  • Løsningssporing på tværs af scanninger – hver scanning har både en oprindelig plan, der køres første gang, og en tæller, der kører i den aktuelle version, så en ny scanning fortæller dig, hvad der er blevet ryddet op siden første gennemløb.

Hvad effektrapporten ikke gør

Effektrapporten gør ikke:

  • Omskriv M-udtryk.
  • Udløs opdateringer alene (der er angivet et separat indgangspunkt til tilmelding til validering).
  • Send M-kode, elementnavne, URL-adresser til slutpunkter, legitimationsoplysninger eller opdater fejlmeddelelser uden for arbejdsområdet.

Hver scanning sender anonyme optællinger til det Power Query team, så de kan måle indføring og prioritere connectordækning. Scanningen sender kun SHA-256-hashede lejer- og bruger-id'er uden rå værdier som standard. Hvis du vil framelde dig når som helst, skal du deaktivere telemetri som dokumenteret i acceleratoren. Fravalget fortsætter på tværs af kerne genstarter.

Sådan kører du effektrapporten

Den nemmeste måde at bruge værktøjet på er via startnotesbogen i værktøjskassen Microsoft Fabric.

  1. Download startnotesbogen, og importér den til et Fabric arbejdsområde.
  2. Vedhæft notesbogen til det arbejdsområde, du vil oprette en oversigt over.
  3. Kør notesbogen fra top til bund. Den installeres pq-adbc-advisor i sessionen, scanner arbejdsområdet, gengiver virkningsrapporten indbygget og gemmer en HTML-kopi af rapporten i standardsøhuset, hvis du vedhæfter en.
  4. Foretag dine rettelser.
  5. Kør notesbogen igen. Rapporten viser opløsningens deltaer – hvor mange nåle du har ryddet op efter din første scanning.

Hvis du har administratortilladelser og vil feje alle arbejdsområder i lejeren, dokumenterer acceleratoren en scanningsindstilling for hele lejeren, der bruger API'en til Fabric administratorscanner. Lejerscanninger tager typisk 15-30 minutter for en mellemstor lejer.

Du kan se fejl, funktionsanmodninger og huller i connectordækningen i acceleratorlageret.

Vigtige datoer

  • Juli 2026 (planlagt): Bred udrulning af lejerordningen begynder. Workspace-adfærd arver denne indstilling og kan overskrives af workspace-administratorer, hvor det understøttes.
  • Oktober 2026 (planlagt): Microsoft planer om at begynde at aktivere lejerindstillingen som standard i faser, forudsat at udrulningsparatheden er aktiveret.
  • Tidlig 1. kvartal 2027 (planlagt): Microsoft planer om at begynde at fjerne ODBC-drivere fra tjenesten, forudsat at de er klar til udrulning. Hvis du skal blive på ODBC (Implementation="1.0"eller workspace aktivere), skal du bruge en gateway til at fortsætte med at køre forespørgsler med ODBC.
  • Forår 2027 (planlagt): De ODBC-drivere, der nævnes i denne artikel, forventes ikke længere at blive leveret med Power BI Desktop eller gatewayen.

Før håndhævelsesmilepæle planlægger Microsoft at give forudgående varsel, så kunderne kan gennemføre migrerings- og valideringsaktiviteter.

Ofte stillede spørgsmål

Kan jeg teste ADBC nu?

Ja. Installér den aktuelle Power BI Desktop, og tilføj en hvilken som helst kilde i området igen – nye forespørgsler dirigeres til ADBC med det samme. I forbindelse med test på tjenestesiden skal du bruge tilsidesættelsen af arbejdsområdet til at aktivere ADBC på et pilotprojekt og validere via en cloudforbindelse.

Hvordan finder jeg hvert sted, hvor jeg stadig bruger den ældre ODBC-driver?

Kør pq-adbc-advisor mod dit arbejdsområde. Det er en skrivebeskyttet Fabric notesbog, der indeholder en oversigt over hver semantisk model, dataflow og datapipeline, der stadig bruger den ældre driver. Den klassificerer hver enkelt efter cutover-risiko og viser, hvad der skal ændres. Behandl den som din startdiagnosticering, ikke en endelig revision. Se Overvåg dit arbejdsområde med pq-adbc-advisor. Administratorer kan køre en lejerbaseret sweep via API'en til Fabric administratorscanner. Du kan finde flere oplysninger i dokumentationen til acceleratoren.

Påvirkes jeg, hvis jeg allerede bruger datagatewayen i det lokale miljø?

ADBC-indstillingerne for lejer og arbejdsområde gælder kun for udførelser i tjenesten – de påvirker ikke opdateringer, der distribueres via en datagateway i det lokale miljø. Gatewayruterede opdateringer bruger fortsat ODBC via cutover til connectorerne i denne artikel. Se funktionsmåden for datagatewayen i det lokale miljø. ODBC-drivere er planlagt til at blive fjernet fra fremtidige gatewayinstallationer – spor vigtige datoer for timing.

Hvordan kan jeg fravælge ADBC-overgangen?

Du kan ikke permanent framelde dig. Med lejerindstillingen kan du udskyde standardbladring under valideringsvinduet, men når ODBC er deaktiveret i tjenesten, er ændringen universel. Hvis du vil fortsætte med at bruge ODBC efter overskæringen på tjenestesiden, skal du distribuere opdateringer via en datagateway i det lokale miljø, hvor ODBC-drivere er installeret. Denne ændring er kun en udsættelse – ODBC-drivere er planlagt til at blive fjernet fra fremtidige gatewayinstallationer.

Hvorfor ændrer ADBC-indstillingen for arbejdsområdet ikke min Power BI Desktop-fil?

Der er ingen til/fra-knap pr. fil for ADBC i Power BI Desktop. Eksisterende forespørgsler i en Desktop-fil forbliver på den driver, de blev oprettet mod, indtil forespørgslen oprettes igen. Hvis du vil validere ADBC for en eksisterende forespørgsel, skal du slette forespørgslen, tilføje kilden igen og vælge felterne igen. Nye forespørgsler i den aktuelle desktopversion dirigeres automatisk til ADBC for connectors, der har bestået deres standardbladring.

Omskriver ADBC-indstillingen for arbejdsområdet mine eksisterende M-forespørgsler?

Nej. Lejer- og arbejdsområdeindstillingerne ændrer, hvilken driver der vælges på forespørgselsudførelsestidspunktet, men de ændrer ikke selve M-udtrykket – værtsnavne, porte, forbindelsesparametre og connectorargumenter i din M forbliver nøjagtigt som oprettet. Denne funktionsmåde gælder for både nyoprettede og eksisterende forbindelser: Enhver forbindelse, der ikke eksplicit fastgør Implementation i M, følger standardindstillingen for arbejdsområdet/lejeren, så snart den vender tilbage.

Forbindelser, der fastgør driveren i M, har forrang frem for standardindstillingen for arbejdsområdet/lejeren. En forbindelse med Implementation="1.0" forbliver i ODBC og Implementation="2.0" forbliver på ADBC, uanset indstillingen for arbejdsområdet eller lejeren. Hvis du vil ændre en af disse, skal du redigere M.

Du kan se en connectorspecifik funktionsmåde (herunder eventuelle port- eller indstillingsforskelle mellem ODBC- og ADBC-driverne) i den connectorspecifikke dokumentation, der er sammenkædet i tabellen Connectors and driver changes .

Relateret indhold

  • Last updated on