Siirtyminen ODBC:stä ADBC-ajureihin Power BI:ssä ja Fabric:ssa

Power BI ja Microsoft Fabric siirtävät tuettuja tietolähdeyhteyksiä vanhoista upotetuista ODBC-ajureista Apache Arrow Database Connectivity (ADBC) -ajureille. ADBC tarjoaa joukon vakioliittymiä nuolitietojen käsittelemiseen, mikä on erityisen tehokasta suurten tietojoukkojen noutamisessa ilman sarjoitusta tai kopiointia. ADBC-ajurit sisältävät myös tietoturvaparannuksia, kuten muistin turvallisuutta ja roskien keräämistä.

ADBC:n voi ottaa käyttöön jo tänään per yhteys, ja ylläpitäjät voivat hallita oletuskäyttäytymistä laajassa mittakaavassa vuokralaisasetuksella, jonka työtilan ylläpitäjät voivat ohittaa testaukseen ja validointiin.

Liittimet ja elementtimuutokset

Seuraavassa taulukossa on lueteltu liittimet, jotka siirtyvät upotetuista ODBC-ajureista korvaaviin ajureisiin. Useimmissa tapauksissa korvaava ajuri on ADBC-ajuri.

Ketkä kärsivät

Se vaikuttaa, jos käytät jotakin ADBC:hen siirtyvää liitintä (kuten Databricks, Snowflake tai Google BigQuery) ja:

• Et ole nimenomaisesti valinnut toteutusta yhteydessä ( Implementation parametria ei ole määritelty), tai
• Organisaatiosi haluaa keskitetyn kontrollin siihen, onko ADBC vai ODBC oletuksena tuetuille liittimille.

Tämä oletus koskee kaikkia yhteyksiä, mukaan lukien semanttiset mallit, Dataflows Gen2 ja sivutetut raportit.

Kuinka siirtyä

Voit siirtyä kolmella tavalla, järjestettynä haluamasi kontrollin mukaan:

• Yhteyskohtainen opt-in: Lisää Implementation="2.0" yksittäisiin yhteyksiin validoidaksesi ADBC:n omaan tahtiin.
• Vuokralaisasetus: Aseta organisaation laajuinen oletusarvo Admin-portaalin kautta.
• Työtilan ohitus: Ohita vuokralaisen oletus työtilan tasolla rinnakkaista validointia varten.

Yhteyskohtainen opt-in

Voit valita ADBC:n lisäämällä Implementation="2.0" tuettuihin yhteyksiin. Tämä lähestymistapa antaa sinun validoida ADBC:tä omaan tahtiin yksittäisten yhteyksien osalta.

Yksityiskohtaiset ohjeet liitännän valintaan tietylle liittimelle löydät liitinkohtaisesta dokumentaatiosta, joka on linkitetty Liittimien ja ajurin muutokset-taulukossa.

Vuokraaja-asetukset

Vuokralaisten ylläpitäjät voivat asettaa organisaation oletusasetukset Admin-portaalin asetuksen avulla:

Käyttäjät voivat yhdistää tietolähteisiin Apache Arrow -tietokantayhteyden (ADBC) avulla

• Pois käytöstä (oletus): Valitsee vanhat ODBC-ajurit oletusvaihtoehdoksi.
• Käytössä: Valitsee uudet ADBC-ajurit oletusvaihtoehdoksi.

Tämä asetus ohjaa myös Test Connection -käyttäytymistä jokaiselle yhteystyypille vuokralaisen sisällä.

Työtilan ohitus

Tenant-asetus delegoi työtiloille, joten työtilan ylläpitäjät voivat ohittaa oletusasetukset ja vertailla käyttäytymistä muuttamatta yksittäisiä yhteyksiä. Tämä lähestymistapa mahdollistaa rinnakkaisen validoinnin. Esimerkiksi voit käyttää yhtä työtilaa ADBC-oletusten testaamiseen samalla kun toinen työtila pysyy ODBC-oletusilla.

Miten toteutus valitaan

Jos määrittelet parametrin Implementation nimenomaisesti yhteydessä, se arvo menee aina vuokralaisen tai työtilan oletusarvoihin nähden.

Seuraava taulukko näyttää, miten kuljettaja valitaan:

Paikallisen tietoyhdyskäytävän toiminta

Vuokraajan ja työtilan ADBC-asetukset koskevat pilvipalvelussa suoritettavia päivityspolkuja. Paikallisen tietoyhdyskäytävän kautta reitityvät kyselyt käyttävät edelleen yhdyskäytäväasennukseen yhdistettyä ohjainta, joka on tällä hetkellä ODBC tässä artikkelissa luetelluille liittimille. Yhdyskäytävään reitityt päivitykset eivät vaihda ADBC:hen, kun vuokraaja- tai työtila-asetus on käytössä. Tämä on odotettua toimintaa.

Kaksi seurauksia, jotka tulee tietää siirron suunnittelusta:

• Jos käytät yhdyskäytävää testataksesi siirtymistä ADBC:hen, yhdyskäytävän kautta päivitykset eivät vastaa ADBC-polkua. Testaa ADBC:tä pilviyhteyden avulla ja vahvista ADBC:n toiminta alusta loppuun tarkasti.
• Asiakkaat, joiden on pysyttävä ODBC:ssä (esimerkiksi säilyttääkseen yksityisen linkin polun yhdyskäytävän kautta), voivat lykätä muutosta jatkamalla päivitysten reititystä paikallisen yhdyskäytävän kautta ODBC-ohjaimet asennettuina. Tämä on lykkäys, ei pysyvä suostumus: kun ODBC-ohjaimet poistetaan tulevista yhdyskäytäväasennuksista (katso Avainpäivämäärät), aiempiin julkaisuihin kiinnitettyjä yhdyskäytäviä ei lopulta tueta. Suunnittele yhdyskäytävän päivitykset ja ADBC-vahvistus vastaavasti.

Suositeltu siirtymisen tarkistuslista

1. Valvo työtilaasi pq-adbc-advisorin avulla , jotta voit varastoon kaikki yhteydet, jotka kiinnittävät vanhan ohjaimen, ja nähdä kohdekohtaisen riskiluokituksen. Katso Työtilan valvonta pq-adbc-advisorin avulla.
2. Valitse pilottityötila ja ota ADBC käyttöön siellä ensin käyttämällä työtilan ohitusta avainaineistojen validointiin ja skenaarioiden päivittämiseen. Jos haluat vahvistaa ADBC-polun alusta loppuun, testaa pilviyhteyden avulla – katso paikallisen tietoyhdyskäytävän toiminta siitä, miksi yhdyskäytäväreititykset pysyvät ODBC:ssä.
3. Vahvista Power BI Desktopissa. Asenna nykyinen Power BI Desktop -versio, joka lähettää ADBC-ohjaimen jokaiselle vaikutusalueen liittimelle, joka on läpäissyt oletuskäännön. Mitään tiedostokohtaista valitsinta ei voi pakottaa ADBC:lle olemassa olevassa kyselyssä. Jos haluat reitittää aiemmin luodun kyselyn ADBC:hen, poistaa kyselyn, lisätä lähteen uudelleen ja valita kentät uudelleen. Päivitä ja vertaa rivimääriä, saraketyyppejä ja päivityksen kestoa ODBC-perustasoon verrattuna.
4. Jos haluat varmistaa välittömästi Implementation="2.0", valitse yhteys per linkki .
5. Kun validointi on valmis, päätä, otetaanko ADBC oletuksena käyttöön vuokralaistasolla.

Valvo työtilaasi pq-adbc-advisorin avulla

Ennen siirtymistä sinun on tiedettävä, mitä tehdä. pq-adbc-advisoron vain luku -Fabric muistikirja, joka tarkistaa työtilan ja palauttaa kohdekohtaisen vaikutusraportin, jossa näkyy, mitkä semanttiset mallit, tietovuot ja tietoputket kiinnittävät yhä vanhan ODBC-ohjaimen ja mitä tehdä kullekin.

Miten raportti vaikuttaa sinuun

Vaikutusraportti antaa sinulle seuraavat tiedot:

• Luettelo työtilan jokaisesta siirtävästä liitinkutsusta ADBC:hen siirtyvien liittimien kautta.

• Kunkin tietoyksikön leikkausriskin luokitus:

  Riski	Mitä riski tarkoittaa?	Mitä tehdä?
  Epäonnistuu	M-kyselynastat Implementation="1.0" ja kohde eivät sido yhdyskäytävää. Ylityshetkellä tämä päivitys lakkaa toimimasta.	Poista [Implementation="1.0"] lähdevaiheesta tai sido kohde yhdyskäytävään ennen siirtymistä.
  Tarvitsee tarkistusta	M-kysely kiinnittää ODBC:n, mutta yhdyskäytävä on sidottu (rajataan, mutta se pitää silti kääntää), tai M luo raa'an DSN-merkkijonon, jota ADBC ei kuluta sanatarkasti.	Testaa ADBC-polku kohteen kopiossa ja julkaise sitten. DSN-merkkijonotapauksissa vakioliitin ei kata sitä, eskaloi kiihdytystoiminnossa mainittuun eskalointisähköpostilaatikkoon.
  Valmis	M-kysely kiinnittää jo ADBC:n (Implementation="2.0"), tai sen kiinnitys poistetaan, ja vuokraajan valitsin käsittelee sen siististi.	Ei toimintaa. Skannaa uudelleen leikkauksen jälkeen vahvistaaksesi.

• Tietoputkien ja tietovuon Gen2 kattavuus, ei vain semanttisten mallien.

• Resoluutioseuranta skannauksissa: jokaisessa skannauksessa on sekä ensimmäisen suorituksen perustaso että nykyinen laskuri, joten uudelleentarkistus kertoo, mitä on puhdistettu ensimmäisestä läpiajosta lähtien.

Mitä vaikutuksia raportilla ei ole

Vaikutusraportti ei:

• Kirjoita kaikki M-lausekkeet uudelleen.
• Käynnistä päivitykset yksinään (erillinen opt-in-aloituskohta on tarjolla vahvistusta varten).
• Lähetä M-koodi, kohteiden nimet, päätepisteiden URL-osoitteet, tunnistetiedot tai päivityksen virhesanoma työtilan ulkopuolelle.

Jokainen skannaus lähettää Power Query tiimille nimettömän määrän, jotta he voivat mitata käyttöönottoa ja priorisoida liittimen kattavuuden. Skannaus lähettää vain SHA-256-hajautetut vuokraajan ja käyttäjätunnisteet ilman raaka-arvoja oletusarvoisesti. Voit estää käytön milloin tahansa poistamalla telemetrian käytöstä kiihdytystoiminnossa kuvatulla tavalla. Opt-out-mahdollisuus säilyy kaikissa ydinkäynnistyksissä.

Vaikutusraportin suorittaminen

Helpoin tapa käyttää työkalua on Microsoft Fabric Toolboxin aloitusmuistikirjasta.

1. Lataa aloitusmuistikirja ja tuo se Fabric työtilaan.
2. Liitä muistikirja työtilaan, jonka haluat varastoon.
3. Suorita muistikirja ylhäältä alas. Se asentuu pq-adbc-advisor istuntoon, tarkistaa työtilan, hahmontaa vaikutusraportin sisäisesti ja tallentaa raportin HTML-kopion oletussäilöön, jos liität sellaisen.
4. Korjaa ongelma.
5. Suorita muistikirja uudelleen. Raportti näyttää tarkkuuden deltat – montako nastaa olet tyhjentänyt ensimmäisen skannauksen jälkeen.

Jos sinulla on järjestelmänvalvojan oikeudet ja haluat lakaista vuokraajan jokaisen työtilan, kiihdytystoiminto dokumentoi koko vuokraajan laajuisen skannausvaihtoehdon, joka käyttää Fabric järjestelmänvalvojan skannerin ohjelmointirajapintaa. Vuokraajan skannaukset kestävät yleensä 15–30 minuuttia keskikokoiselle vuokraajalle.

Katso virheiden, ominaisuuspyyntöjen ja liitinten peittoaukot accelerator-säilöstä.

Keskeiset päivämäärät

• Heinäkuu 2026 (suunniteltu): Vuokralaisympäristön laaja käyttöönotto alkaa. Työtilan käyttäytyminen perii tämän asetuksen ja sitä voi ohittaa työtilan ylläpitäjät, jos sitä tuetaan.
• Lokakuu 2026 (suunniteltu): Microsoft aikoo aloittaa vuokraaja-asetuksen käyttöönoton oletusarvoisesti vaiheittain käyttöönoton valmiuden mukaan.
• Alkuvuodesta 1 2027 (suunniteltu): Microsoft aikoo aloittaa ODBC-ohjainten poistamisen palvelusta käyttöönoton valmiuden mukaan. Jos sinun täytyy pysyä ODBC:ssä (Implementation="1.0" tai työtilan asetus pois päältä), sinun täytyy käyttää yhdyskäytävää jatkaaksesi kyselyitä ODBC:n kanssa.
• Kevät 2027 (suunniteltu): Tässä artikkelissa mainitut ODBC-ajurit eivät enää toimiteta Power BI Desktopin tai yhdyskäytävän mukana.

Ennen valvontavirstanpylväitä Microsoft aikoo antaa ennakkoilmoituksen, jotta asiakkaat voivat suorittaa migraatio- ja validointitoiminnot.

Usein kysyttyjä kysymyksiä

Voinko testata ADBC:tä nyt?

Kyllä. Asenna nykyinen Power BI Desktop ja lisää sitten kaikki vaikutusalueeseen kuuluvat lähteet. Uudet kyselyt reititetään heti ADBC:hen. Jos kyseessä on palvelupuolen testaus, käytä työtilan ohitusta ADBC:n käyttöönottamiseksi pilottityötilassa ja vahvista sen pilviyhteyden kautta.

Miten voin löytää jokaisen paikan, josta edelleen käytän vanhaa ODBC-ohjainta?

Suorita pq-adbc-advisor työtilassasi. Se on vain luku -Fabric muistikirja, joka tallentaa kaikki semanttiset mallit, tietovuot ja tietoputket, jotka käyttävät edelleen vanhaa ohjainta. Se luokittelee jokaisen leikkausriskin perusteella ja näyttää, mitä muuttaa. Käsittele sitä aloituskohtadiagnostiikkana, ei lopullisena tarkastuksena. Katso Työtilan valvonta pq-adbc-advisorin avulla. Järjestelmänvalvojat voivat suorittaa vuokraajan laajuisen pyyhkäisyn Fabric järjestelmänvalvojan skannerin ohjelmointirajapinnan kautta. Katso lisätietoja accelerator-dokumentaatiosta.

Vaikuttaako teihin, jos käytän jo paikallista tietoyhdyskäytävää?

Vuokraajan ja työtilan ADBC-asetukset koskevat vain palvelu suorituksia. Ne eivät vaikuta paikallisen tietoyhdyskäytävän kautta reitityihin päivityksiin. Yhdyskäytäväreitityspäivitykset käyttävät edelleen ODBC:tä tämän artikkelin liittimien leikkauksen kautta. Katso Paikallisen tietoyhdyskäytävän toiminta. ODBC-ohjaimet on suunniteltu poistettavaksi tulevista yhdyskäytäväasennuksista – seurataan ajoitusten avainpäivämääriä .

Miten voin estää ADBC-siirtymän?

Et voi pysyvästi jättäytyä pois. Vuokraaja-asetuksen avulla voit lykätä oletuskäännön vahvistusikkunan aikana, mutta kun ODBC on poistettu käytöstä palvelussa, muutos on yleinen. Jotta voit jatkaa ODBC:n käyttöä palvelupuolen leikkauksen jälkeen, sinun on reititettävä päivitykset paikallisen tietoyhdyskäytävän kautta, johon on asennettu ODBC-ohjaimet. Tämä muutos on vain lykkäys — ODBC-ohjaimet on suunniteltu poistettavaksi tulevista yhdyskäytäväasennuksista.

Miksi työtilan ADBC-asetus ei muuta Power BI Desktop -tiedostoani?

ADBC:llä ei ole tiedostokohtaista vaihtokytkintä Power BI Desktopissa. Desktop-tiedoston aiemmin luodut kyselyt säilyvät riippumatta siitä, millä ohjaimella kysely luotiin, kunnes kysely luodaan uudelleen. Jos haluat vahvistaa olemassa olevan kyselyn ADBC:n, poista kysely, lisää lähde uudelleen ja valitse kentät uudelleen. Uudet kyselyt nykyisen Desktopin julkaisureitillä ADBC:hen automaattisesti liittimille, jotka ovat ohittaneet oletuskäännön.

Kirjoittaako työtilan ADBC-asetus aiemmin luodut M-kyselyt uudelleen?

Ei. Vuokraajan ja työtilan asetukset muuttavat sitä, mikä ohjain valitaan kyselyn suorituksen aikana, mutta ne eivät muokkaa itse M-lauseketta. Nämä ovat isäntänimet, portit, yhteysparametrit ja M-liitinargumentit, jotka pysyvät täsmälleen samalla tavalla kuin määritetty. Tämä koskee sekä juuri luotuja että olemassa olevia yhteyksiä: kaikki yhteydet, joita ei nimenomaisesti kiinnitetä Implementation M-ympäristössä, seuraavat työtilan/vuokraajan oletusarvoa heti, kun se käännetään.

Yhteydet, jotka kiinnittävät ohjaimen M-tiedostoon, ohittavat työtilan tai vuokraajan oletusarvon. Yhteys ODBC:Implementation="2.0"n kanssa Implementation="1.0" säilyy ADBC:ssä työtilasta tai vuokraaja-asetuksesta riippumatta. Jos haluat muuttaa jotakin näistä, muokkaa M-parametria.

Jos haluat lisätietoja liitinkohtaisista toiminnoista (mukaan lukien odbc- ja ADBC-ohjainten väliset portti- tai asetuserot), tutustu liitinkohtaisiin ohjeisiin, jotka on linkitetty liittimet- ja kuljettajan muutostaulukkoon .

Liittyvä sisältö

• Databricks-liitin
• Azure Databricks-liitin
• Google BigQuery -liitin
• Google BigQuery (Microsoft Entra ID) -liitin
• Impala-liitin
• Snowflake-yhdistin
• pq-adbc-advisor accelerator (Microsoft Fabric Toolbox)