Analysis Services-clientbibliotheken

van toepassing op: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Clientbibliotheken zijn nodig voor clienttoepassingen en hulpprogramma's om verbinding te maken met Analysis Services. Microsoft-clienttoepassingen zoals Power BI Desktop, Excel, SQL Server Management Studio (SSMS) en analysis Services-projecten voor Visual Studio installeren alle drie de clientbibliotheken en werken ze bij, samen met regelmatige toepassingsupdates. Voor aangepaste clienttoepassingen voor Analysis Services moet mogelijk ook een of meer van deze clientbibliotheken worden geïnstalleerd. Nieuwe versies van de clientbibliotheken worden ongeveer maandelijks bijgewerkt.

Belangrijk: Zie Overwegingen en beperkingenvoordat u de nieuwste versies krijgt.

Download de nieuwste versie

Windows Installer

Downloaden	Versie
MSOLAP (amd64)	17.0.4.15
MSOLAP (x86)	17.0.4.15
AMO-	19.84.1.0
ADOMD	19.84.1.0

Opmerking: De Windows Installer-downloads voor Analysis Services Management Objects (AMO/TOM) en ADOMD worden niet meer bijgewerkt en zijn na 31 december 2024 niet meer beschikbaar. Toepassingen die afhankelijk zijn van deze Windows Installer-downloads, moeten worden gemigreerd naar NuGet-pakketten.

NuGet-pakketten

Analysis Services Management Objects (AMO/TOM) en ADOMD-clientbibliotheken zijn beschikbaar als installeerbare pakketten van NuGet.org. Het is raadzaam om te migreren naar NuGet-verwijzingen in plaats van windows Installer te gebruiken.

NuGet-pakketassembly's AssemblyVersion volgen semantische versiebeheerprincipes: MAJOR.MINOR.PATCH. NuGet-verwijzingen laden de verwachte versie, zelfs als er een andere versie is in de GAC (als gevolg van MSI-installatie). PATCH wordt verhoogd voor elke release. AMO- en ADOMD-versies worden gesynchroniseerd.

Vanaf juli 2024 bevatten de AMO- en ADOMD-pakketten meerdere runtime-releases voor alle ondersteunde doelruntimes, zowel .NET FX als .NET Core; eerdere versies van de pakketten waarop slechts één runtime is gericht, ofwel .NET FX of .NET Core, zijn beschikbaar voor achterwaartse compatibiliteit, maar worden niet meer bijgewerkt.

Vanaf september 2022 zijn AMO (AMO/TOM) en ADOMD .Net Core (versie 19.48.0.0), http-gebaseerde communicatie met cloudservices zoals Power BI en Azure Analysis Services aanzienlijk verbeterd. Het is raadzaam om bij te werken naar de nieuwste versie om te profiteren van de prestatieverbeteringen.

Vanaf februari 2021 is .NET Core runtime-ondersteuning beschikbaar voor de AMO- en ADOMD-clientpakketten. Er zijn echter enkele scenario's die niet worden ondersteund door de .NET Core-versies. Zie overwegingen en beperkingen verderop in dit artikel voor meer informatie.

AMO en ADOMD

Pakket	Versie
AMO-	19.87.7.0
ADOMD	19.87.7.0

Opmerking:

De nieuwe multi-runtime-pakketten hebben niet langer het achtervoegsel '.retail.amd64' in de pakketidentiteit en worden nu gewoon Microsoft.AnalysisServices en Microsoft.AnalysisServices.AdomdClient genoemd.

De oudere .NET Framework- en .NET Core-pakketten zijn nog steeds beschikbaar in nuget.org voor achterwaartse compatibiliteit onder de oude identiteit met het achtervoegsel .retail.amd64 voor .NET Framework en de '. NetCore.retail.amd64" achtervoegsel voor .NET Core.

Minimaal vereiste versies

Tls-protocolversie 1.0/1.1 (Transport Layer Security) is op 30 juni 2021 afgeschaft in Microsoft Entra-id. TLS 1.2 of hoger is nu vereist. TLS 1.2 wordt niet ondersteund in eerdere versies van de Analysis Services-clientbibliotheken. Nieuwere clientbibliotheekversies omvatten ondersteuning voor TLS 1.2 en hoger, naast andere belangrijke beveiligingsverbeteringen.

Om risico's en potentiële beveiligingsproblemen te minimaliseren, moet vanaf 30 juni 2021 verbeterde beveiliging in Azure Analysis Services en Power BI de volgende of hogere versies hebben:

Client lib	Bestandsversie	Versie
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

Overwegingen en beperkingen

AMO en ADOMD

Vanaf versie 19.84.6 zijn de ondersteuning voor .NET FX 4.5 en .NET Core 3.0 in de beheerde assembly's niet meer beschikbaar. AS-assembly's aan de clientzijde worden nu uitgebracht met ondersteuning voor .NET FX 4.7.2, evenals alleen .NET 6.0 en .NET 8.0.

Vanaf versie 19.82.0.0 ondersteunen AMO en ADOMD service-principalprofielen voor verificatie, zoals in het volgende verbindingsreeksvoorbeeld. Zie Service Principal-profielen gebruiken voor het beheren van klantgegevens in multitenant-appsvoor meer informatie. Gebruikers kunnen geen verbinding maken met werkruimten die zijn gekoppeld aan een Premium-Per-User-licentie met behulp van Service Principal Profiles via het XMLA-eindpunt.

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>

Vanaf versie 19.67.0 ondersteunen connectiviteitsobjecten zoals Microsoft.AnalysisServices.AdomdClient.AdomdConnection en Microsoft.AnalysisServices.Server een nieuwe eigenschap AccessToken waarmee externe OAuth-tokens kunnen worden doorgegeven die door de XMLA-connectiviteitslaag kunnen worden gebruikt. Voor meer informatie, zie Eigenschappen van verbindingsreeks - Gebruikers-id=...; Wachtwoord=.

Vanaf versie 19.42.0.4 gebruiken ADOMD.NET en AMO/TOM MSAL (Microsoft.Identity.Client) versie 4.43.0 of hoger in plaats van ADAL om gebruikers te verifiëren met Microsoft Entra ID bij het tot stand brengen van een verbinding met cloudservices zoals Power-BI en Azure Analysis Services. Als uw toepassing of een ander onderdeel waarvan de toepassing afhankelijk is, MSAL gebruikt, kan het nodig zijn om de bindingsomleidingsinstellingen van de toepassing bij te werken als er conflicten zijn tussen de versies van MSAL die door de onderdelen zijn geladen.

AMO en ADOMD .NET Core

Ondersteunde scenario's zijn verbindingen met Azure Analysis Services, Power BI Premium en SQL Server Analysis Services. Tcp-connectiviteit wordt alleen ondersteund voor Windows-computers.

Interactieve aanmelding met Microsoft Entra-id wordt alleen ondersteund voor Windows-computers. De .NET Core Desktop-runtime is vereist.

Voor afhankelijkheid in MSAL is versie 4.43.0 of hoger vereist.

Versie 19.14.0 van de .Net Core-clientbibliotheken heeft preview-ondersteuning geïntroduceerd voor Self-Contained publiceren (zowel in een gepubliceerde map als in de modus voor één bestand), naast ondersteuning voor verbruik door .NET 5.0-projecten. Er zijn verschillende problemen opgelost met betrekking tot connectiviteit met SQL Server Analysis Services die zijn geïdentificeerd in de vorige release.

Versie 19.12.7.2 van de .Net Core-clientbibliotheken heeft ondersteuning geïntroduceerd voor SQL Server Analysis Services. Lagere preview-versies ondersteunen alleen Azure Analysis Services en semantische Power BI-modellen.

AMO

Vanaf versie 19.84.6 wordt de ondersteuning voor TMDL in AMO\TOM beschouwd als zijnde in de General-Availability-status, en zullen er geen grote wijzigingen plaatsvinden in de API-oppervlakte.

Versie 19.12.3.0 van de AMO-clientbibliotheek introduceert een nieuwe opsomming, Microsoft.AnalysisServices.DataType. Maar de vorige opsomming, Microsoft.AnalysisServices.Tabular.DataType, bestaat nog steeds. Als uw code verwijst naar de vorige opsomming als DataType in een codebestand met statements voor beide naamruimten (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular), kan bij het compileren een fout optreden. Als u de fout wilt oplossen, moet u de verwijzing naar de opsomming volledig kwalificeren.

Versie 19.61.1.4 van de AMO-clientbibliotheek introduceert een wijziging in het terugdraaien van transacties van Microsoft.AnalysisServices.Server. In eerdere versies stuurt een aanroep naar Server.RollbackTransaction() een aanvraag naar de engine om de transactie terug te draaien en vervolgens lokale wijzigingen terug te draaien. In tegenstelling tot eerdere versies, als lokale wijzigingen niet veilig kunnen worden teruggedraaid, blokkeren tabellaire databases in 19.61.1.4 en hoger die zijn opgenomen in het transactieblok alle aanvullende wijzigingen totdat ze volledig kunnen worden gesynchroniseerd en de verouderde wijzigingen die uit de teruggedraaide transactie zijn verwijderd. Er wordt een InvalidOperationException- gegenereerd wanneer er een wijziging wordt aangebracht in de relevante tabellaire database. Als uw code Server.RollbackTransaction()aanroept, is het raadzaam deze aanroep te volgen met een volledige synchronisatie [Database.Refresh(true)] voor elke tabellaire database die wordt gewijzigd als onderdeel van de transactie.

Vanaf versie 19.77.0 retourneert TOM null voor eigenschappen wanneer een MetadataObject wordt gekloond of gekopieerd naar een ander exemplaar van een MetadataObject met behulp van het Tabular Object Model (TOM), als deze eigenschappen verwijzen naar objecten buiten de directe structuur van het MetadataObject van onderliggende objecten. U moet het gekloonde MetadataObject-exemplaar toevoegen aan het semantische model, zodat kruisverwijzingen naar objecten buiten de structuur MetadataObject kunnen worden omgezet.

Wanneer u bijvoorbeeld een tabel kloont met een partitie die verwijst naar een benoemde expressie in een EntityPartitionSource, retourneert de eigenschap ExpressionSource van entityPartitionSource null totdat de gekloonde tabel is toegevoegd aan het semantische model, zoals in het onderstaande codefragment, zodat de gekloonde ExpressionSource-verwijzing kan worden omgezet. De kloon moet worden toegevoegd aan het model omdat de benoemde expressie waarnaar wordt verwezen, een onderdeel is van de Expressies-verzameling van het model en niet deel uitmaakt van de hiërarchie van onderliggende objecten van de tabel.

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

ADOMD

Vanaf ADOMD (zowel .NET Framework als .NET Core) versie 19.61.1.4 is compressie volledig beschikbaar in de XMLA-transportlaag. Vorige versies na versie 19.55.3.1 hebben gedeeltelijke ondersteuning voor compressie geïmplementeerd. Rapporten over problemen met deze releases zijn ontvangen. Deze problemen zijn opgelost als onderdeel van de release 16.61.1.4. Zorg ervoor dat u een upgrade uitvoert naar 19.61.1.4 of hoger als u problemen ondervindt met betrekking tot compressie.

MSOLAP

Vanaf versie 16.0.139.27 ondersteunt MSOLAP Service Principal Profiles voor verificatie, zoals in het volgende verbindingsreeksvoorbeeld. Zie Service Principal-profielen gebruiken voor het beheren van klantgegevens in multitenant-appsvoor meer informatie.

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>

Vanaf versie 16.0.134.22 ondersteunt MSOLAP stille Single Sign-On (SSO) met Web Account Manager (WAM), beschikbaar in Windows 10 en hoger, evenals Windows Server 2019 en hoger. Wanneer een nieuwe HTTP-verbinding wordt geopend, verkrijgt MSOLAP als volgt een toegangstoken:

1. Als tokencaching is ingeschakeld en een geschikt token beschikbaar is in de cache, gebruikt MSOLAP het token in de cache.
2. Als er geen geschikt token in de cache beschikbaar is, probeert MSOLAP stilletjes een toegangstoken te verkrijgen via WAM.
3. Als eenmalige aanmelding met WAM is mislukt, valt MSOLAP terug op interactieve verificatie en verschijnt het inlogvenster.

Gebruikers kunnen de stille SSO-stroom omzeilen en de interactieve verificatie onmiddellijk starten door een 'lege' gebruikers-id op te geven in de verbindingsreeks (gebruikers-id=').

Vanaf versie 16.0.43.20 gebruikt MSOLAP MSAL (Microsoft.Identity.Client) versie 4.43.0 of hoger in plaats van ADAL om gebruikers te verifiëren met Microsoft Entra-id bij het tot stand brengen van een verbinding met cloudservices zoals Power-BI en Azure Analysis Services. Als uw toepassing of een ander onderdeel waarvan de toepassing afhankelijk is, MSAL gebruikt, kan het nodig zijn om de bindingsomleidingsinstellingen van de toepassing bij te werken als er conflicten zijn tussen de versies van MSAL die door de onderdelen zijn geladen

Er is een regressie met betrekking tot verbindingen met cloudsystemen met behulp van Microsoft Entra-id gedetecteerd in de versie 16.0.4.17 van OLEDB (MSOLAP). Het is opgelost in de versie 16.0.20.201. Vanwege de aard van het probleem, kan een geïnstalleerde versie 16.0.4.17, evenals een andere versie vóór 16.0.20.201, niet worden gecorrigeerd door de provider te verbeteren, zelfs als setup wordt uitgevoerd in de reparatiemodus. Het is raadzaam om de versie 16.0.4.17 [of een andere problematische] volledig te verwijderen en vervolgens de versie 16.0.20.201 of hoger te installeren.

In een eerdere release is MSOLAP bijgewerkt om verbinding te maken met Analysis Services in de cloud met behulp van de beheerde Microsoft Authentication Library (MSAL). Vanaf versie 16.0.87.16 installeert MSOLAP-setup niet langer het oorspronkelijke systeemeigen Azure Active Directory-verificatiebibliotheek (ADAL)-onderdeel.

Inzicht in clientbibliotheken

Analysis Services maakt gebruik van drie clientbibliotheken. ADOMD.NET en Analysis Services Management Objects (AMO) zijn beheerde clientbibliotheken. Analysis Services OLE DB Provider (MSOLAP DLL) is een systeemeigen clientbibliotheek. Normaal gesproken worden alle drie tegelijkertijd geïnstalleerd.

Microsoft-clienttoepassingen zoals Power BI Desktop en Excel installeren alle drie de clientbibliotheken en werken ze bij wanneer er nieuwe versies beschikbaar zijn. Afhankelijk van de versie of frequentie van updates zijn sommige clientbibliotheken mogelijk niet de nieuwste versies die vereist zijn voor Azure Analysis Services en Power BI. Hetzelfde geldt voor aangepaste toepassingen of andere interfaces, zoals AsCmd, TOM, ADOMD.NET. Voor deze toepassingen moet u de bibliotheken handmatig of programmatisch installeren. De clientbibliotheken voor handmatige installatie zijn opgenomen in SQL Server-functiepakketten als distribueerbare pakketten. Deze clientbibliotheken zijn echter gekoppeld aan de SQL Server-versie en zijn mogelijk niet de meest recente. Zorg ervoor dat u altijd de meest recente, downloadbare versie van dit artikel installeert.

Typen clientbibliotheek

Analysis Services OLE DB Provider (MSOLAP)

Analysis Services OLE DB Provider (MSOLAP) is de systeemeigen clientbibliotheek voor Analysis Services-databaseverbindingen. Het wordt indirect gebruikt door zowel ADOMD.NET als AMO, waarbij verbindingsaanvragen worden gedelegerd aan de gegevensprovider. U kunt de OLE DB-provider ook rechtstreeks vanuit de toepassingscode aanroepen.

De Ole DB-provider van Analysis Services wordt automatisch geïnstalleerd door de meeste hulpprogramma's en clienttoepassingen die worden gebruikt voor toegang tot Analysis Services-databases. Deze moet worden geïnstalleerd op computers die worden gebruikt voor toegang tot Analysis Services-gegevens.

OLE DB-providers worden vaak opgegeven in verbindingsreeksen. Een Analysis Services-verbindingsreeks maakt gebruik van een andere nomenclatuur om te verwijzen naar de OLE DB-provider: MSOLAP.<versie>.dll.

AMO

AMO is een beheerde clientbibliotheek die wordt gebruikt voor serverbeheer en gegevensdefinitie. Het wordt geïnstalleerd en gebruikt door hulpprogramma's en clienttoepassingen. SQL Server Management Studio (SSMS) gebruikt bijvoorbeeld AMO om verbinding te maken met Analysis Services. Een verbinding met AMO is doorgaans minimaal, bestaande uit "data source=\<servername>". Nadat een verbinding tot stand is gebracht, gebruikt u de API om te werken met databaseverzamelingen en primaire objecten. Visual Studio en SSMS gebruiken AMO om verbinding te maken met een Analysis Services-exemplaar.

ADOMD

ADOMD.NET is een beheerde gegevensclientbibliotheek die wordt gebruikt voor het uitvoeren van query's op Analysis Services-gegevens. Het wordt geïnstalleerd en gebruikt door hulpprogramma's en clienttoepassingen.

Wanneer u verbinding maakt met een database, zijn de eigenschappen van de verbindingsreeks voor alle drie de bibliotheken vergelijkbaar. Bijna elke verbindingsreeks die u definieert voor ADOMD.NET met behulp van Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString werkt ook voor AMO en de ANALYSIS Services OLE DB Provider (MSOLAP). Zie eigenschappen van verbindingsreeksenvoor meer informatie.

Geïnstalleerde versies controleren

OLEDDB (MSOLAP)

1. Ga naar C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Als u meer dan één map hebt, kiest u het hogere getal.

2. Klik met de rechtermuisknop op msolap.dll>Eigenschappen>Details. Controleer de eigenschap Productversie. Opmerking: Als de bestandsnaam is msolap140.dll, is deze ouder dan de nieuwste versie en moet worden bijgewerkt.

   

AMO

1. Ga naar C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Als u meer dan één map hebt, kiest u het hogere getal.

2. Klik met de rechtermuisknop op Microsoft.AnalysisServices>Properties>Details.

   

ADOMD

1. Ga naar C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Als u meer dan één map hebt, kiest u het hogere getal.

2. Klik met de rechtermuisknop op Microsoft.AnalysisServices.AdomdClient>Properties>Details.

   

Handmatig bijwerken

Clientbibliotheken worden doorgaans automatisch geïnstalleerd en bijgewerkt, samen met hulpprogramma's en clienttoepassingen die deze gebruiken. In sommige gevallen worden clientbibliotheken echter niet automatisch bijgewerkt en moeten ze handmatig worden bijgewerkt. Als u handmatig wilt bijwerken, downloadt en voert u het Windows Installer-pakket (.msi) uit voor elke clientbibliotheek.

Downloaden en bijwerken

1. Klik:

   • MSOLAP (amd64) of MSOLAP(x86) downloaden
   • AMO- downloaden
   • ADOMD downloaden

2. Klik in downloadsop een Windows Installer-pakket om Setup uit te voeren.

3. Klik in Setup op Volgende.

4. Lees de gebruiksrechtovereenkomst. Als u akkoord gaat, selecteert u ik ga akkoord met de voorwaarden in de gebruiksrechtovereenkomsten klikt u vervolgens op Volgende.

5. Klik, installeren.

6. Wanneer u klaar bent, klikt u op voltooien.