Analysis Services-ügyfélkódtárak

A következőkre vonatkozik: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Az ügyfélkódtárak szükségesek ahhoz, hogy az ügyfélalkalmazások és eszközök csatlakozzanak az Analysis Serviceshez. Az olyan Microsoft-ügyfélalkalmazások, mint a Power BI Desktop, az Excel, az SQL Server Management Studio (SSMS) és a Visual Studio Analysis Services-projektbővítményei mind a három ügyfélkódtárat telepítik, és rendszeres alkalmazásfrissítésekkel együtt frissítik őket. Előfordulhat, hogy az Analysis Services egyéni ügyfélalkalmazásaihoz egy vagy több ilyen ügyfélkódtárat is telepíteni kell. Az ügyfélkódtárak új verziói körülbelül havonta frissülnek.

Fontos: A legújabb verziók beszerzése előtt mindenképpen tekintse meg szempontokat és korlátozásokat.

Töltse le a legújabb

Windows Installer

Letöltés	Verzió
MSOLAP (amd64)	17.0.30.23
MSOLAP (x86)	17.0.30.23
AMO	19.84.1.0
ADOMD	19.84.1.0

Megjegyzés: Az Analysis Services kezelői objektumok (AMO/TOM) és az ADOMD Windows Installer telepítők már nem frissülnek, és 2024. december 31. után nem lesznek elérhetők. Az ezekre a Windows Installer-letöltésekre támaszkodó alkalmazásokat NuGet-csomagokba kell migrálni.

NuGet-csomagok

Az Analysis Services kezelési objektumai (AMO/TOM) és az ADOMD klienskönyvtárak telepíthető csomagként érhetők el a NuGet.orgoldalon. Nyomatékosan ajánlott átváltani a NuGet-hivatkozásokra a Windows Installer helyett.

A NuGet-csomagok AssemblyVersion értékei a szemantikus verziókövetést követik: FŐ.MELLÉK.JAVÍTÁS. A NuGet-hivatkozások akkor is betöltik a várt verziót, ha a GAC-ban más verzió van (az MSI telepítéséből ered). A PATCH minden kiadáshoz növekszik. Az AMO és az ADOMD verziók szinkronban maradnak.

2024 júliusától az AMO és az ADOMD csomagok több-futtatókörnyezeti kiadásokat tartalmaznak az összes támogatott cél futtatókörnyezethez, mind a .NET FX-hez, mind a .NET Core-hoz; azoknak a csomagoknak a korábbi kiadásai, amelyek csak egyetlen futtatókörnyezetet céloztak meg, akár a .NET FX, akár a .NET Core, elérhetők a visszamenőleges kompatibilitás érdekében, de már nem frissülnek.

2022 szeptemberétől az AMO (AMO/TOM) és az ADOMD .Net Core (19.48.0.0-s verzió) http-alapú kommunikációja jelentősen javul az olyan felhőszolgáltatásokkal, mint a Power BI és az Azure Analysis Services. Javasoljuk, hogy frissítsen a legújabb verzióra a teljesítménybeli fejlesztések előnyeinek kihasználásához.

2021. februártól .NET Core futtatókörnyezeti támogatás érhető el az AMO- és ADOMD-ügyfélcsomagokhoz. Vannak azonban olyan forgatókönyvek, amelyeket a .NET Core-verziók nem támogatnak. További információért lásd a szempontokat és korlátozásokat a jelen cikk későbbi részében.

AMO és ADOMD

Csomag	Verzió
AMO	19.101.1.0
ADOMD	19.101.1.0

megjegyzés:

Az új több futtatókörnyezeti csomagok már nem tartalmazzák a ".retail.amd64" utótagot a csomag identitásában, és mostantól egyszerűen csak Microsoft.AnalysisServices és Microsoft.AnalysisServices.AdomdClient néven hívják őket.

A régebbi .NET Framework és .NET Core csomagok továbbra is elérhetők a nuget.org oldalon a korábbi azonosítóval, visszafelé kompatibilitás céljából, a ".retail.amd64" utótaggal a .NET Frameworkhöz, és a ".NetCore.retail.amd64" utótaggal a .NET Core-hoz.

Minimálisan szükséges verziók

A Transport Layer Security (TLS) protokoll 1.0/1.1-es verziója 2021. június 30-án elavult a Microsoft Entra ID-ban. A TLS 1.2 vagy újabb verziójára most már szükség van. A TLS 1.2 nem támogatott az Analysis Services-ügyfélkódtárak korábbi verzióiban. Az újabb ügyfélkódtár-verziók az egyéb fontos biztonsági fejlesztések mellett a TLS 1.2 és újabb verzióit is támogatják.

A kockázatok és a potenciális biztonsági rések minimalizálásához 2021. június 30-tól az Azure Analysis Services és a Power BI fokozott biztonságához a következő vagy újabb verziók szükségesek:

Ügyféloldali lib	Fájl-verzió	Verzió
MSOLAP	2018.151.61.21	15.1.61.21
AMO	15.1.61.21	19.12.3.0
ADOMD	15.1.61.21	19.12.3.0

Szempontok és korlátozások

AMO és ADOMD

A 19.98.0.3-s verziótól kezdve:

• További kapcsolati sztringtulajdonságokkal szabályozható a Entra-Id alapú hitelesítési élmény HTTP-kapcsolatokon keresztül. További információkért tekintse meg a Analysis-Services kapcsolati sztring tulajdonságairól szóló cikket a termékdokumentációban.
• A HTTP-alapú kommunikáció a nyílt HTTP-csatornák jobb kezelésével javul az átviteli rétegben, különösen a .NET Core-kódtárak használatakor.

A 19.94.1.1-es verzió AdomdClient és AMO-csomagjai lecserélik a 19.94.0.0-s verziót. Frissítsen a legújabb verzióra.

A 19.94.1.1-es verzióval:

• Az AMO-csomag TMDL szerializálási beállításainak osztályai bővítménymetóciókat tartalmaznak a használat egyszerűsítése érdekében. További részletekért tekintse meg az API referenciadokumentációját.
• Bizonyos szemantikai modellkészítési forgatókönyvek hibainformációi további részleteket tartalmaznak a kompatibilitási szabálysértésekről és a kereszthivatkozási problémákról:
  • Kompatibilitási szabálysértések: A CompatibilityViolationException osztály részletes információkat tartalmaz az üzenet szövegében a hibaelhárításhoz. További tulajdonságok, például a Támogatott kompatibilitási szint és a CompatibilityLevelRequest is részletesebb információkat nyújtanak.
  • Kereszthivatkozási hibák: A TmdlDeserializationWithReferenceErrorsException és A JsonDeserializationWithReferenceErrorsException osztályok részletes hibaüzeneteket nyújtanak, amelyek felsorolják a megoldatlan tulajdonságokat, és további részleteket nyújtanak a kereszthivatkozási hibákról. Ezek az új kivételosztályok segíthetnek a TMDL és a TMSL deszerializálási problémáinak kezelésében.

A 19.84.6-os verziótól kezdve a .NET FX 4.5 és a .NET Core 3.0 támogatása a felügyelt szerelvényekben már nem érhető el. Az AS ügyféloldali szerelvények mostantól csak a .NET FX 4.7.2, valamint a .NET 6.0 és a .NET 8.0 támogatásával jelennek meg.

A 19.82.0.0-s verziótól kezdve az AMO és az ADOMD támogatja a szolgáltatásnévprofilokat a hitelesítéshez, ahogyan az alábbi kapcsolati sztring példában is látható. További információ: Szolgáltatás főfelhasználói fiókok használata több-bérlős alkalmazások ügyféladatainak kezeléséhez. A felhasználók az XMLA-végponton keresztül nem tudnak csatlakozni a Prémium szintű Per-User-licenchez társított munkaterületekhez szolgáltatásnévprofilok használatával.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

A 19.67.0-s verziótól kezdve az olyan kapcsolati objektumok, mint a Microsoft.AnalysisServices.AdomdClient.AdomdConnection és a Microsoft.AnalysisServices.Server, támogatnak egy új AccessToken tulajdonságot, amely lehetővé teszi a külső OAuth-jogkivonatok XMLA-kapcsolati réteg általi jobb átadását. További információ: Kapcsolati sztring tulajdonságai – Felhasználói azonosító=...; Jelszó=.

A 19.42.0.4-es verziótól kezdve a ADOMD.NET és az AMO/TOM az MSAL (Microsoft.Identity.Client) 4.43.0-s vagy újabb verzióját használja az ADAL helyett a felhasználók Microsoft Entra-azonosítóval való hitelesítéséhez, amikor olyan felhőalapú szolgáltatásokhoz csatlakozik, mint a Power-BI és az Azure Analysis Services. Ha az alkalmazás vagy egy másik összetevő, amelytől az alkalmazás függ, MSAL-t használ, szükség lehet az alkalmazás kötésátirányítási beállításainak frissítésére, ha ütközések vannak az összetevők által betöltött MSAL-verziók között.

AMO és ADOMD .Net Core

A támogatott forgatókönyvek közé tartoznak az Azure Analysis Serviceshez, a Power BI Premiumhoz és az SQL Server Analysis Serviceshez való kapcsolatok. A TCP-alapú kapcsolat csak Windows rendszerű számítógépeken támogatott.

Az interaktív bejelentkezés a Microsoft Entra-azonosítóval csak Windows rendszerű számítógépeken támogatott. A .NET Core Desktop-futtatókörnyezet szükséges.

Az MSAL használatához a 4.43.0-s vagy annál újabb verzió szükséges.

A .Net Core-ügyfélkódtárak 19.14.0-s verziója előzetes verziójú támogatást vezetett be Self-Contained közzétételhez (közzétett címtárban és egyfájlos módban is), a .NET 5.0-projektek általi felhasználás támogatása mellett. Az ELŐZŐ kiadásban azonosított SQL Server Analysis Serviceshez való kapcsolódással kapcsolatos számos problémát kijavítottunk.

A .Net Core-ügyfélkódtárak 19.12.7.2-es verziója bevezette az SQL Server Analysis Services támogatását. Az alacsonyabb előzetes verziók csak az Azure Analysis Servicest és a Power BI szemantikai modelleket támogatták.

AMO

A 19.98.0.3-s verziótól kezdve a táblázatos modelladatbázisok alapértelmezett kompatibilitási szintje 1700. Azon adatbázisok esetén, amelyeknél nem adnak meg explicit módon kompatibilitási szintet, az alapértelmezett szint az 1700.

A 19.84.6-os verziótól kezdve az AMO\TOM TMDL-támogatása General-Availability állapotnak minősül, és az API-felületen nem lesznek kompatibilitástörő változások.

Az AMO-ügyfélkódtár 19.12.3.0-s verziója új enumerálást vezet be, Microsoft.AnalysisServices.DataType. Azonban a korábbi felsorolás, Microsoft.AnalysisServices.Tabular.DataType továbbra is létezik. Ha a kód az előző számbavételre hivatkozik DataType egy kódfájlban, amely mindkét névtérre (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular) hivatkozik, a kétértelműség miatt a fordítás során hibaüzenet jelenhet meg. A hiba megoldásához teljes mértékben minősítse az enumerálásra mutató hivatkozást.

Az AMO-ügyfélkódtár 19.61.1.4-es verziója megváltoztatja Microsoft.AnalysisServices.Servertranzakció-visszaállítási viselkedését. A korábbi verziókban a Server.RollbackTransaction() hívása kérést küld a motornak a tranzakció visszaállítására, majd megkísérelni a helyi módosítások visszaállítását. A korábbi verzióktól eltérően a 19.61.1.4-ben és újabb verziókban, ha a helyi módosítások nem állíthatók vissza biztonságosan, a tranzakcióban szereplő táblázatos adatbázisok blokkolják a további módosításokat, amíg azok teljesen szinkronizálhatók, és a visszaállított tranzakció elavult módosításai el nem távolíthatók. InvalidOperationException fordul elő, amikor módosítás történik a megfelelő táblázatos adatbázisban. Ha a kód meghívja a Server.RollbackTransaction() függvényt, javasoljuk, hogy kövesse azt egy teljes szinkronizálással a [Database.Refresh(true)] függvénnyel, bármely tranzakció során módosított táblázatos adatbázis esetén.

A 19.77.0-s verziótól kezdődően, amikor a MetaadataObject egy metaadat-objektum egy másik példányába a táblázatos objektummodell (TOM) használatával klónoz vagy másol, a TOM null értéket ad vissza azon tulajdonságok esetében, amelyek a Metaadatobject gyermekobjektumainak közvetlen fáján kívül lévő objektumokra hivatkoznak. Hozzá kell adnia a klónozott MetadataObject-példányt a szemantikai modellhez, hogy a MetadataObject fán kívüli objektumokra mutató kereszthivatkozások feloldhatók legyenek.

Ha például egy partícióval rendelkező táblát klónoz, amely hivatkozik egy kifejezésre az EntityPartitionSource-ban, az EntityPartitionSource ExpressionSource tulajdonsága null értéket ad vissza, amíg a klónozott tábla hozzá nem adódik a szemantikai modellhez, az alábbi kódrészletben bemutatott módon, így a klónozott ExpressionSource referencia feloldható. A klónt hozzá kell adni a modellhez, mert a kereszthivatkozású elnevezett kifejezés a modell Kifejezések gyűjteményének tagja, és nem része a tábla gyermekobjektumok fájának.

Table tableClone = model.Tables[0].Clone();
anotherModel.Tables.Add(tableClone);

ADOMD

Az ADOMD (mind a .NET Framework, mind a .NET Core) 19.61.1.4-es verziójától kezdve a tömörítés teljes mértékben elérhető az XMLA átviteli rétegben. A korábbi kiadások a 19.55.3.1-es verzió után részlegesen támogatták a tömörítést. Jelentések érkeztek a kiadásokkal kapcsolatos problémákról. Ezeket a problémákat a 16.61.1.4-es kiadás részeként javítottuk. Ha tömörítéssel kapcsolatos problémákat tapasztal, frissítsen a 19.61.1.4-re vagy újabb verzióra.

MSOLAP

A 17.0.25.23-tól kezdődően további kapcsolati sztringtulajdonságok is használhatók a Entra-Id alapú hitelesítés HTTP-kapcsolatokon keresztüli vezérléséhez. További információkért tekintse meg a Analysis-Services kapcsolati sztring tulajdonságairól szóló cikket a termékdokumentációban.

A 16.0.139.27-es verziótól kezdve az MSOLAP támogatja a szolgáltatásnév-profilokat a hitelesítéshez, ahogyan az alábbi kapcsolati sztring példában is látható. További információ: Szolgáltatás főfelhasználói fiókok használata több-bérlős alkalmazások ügyféladatainak kezeléséhez.

Data Source=powerbi://api.powerbi.com/v1.0/myorg/<WorkspaceName>;User ID=app:<service principal id>@<tenant id>;SPN Profile=<service-principal profile id>;Password=<service-principal's secret>

A 16.0.134.22-es verziótól kezdve az MSOLAP támogatja a csendes egyszeri Sign-On (SSO) használatát a Web Account Manager (WAM) használatával, amely Windows 10-es és újabb verziókban, valamint a Windows Server 2019-es és újabb verzióiban érhető el. Új HTTP-kapcsolat megnyitásakor az MSOLAP az alábbiak szerint szerez be hozzáférési jogkivonatot:

1. Ha a jogkivonat gyorsítótárazása engedélyezve van, és megfelelő jogkivonat érhető el a gyorsítótárban, az MSOLAP a gyorsítótárazott jogkivonatot használja.
2. Ha nem érhető el megfelelő gyorsítótárazott jogkivonat, az MSOLAP észrevétlenül megkísérli beszerezni a hozzáférési jogkivonatot a WAM rendszeren keresztül.
3. Ha a WAM-et használó egyszeri bejelentkezés sikertelen, az MSOLAP visszakerül az interaktív hitelesítésre, és felugrik a bejelentkezési ablak.

A felhasználók megkerülhetik a csendes egyszeri bejelentkezés folyamatát, és azonnal elindíthatják az interaktív hitelesítési felületet úgy, hogy megadnak egy "üres" felhasználói azonosítót a kapcsolati sztringben (User ID=').

A 16.0.43.20-es verziótól kezdve az MSOLAP az MSAL (Microsoft.Identity.Client) 4.43.0-s vagy újabb verzióját használja az ADAL helyett a felhasználók Microsoft Entra-azonosítóval való hitelesítéséhez, amikor kapcsolatot létesít a felhőalapú szolgáltatásokkal, például a Power-BI és az Azure Analysis Services szolgáltatással. Ha az alkalmazás vagy egy másik összetevő, amelytől az alkalmazás függ, MSAL-t használ, szükség lehet az alkalmazás kötésátirányítási beállításainak frissítésére, ha ütközések vannak az összetevők által betöltött MSAL-verziók között

Az OLEDB (MSOLAP) 16.0.4.17-es verziójában felfedezték a Microsoft Entra ID-t használó felhőalapú rendszerekhez való csatlakozással kapcsolatos regressziót. A javítás a 16.0.20.201-es verzióban történt. A probléma jellegéből adódóan a telepített 16.0.4.17-es verzió, valamint a 201.0.20.16.20.201 előtti verziók nem javíthatók a szolgáltató fölérendelésével, még akkor sem, ha a telepítő javító módban fut. Javasoljuk, hogy teljesen távolítsa el a 16.0.4.17 [vagy más problémás] verziót, majd telepítse a 16.0.20.20.201-es vagy újabb verziót.

Egy korábbi kiadásban az MSOLAP frissült, hogy a felügyelt Microsoft Authentication Library (MSAL) használatával csatlakozzon a felhőalapú Analysis Serviceshez. A 16.0.87.16-os verziótól kezdve az MSOLAP telepítője már nem telepíti az eredeti natív Azure Active Directory Authentication Library (ADAL) összetevőt.

Az ügyfélkódtárak ismertetése

Az Analysis Services három ügyfélkódtárat használ. A ADOMD.NET és az Analysis Services Management Objects (AMO) felügyelt ügyfélkódtárak. Az Analysis Services OLE DB Provider (MSOLAP DLL) pedig egy natív ügyfélkódtár. Általában mindhárom telepítése egyszerre történik.

A Microsoft-ügyfélalkalmazások, például a Power BI Desktop és az Excel mindhárom ügyfélkódtárat telepítik, és frissítik őket, ha új verziók érhetők el. A frissítések verziójától vagy gyakoriságától függően előfordulhat, hogy egyes ügyfélkódtárak nem az Azure Analysis Services és a Power BI által igényelt legújabb verziók. Ugyanez vonatkozik az egyéni alkalmazásokra vagy más felületekre, például az AsCmdre, a TOM-ra és a ADOMD.NET. Ezekhez az alkalmazásokhoz manuálisan vagy programozott módon kell telepíteni a kódtárakat. A manuális telepítéshez szükséges ügyfélkódtárak terjeszthető csomagokként szerepelnek az SQL Server szolgáltatáscsomagjaiban. Ezek az ügyfélkódtárak azonban az SQL Server verziójához vannak kötve, és nem feltétlenül a legújabbak. Győződjön meg arról, hogy mindig a legújabb, letölthető elemet telepíti ebből a cikkből.

Ügyfélkódtár-típusok

Analysis Services OLE DB-szolgáltató (MSOLAP)

Az Analysis Services OLE DB Provider (MSOLAP) az Analysis Services-adatbáziskapcsolatok natív ügyfélkódtára. A ADOMD.NET és az AMO is közvetetten használja, és delegálja a kapcsolatkéréseket az adatszolgáltatónak. Az OLE DB-szolgáltatót közvetlenül az alkalmazáskódból is meghívhatja.

Az Analysis Services OLE DB-szolgáltatót a legtöbb, az Analysis Services-adatbázisok eléréséhez használt eszköz és ügyfélalkalmazás automatikusan telepíti. Az Analysis Services-adatok eléréséhez használt számítógépeken kell telepíteni.

Az OLE DB-szolgáltatók gyakran a kapcsolati sztringekben vannak megadva. Az Analysis Services kapcsolati sztringje eltérő elnevezést használ az OLE DB-szolgáltatóra való hivatkozáshoz: MSOLAP.<verziószám>.dll.

AMO

Az AMO egy felügyelt ügyfélkódtár, amelyet a kiszolgálófelügyelethez és az adatdefinícióhoz használnak. Eszközök és ügyfélalkalmazások által telepítve és használva van. Az SQL Server Management Studio (SSMS) például az AMO használatával csatlakozik az Analysis Serviceshez. Az AMO használatával létrejött kapcsolatok általában minimálisak, "data source=\<servername>". A kapcsolat létrejötte után az API-val adatbázis-gyűjteményekkel és fő objektumokkal dolgozhat. Mind a Visual Studio, mind az SSMS az AMO használatával csatlakozik egy Analysis Services-példányhoz.

ADOMD

ADOMD.NET az Analysis Services-adatok lekérdezéséhez használt felügyelt adatügyfél-kódtár. Eszközök és ügyfélalkalmazások által telepítve és használva van.

Adatbázishoz való csatlakozáskor mindhárom kódtár kapcsolati sztringtulajdonságai hasonlóak. Az ADOMD.NET Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString használatával definiált kapcsolati sztringek szinte mindegyike az AMO-hoz és az Analysis Services OLE DB-szolgáltatóhoz (MSOLAP) is használható. További információ: Kapcsolati karakterlánc tulajdonságai.

Telepített verziók ellenőrzése

OLEDDB (MSOLAP)

1. Menj a C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Ha több mappája van, válassza a magasabb számot.

2. Kattintson a jobb gombbal msolap.dll>Tulajdonságok>Részletek. Ellenőrizze a termék verzió tulajdonságot. Megjegyzés: Ha a fájlnév msolap140.dll, az régebbi a legújabb verziónál, és frissíteni kell.

   

AMO

1. Menj a C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Ha több mappája van, válassza a magasabb számot.

2. Kattintson a jobb gombbal Microsoft.AnalysisServices>Tulajdonságok>Részletekelemre.

   

ADOMD

1. Menj a C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Ha több mappája van, válassza a magasabb számot.

2. Kattintson a jobb gombbal Microsoft.AnalysisServices.AdomdClient>Tulajdonságok>Részletekelemre.

   

Manuális frissítés

Az ügyfélkódtárak általában automatikusan települnek és frissülnek az őket használó eszközökkel és ügyfélalkalmazásokkal együtt. Bizonyos esetekben azonban előfordulhat, hogy az ügyfélkódtárak nem frissülnek automatikusan, és mindegyiket manuálisan kell frissíteni. A manuális frissítéshez töltse le és futtassa a Windows Installer (.msi) csomagot az egyes ügyfélkódtárakhoz.

Letöltés és frissítés

1. Kattintson:

   • MSOLAP (amd64) vagy Letöltés MSOLAP (x86)
   • AMO- letöltése
   • ADOMD- letöltése

2. A Letöltésekterületen kattintson egy Windows Installer-csomagra a telepítő futtatásához.

3. A Telepítőben kattintson a Továbbgombra.

4. Olvassa el a licencszerződést. Ha elfogadja, válassza Elfogadom a licencszerződésben szereplő feltételeket, majd kattintson a Továbbgombra.

5. Kattintson, Telepítse.

6. Miután befejezte, kattintson a Befejezésgombra.