Freigeben über

Analysis Services-Clientbibliotheken

  • Artikel

gilt für: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Clientbibliotheken sind für Clientanwendungen und Tools erforderlich, um eine Verbindung mit Analysis Services herzustellen. Microsoft-Clientanwendungen wie Power BI Desktop, Excel, SQL Server Management Studio (SSMS) und Analysis Services-Projekteerweiterung für Visual Studio installieren alle drei Clientbibliotheken und aktualisieren sie zusammen mit regelmäßigen Anwendungsupdates. Möglicherweise müssen auch benutzerdefinierte Clientanwendungen für Analysis Services eine oder mehrere dieser Clientbibliotheken installiert werden. Neue Versionen der Clientbibliotheken werden ungefähr monatlich aktualisiert.

Wichtig: Bevor Sie die neuesten Versionen erhalten, achten Sie darauf, Überlegungen und Einschränkungenzu sehen.

Herunterladen der neuesten

Windows Installer

Herunterladen Version
MSOLAP (amd64) 16.0.160.18
MSOLAP (x86) 16.0.160.18
AMO- 19.84.1.0
ADOMD- 19.84.1.0

Hinweis: Das Windows Installer-Downloads für Analysis Services Management Objects (AMO/TOM) und ADOMD werden nicht mehr aktualisiert und sind nach dem 31. Dezember 2024 nicht mehr verfügbar. Anwendungen, die auf diesen Windows Installer-Downloads vertrauen, sollten zu NuGet-Paketen migriert werden.

NuGet-Pakete

Analysis Services Management Objects (AMO/TOM) und ADOMD-Clientbibliotheken sind als installierbare Pakete aus NuGet.orgverfügbar. Es wird dringend empfohlen, zu NuGet-Verweisen zu migrieren, anstatt windows Installer zu verwenden.

NuGet-Paketassemblys AssemblyVersion folgen der semantischen Versionsverwaltung: MAJOR. KLEINER. FLICKEN. NuGet-Verweise laden die erwartete Version auch dann, wenn es eine andere Version im GAC gibt (die sich aus der MSI-Installation ergibt). PATCH wird für jede Version erhöht. AMO- und ADOMD-Versionen werden synchronisiert.

Ab Juli 2024 enthalten die AMO- und ADOMD-Pakete mehrere Laufzeitversionen für alle unterstützten Ziellaufzeiten, sowohl .NET FX als auch .NET Core; frühere Versionen der Pakete, die nur auf eine einzelne Laufzeit ausgerichtet sind, entweder .NET FX oder .NET Core, sind für Abwärtskompatibilität verfügbar, aber nicht mehr aktualisiert.

Ab September 2022 werden AMO (AMO/TOM) und ADOMD .Net Core (Version 19.48.0.0) http-basierte Kommunikation mit Clouddiensten wie Power BI und Azure Analysis Services erheblich verbessert. Es wird empfohlen, auf die neueste Version zu aktualisieren, um die Leistungsverbesserungen zu nutzen.

Ab Februar 2021 steht .NET Core Laufzeitunterstützung für die AMO- und ADOMD-Clientpakete zur Verfügung. Es gibt jedoch einige Szenarien, die von den .NET Core-Versionen nicht unterstützt werden. Weitere Informationen finden Sie unter Überlegungen und Einschränkungen weiter unten in diesem Artikel.

AMO und ADOMD

Paket Version
AMO- 19.86.6.0
ADOMD- 19.86.6.0

Hinweis:

Die neuen Multi-Runtime-Pakete verfügen nicht mehr über das Suffix ".retail.amd64" in der Paketidentität und heißen jetzt einfach "Microsoft.AnalysisServices" und "Microsoft.AnalysisServices.AdomdClient".

Die älteren .NET Framework- und .NET Core-Pakete sind weiterhin in nuget.org zur Abwärtskompatibilität unter der alten Identität mit dem Suffix ".retail.amd64" für .NET Framework und ". NetCore.retail.amd64"-Suffix für .NET Core.

Mindestens erforderliche Versionen

Transport Layer Security (TLS)-Protokollversion 1.0/1.1 wurde am 30. Juni 2021 veraltete in Microsoft Entra ID. TLS 1.2 oder höher ist jetzt erforderlich. TLS 1.2 wird in früheren Versionen der Analysis Services-Clientbibliotheken nicht unterstützt. Neuere Clientbibliotheksversionen umfassen zusätzlich zu anderen wichtigen Sicherheitsverbesserungen Unterstützung für TLS 1.2 und höher.

Um Risiken und potenzielle Sicherheitsrisiken zu minimieren, erfordern ab dem 30. Juni 2021 erweiterte Sicherheit in Azure Analysis Services und Power BI die folgenden oder höheren Versionen:

Client lib Dateiversion Version
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

Überlegungen und Einschränkungen

AMO und ADOMD

Ab Version 19.84.6 sind die Unterstützung für .NET FX 4.5 und .NET Core 3.0 in den verwalteten Assemblys nicht mehr verfügbar. AS-clientseitige Assemblys werden jetzt mit Unterstützung für .NET FX 4.7.2 sowie .NET 6.0 und .NET 8.0 veröffentlicht.

Ab Version 19.82.0.0 unterstützen AMO und ADOMD Dienstprinzipalprofile für die Authentifizierung, wie im folgenden Beispiel für die Verbindungszeichenfolge. Weitere Informationen finden Sie unter Verwenden von Dienstprinzipalprofilen zum Verwalten von Kundendaten in mehrinstanzenfähige Apps. Benutzer können keine Verbindung mit Arbeitsbereichen herstellen, die einer Premium-Per-User-Lizenz zugeordnet sind, indem Sie Dienstprinzipalprofile über den XMLA-Endpunkt verwenden.

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>

Ab Version 19.67.0 unterstützen Verbindungsobjekte wie Microsoft.AnalysisServices.AdomdClient.AdomdConnection und Microsoft.AnalysisServices.Server eine neue AccessToken--Eigenschaft, die eine verbesserte Möglichkeit zum Übergeben externer OAuth-Token ermöglicht, die von der XMLA-Verbindungsschicht verwendet werden. Weitere Informationen finden Sie unter Eigenschaften der Verbindungszeichenfolge – Benutzer-ID=...; Password=.

Ab Version 19.42.0.4 verwenden ADOMD.NET und AMO/TOM MSAL (Microsoft.Identity.Client) Version 4.43.0 oder höher anstelle von ADAL, um Benutzer mit Microsoft Entra-ID zu authentifizieren, wenn eine Verbindung mit cloudbasierten Diensten wie Power-BI und Azure Analysis Services hergestellt wird. Wenn Ihre Anwendung oder eine andere Komponente, von der die Anwendung abhängig ist, MSAL verwendet, kann es erforderlich sein, die Bindungsumleitungseinstellungen der Anwendung zu aktualisieren, wenn Konflikte zwischen den von den Komponenten geladenen MSAL-Versionen auftreten.

AMO und ADOMD .Net Core

Unterstützte Szenarien umfassen Verbindungen mit Azure Analysis Services, Power BI Premium und SQL Server Analysis Services. Tcp-basierte Konnektivität wird nur für Windows-Computer unterstützt.

Die interaktive Anmeldung mit der Microsoft Entra-ID wird nur für Windows-Computer unterstützt. Die .NET Core Desktop-Laufzeit ist erforderlich.

Abhängigkeit in MSAL erfordert Version 4.43.0 oder höher.

Version 19.14.0 der .Net Core-Clientbibliotheken hat die Vorschauunterstützung für die Self-Contained Veröffentlichung (sowohl in einem veröffentlichten Verzeichnis als auch im Einzeldateimodus) eingeführt, zusätzlich zur Unterstützung der Nutzung durch .NET 5.0-Projekte. Es wurden mehrere Probleme im Zusammenhang mit der Konnektivität mit SQL Server Analysis Services behoben, die in der vorherigen Version identifiziert wurden.

Version 19.12.7.2 der .Net Core-Clientbibliotheken hat unterstützung für SQL Server Analysis Services eingeführt. Niedrigere Vorschauversionen unterstützen nur Azure Analysis Services- und Power BI-Semantikmodelle.

AMO

Ab Version 19.84.6 wird die Unterstützung für TMDL in AMO\TOM als in General-Availability Status betrachtet, und es werden keine wichtigen Änderungen an der API-Oberfläche vorgenommen.

Version 19.12.3.0 der AMO-Clientbibliothek führt eine neue Enumeration ein, Microsoft.AnalysisServices.DataType. Die vorherige Aufzählung Microsoft.AnalysisServices.Tabular.DataType noch vorhanden. Wenn Ihr Code auf die vorherige Enumeration als DataType- in einer Codedatei mit Anweisungen auf beide Namespaces verweist (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular), können Sie aufgrund der Mehrdeutigkeit beim Kompilieren einen Fehler erhalten. Um den Fehler zu beheben, qualifizieren Sie den Verweis auf die Enumeration vollständig.

Version 19.61.1.4 der AMO-Clientbibliothek führt eine Änderung des Transaktionsrollbackverhaltens von Microsoft.AnalysisServices.Serverein. In früheren Versionen sendet ein Aufruf von Server.RollbackTransaction() eine Anforderung an das Modul, um das Rollback der Transaktion zurückzurufen, und versuchen Sie dann, lokale Änderungen zurückzurufen. Im Gegensatz zu früheren Versionen, in 19.61.1.4 und höher, wenn lokale Änderungen nicht sicher zurückgesetzt werden können, werden tabellarische Datenbanken, die im Transaktionsblock enthalten sind, alle zusätzlichen Änderungen blockiert, bis sie vollständig synchronisiert werden können und die veralteten Änderungen aus der Transaktion, die zurückgesetzt wurden, entfernt werden. Eine InvalidOperationException- wird ausgelöst, wenn eine Änderung an der relevanten tabellarischen Datenbank vorgenommen wird. Wenn Ihr Code Server.RollbackTransaction()aufruft, empfiehlt es sich, diesem Aufruf mit einer vollständigen Synchronisierung [Database.Refresh(true)] für jede tabellarische Datenbank zu folgen, die als Teil der Transaktion geändert wird.

Ab Version 19.77.0 gibt TOM beim Klonen oder Kopieren eines MetadataObjects in eine andere Instanz eines MetadataObjects mithilfe des Tabellarischen Objektmodells (TOM) NULL für Eigenschaften zurück, die außerhalb der direkten Struktur von untergeordneten Objekten des MetadataObjects querverweisen. Sie müssen die geklonte MetadataObject-Instanz dem semantischen Modell hinzufügen, damit Querverweise auf Objekte außerhalb der MetadataObject-Struktur aufgelöst werden können.

Wenn Sie beispielsweise eine Tabelle mit einer Partition klonen, die auf einen benannten Ausdruck in einer EntityPartitionSource verweist, gibt die ExpressionSource-Eigenschaft der EntityPartitionSource null zurück, bis die geklonte Tabelle dem semantischen Modell wie im folgenden Codeausschnitt hinzugefügt wird, sodass der geklonte ExpressionSource-Verweis aufgelöst werden kann. Der Klon muss dem Modell hinzugefügt werden, da der querverweiste benannte Ausdruck ein Element der Expressions-Auflistung des Modells und nicht Teil der Tabellenstruktur untergeordneter Objekte ist.

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

ADOMD

Ab ADOMD (sowohl .NET Framework als auch .NET Core) Version 19.61.1.4 ist die Komprimierung in der XMLA-Transportebene vollständig verfügbar. Frühere Versionen nach Version 19.55.3.1 implementierten teilweise Unterstützung für die Komprimierung. Berichte zu Problemen mit diesen Versionen wurden empfangen. Diese Probleme wurden im Rahmen der Version 16.61.1.4 behoben. Stellen Sie sicher, dass Sie ein Upgrade auf 19.61.1.4 oder höher durchführen, wenn Probleme im Zusammenhang mit der Komprimierung auftreten.

MSOLAP

Ab Version 16.0.139.27 unterstützt MSOLAP Dienstprinzipalprofile für die Authentifizierung, wie im folgenden Beispiel für die Verbindungszeichenfolge. Weitere Informationen finden Sie unter Verwenden von Dienstprinzipalprofilen zum Verwalten von Kundendaten in mehrinstanzenfähige Apps.

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>

Ab Version 16.0.134.22 unterstützt MSOLAP automatische single Sign-On (SSO) mit Web Account Manager (WAM), verfügbar unter Windows 10 und höher sowie Windows Server 2019 und höher. Wenn eine neue HTTP-Verbindung geöffnet wird, ruft MSOLAP wie folgt ein Zugriffstoken ab:

  1. Wenn das Zwischenspeichern von Token aktiviert ist und ein geeignetes Token im Cache verfügbar ist, verwendet MSOLAP das zwischengespeicherte Token.
  2. Wenn kein geeignetes zwischengespeichertes Token verfügbar ist, versucht MSOLAP, ein Zugriffstoken im Hintergrund über WAM abzurufen.
  3. Wenn SSO mit WAM fehlgeschlagen ist, greift MSOLAP auf die interaktive Authentifizierung und das Popupfenster des Anmeldefensters zurück.

Benutzer können den automatischen SSO-Fluss umgehen und die interaktive Authentifizierung sofort starten, indem sie eine leere Benutzer-ID in der Verbindungszeichenfolge (User ID=') bereitstellt.

Ab Version 16.0.43.20 verwendet MSOLAP MSAL (Microsoft.Identity.Client) Version 4.43.0 oder höher anstelle von ADAL, um Benutzer mit Microsoft Entra-ID zu authentifizieren, wenn eine Verbindung mit cloudbasierten Diensten wie Power-BI und Azure Analysis Services hergestellt wird. Wenn Ihre Anwendung oder eine andere Komponente, von der die Anwendung abhängt, MSAL verwendet, kann es erforderlich sein, die Bindungsumleitungseinstellungen der Anwendung zu aktualisieren, wenn Konflikte zwischen den Versionen von MSAL auftreten, die von den Komponenten geladen wurden.

Eine Regression im Zusammenhang mit Verbindungen mit cloudbasierten Systemen mit Microsoft Entra ID wurde in der Version 16.0.4.17 von OLEDB (MSOLAP) entdeckt. Es wurde in der Version 16.0.20.201 behoben. Aufgrund der Art des Problems kann eine installierte Version 16.0.4.17 sowie jede andere Version vor 16.0.20.201 nicht korrigiert werden, indem der Anbieter angenommen wird, auch wenn setup im Reparaturmodus ausgeführt wird. Es wird empfohlen, die Version 16.0.4.17 [oder andere problematische] vollständig zu deinstallieren und dann die Version 16.0.20.201 oder höher zu installieren.

In einer früheren Version wurde MSOLAP aktualisiert, um eine Verbindung mit cloudbasierten Analysis Services mithilfe der verwalteten Microsoft Authentication Library (MSAL) herzustellen. Ab Version 16.0.87.16 installiert DAS MSOLAP-Setup nicht mehr die ursprüngliche systemeigene Azure Active Directory-Authentifizierungsbibliothekskomponente (ADAL).

Grundlegendes zu Clientbibliotheken

Analysis Services verwendet drei Clientbibliotheken. ADOMD.NET und Analysis Services Management Objects (AMO) sind verwaltete Clientbibliotheken. Und Analysis Services OLE DB Provider (MSOLAP DLL) ist eine systemeigene Clientbibliothek. In der Regel werden alle drei gleichzeitig installiert.

Microsoft-Clientanwendungen wie Power BI Desktop und Excel installieren alle drei Clientbibliotheken und aktualisieren sie, wenn neue Versionen verfügbar sind. Je nach Version oder Häufigkeit von Updates sind einige Clientbibliotheken möglicherweise nicht die neuesten Versionen, die von Azure Analysis Services und Power BI benötigt werden. Das gleiche gilt für benutzerdefinierte Anwendungen oder andere Schnittstellen wie AsCmd, TOM, ADOMD.NET. Für diese Anwendungen ist eine manuelle oder programmgesteuerte Installation der Bibliotheken erforderlich. Die Clientbibliotheken für die manuelle Installation sind in SQL Server-Feature packs als verteilbare Pakete enthalten. Diese Clientbibliotheken sind jedoch an die SQL Server-Version gebunden und sind möglicherweise nicht die neueste. Stellen Sie sicher, dass Sie immer die neuesten, herunterladbaren Dateien aus diesem Artikel installieren.

Clientbibliothekstypen

ANALYSIS Services OLE DB-Anbieter (MSOLAP)

Analysis Services OLE DB-Anbieter (MSOLAP) ist die systemeigene Clientbibliothek für Analysis Services-Datenbankverbindungen. Sie wird indirekt sowohl von ADOMD.NET als auch von AMO verwendet, wobei Verbindungsanforderungen an den Datenanbieter delegiert werden. Sie können den OLE DB-Anbieter auch direkt über den Anwendungscode aufrufen.

Der OLE DB-Anbieter für Analysis Services wird automatisch von den meisten Tools und Clientanwendungen installiert, die für den Zugriff auf Analysis Services-Datenbanken verwendet werden. Sie muss auf Computern installiert werden, die für den Zugriff auf Analysis Services-Daten verwendet werden.

OLE DB-Anbieter werden häufig in Verbindungszeichenfolgen angegeben. Eine Analysis Services-Verbindungszeichenfolge verwendet eine andere Nomenklatur, um auf den OLE DB-Anbieter zu verweisen: MSOLAP.<Version>.dll.

AMO

AMO ist eine verwaltete Clientbibliothek, die für die Serververwaltung und Datendefinition verwendet wird. Sie wird von Tools und Clientanwendungen installiert und verwendet. Beispielsweise verwendet SQL Server Management Studio (SSMS) AMO zum Herstellen einer Verbindung mit Analysis Services. Eine Verbindung mit AMO ist in der Regel minimal, bestehend aus "data source=\<servername>". Nachdem eine Verbindung hergestellt wurde, verwenden Sie die API, um mit Datenbanksammlungen und hauptobjekten zu arbeiten. Sowohl Visual Studio als auch SSMS verwenden AMO, um eine Verbindung mit einer Analysis Services-Instanz herzustellen.

ADOMD

ADOMD.NET ist eine verwaltete Datenclientbibliothek, die zum Abfragen von Analysis Services-Daten verwendet wird. Sie wird von Tools und Clientanwendungen installiert und verwendet.

Beim Herstellen einer Verbindung mit einer Datenbank sind die Verbindungszeichenfolgeneigenschaften für alle drei Bibliotheken ähnlich. Fast jede Verbindungszeichenfolge, die Sie für ADOMD.NET definieren, mithilfe von Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString funktioniert auch für AMO und den Analysis Services OLE DB Provider (MSOLAP). Weitere Informationen finden Sie unter Eigenschaften der Verbindungszeichenfolge.

Überprüfen der installierten Versionen

OLEDDB (MSOLAP)

  1. Wechseln Sie zu C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Wenn Sie mehrere Ordner haben, wählen Sie die höhere Zahl aus.

  2. Klicken Sie mit der rechten Maustaste auf msolap.dll>Eigenschaften>Details. Überprüfen Sie die Eigenschaft Produktversion. Hinweis: Wenn der Dateiname msolap140.dllist, ist er älter als die neueste Version und sollte aktualisiert werden.

    Dialogfeld

AMO

  1. Wechseln Sie zu C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Wenn Sie mehrere Ordner haben, wählen Sie die höhere Zahl aus.

  2. Klicken Sie mit der rechten Maustaste Microsoft.AnalysisServices>Eigenschaften>Details.

    Dialogfeld

ADOMD

  1. Wechseln Sie zu C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Wenn Sie mehrere Ordner haben, wählen Sie die höhere Zahl aus.

  2. Klicken Sie mit der rechten Maustaste Microsoft.AnalysisServices.AdomdClient>Eigenschaften>Details.

    Dialogfeld

Manuelles Aktualisieren

Clientbibliotheken werden in der Regel zusammen mit Tools und Clientanwendungen, die sie verwenden, automatisch installiert und aktualisiert. In einigen Fällen werden Clientbibliotheken jedoch möglicherweise nicht automatisch aktualisiert, und jede muss manuell aktualisiert werden. Um manuell zu aktualisieren, laden Sie das Windows Installer-Paket (.msi) für jede Clientbibliothek herunter, und führen Sie es aus.

So laden Sie es herunter und aktualisieren

  1. Klicken:

  2. Klicken Sie in Downloadsauf ein Windows Installer-Paket, um Setup auszuführen.

  3. Klicken Sie im Setup auf Weiter.

  4. Lesen Sie den Lizenzvertrag. Wenn Sie zustimmen, wählen Sie Ich stimme den Bedingungen im Lizenzvertragzu, und klicken Sie dann auf Weiter.

  5. Klicken, installieren.

  6. Klicken Sie nach Abschluss auf fertig stellen.