Analysis Services-Clientbibliotheken

Gilt für: SQL Server Analysis Services Azure Analysis Services Power BI Premium

Clientbibliotheken sind erforderlich, damit Clientanwendungen und -tools eine Verbindung mit Analysis Services herstellen können. Microsoft-Clientanwendungen wie Power BI Desktop, Excel, SQL Server Management Studio (SSMS) und Analysis Services-Projekterweiterungen für Visual Studio installieren alle drei Clientbibliotheken und aktualisieren sie im Rahmen der regulären Anwendungsupdates. Auch für benutzerdefinierte Clientanwendungen müssen Clientbibliotheken installiert werden. Clientbibliotheken werden monatlich aktualisiert. Stellen Sie vor dem Herunterladen sicher, dass Bekannte Probleme angezeigtwerden.

Herunterladen der neuesten Version

Windows Installer

Download Version
MSOLAP (amd64) 15.1.99.21
MSOLAP (x86) 15.1.99.21
AMO 19.22.5.0
ADOMD 19.22.5.0

NuGet-Pakete

Analysis Services Management Objects (AMO) und ADOMD-Clientbibliotheken stehen als installierbare Pakete auf NuGet.org zur Verfügung. Es wird empfohlen, nicht den Windows Installer zu verwenden, sondern eine Migration zu NuGet-Verweisen auszuführen.

Ab Februar 2021 sind auch Versionen von .NET Core-Paketen verfügbar, die den AMO- und ADOMD-Clientpaketen entsprechen. Es gibt jedoch einige Szenarien, die von den .NET Core-Versionen nicht unterstützt werden. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Bekannte Probleme.

Die AssemblyVersion für NuGet-Paketassemblys folgt der semantischen Versionierung: HAUPT.NEBEN.PATCH. NuGet-Verweise laden die erwartete Version selbst dann, wenn im GAC eine andere Version (als Ergebnis der MSI-Installation) vorhanden ist. PATCH wird für jedes Release erhöht. AMO- und ADOMD-Versionen werden synchronisiert.

AMO und ADOMD

Paket Version
AMO 19.22.5.0
ADOMD 19.22.5.0

AMO- und ADOMD-.NET Core

Paket Version
AMO 19.22.5.0
ADOMD 19.22.5.0

Erforderliche Mindestversionen

Transport Layer Security(TLS)-Protokoll, Version 1.0/1.1, wird in Azure Active Directory am 30. Juni 2021 als veraltet festgelegt. In Zukunft ist TLS 1.2 und höher erforderlich. TLS 1.2 wird in früheren Versionen der Analysis Services Clientbibliotheken nicht unterstützt. Neuere Clientbibliotheksversionen enthalten Unterstützung für TLS 1.2 und höher sowie andere wichtige Sicherheitsverbesserungen.

Ab dem 30. Juni 2021 sind folgende oder höhere Versionen erforderlich, um risiken- Power BI und potenzielle Sicherheitsrisiken Azure Analysis Services zu minimieren:

Clientbibliothek 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

Bekannte Probleme

AMO- und ADOMD-.NET Core

Zu den unterstützten Szenarien gehören 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 Azure Active Directory wird nur für Windows Computer unterstützt. Die .NET Core Desktop-Runtime ist erforderlich.

Die Abhängigkeit in MSAL erfordert Version 4.6.0 und höher.

In Version 19.14.0 der .NET Core Clientbibliotheken wurde die Vorschauunterstützung für Self-Contained-Veröffentlichung (sowohl in einem veröffentlichten Verzeichnis als auch im Einzeldateimodus) sowie unterstützung für die Nutzung durch .NET 5.0-Projekte eingeführt. Eine Reihe von Problemen im Zusammenhang mit der Konnektivität mit SQL Server Analysis Services, die in der vorherigen Version identifiziert wurden, wurden behoben.

In Version 19.12.7.2 der .NET Core Clientbibliotheken wurde Unterstützung für SQL Server Analysis Services eingeführt. Niedrigere Vorschauversionen unterstützten nur Azure Analysis Services und Power BI Datasets.

AMO

In Version 19.12.3.0 der AMO-Clientbibliothek wird die neue Enumeration Microsoft.AnalysisServices.DataType eingeführt. Die vorherige Enumeration Microsoft.AnalysisServices.Tabular.DataType ist jedoch weiterhin vorhanden. Wenn Ihr Code in einer Codedatei mit Anweisungen für beide Namespaces (Microsoft.AnalysisServices, Microsoft.AnalysisServices.Tabular) aufgrund der Mehrdeutigkeit einfach als DataType verweist, erhalten Sie beim Kompilieren möglicherweise einen Fehler. Um den Fehler zu beheben, qualifizieren Sie den Verweis auf die Enumeration vollständig.

Grundlegendes zu Clientbibliotheken

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

Bei Microsoft-Clientanwendungen wie Power BI Desktop und Excel werden alle drei Clientbibliotheken installiert und dann entsprechend aktualisiert, wenn neue Versionen verfügbar sind. Je nach Version oder Häufigkeit der Updates sind einige Clientbibliotheken möglicherweise nicht die neuesten Versionen, die von Azure Analysis Services und Power BI benötigt werden. Dies gilt auch für benutzerdefinierte Anwendungen oder andere Schnittstellen wie AsCmd, TOM, ADOMD.NET. Für diese Anwendungen müssen die Bibliotheken manuell oder programmgesteuert installiert werden. Die Clientbibliotheken für die manuelle Installation sind in SQL Server-Funktionspaketen wie verteilbaren Paketen enthalten. Allerdings sind diese Clientbibliotheken an die SQL Server-Version gebunden und möglicherweise nicht auf dem neuesten Stand. Stellen Sie sicher, dass Sie immer die neueste Version installieren, die Sie in diesem Artikel herunterladen können.

Typen von Clientbibliotheken

Analysis Services OLE DB-Anbieter (MSOLAP)

Der Analysis Services OLE DB-Anbieter (MSOLAP) ist die native Clientbibliothek für Analysis Services-Datenbankverbindungen. Er wird indirekt von ADOMD.NET und AMO genutzt, und Verbindungsanforderungen werden an den Datenanbieter delegiert. Sie können den OLE DB-Anbieter auch direkt über den Anwendungscode aufrufen.

Der Analysis Services OLE DB-Anbieter wird von den meisten Tools und Clientanwendungen, die zum Zugreifen auf Analysis Services-Datenbanken verwendet werden, automatisch installiert. Er muss auf Computern installiert sein, die zum Zugreifen auf Analysis Services-Daten verwendet werden.

OLE DB-Anbieter werden häufig in Verbindungszeichenfolgen angegeben. Für eine Analysis Services-Verbindungszeichenfolge wird eine andere Nomenklatur genutzt, 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 genutzt. Für SQL Server Management Studio (SSMS) wird AMO beispielsweise zum Herstellen einer Verbindung mit Analysis Services genutzt. Eine Verbindung, für die AMO genutzt wird, ist meist eine minimale Verbindung, die aus "data source=\<servername>" besteht. Nach dem Herstellen einer Verbindung verwenden Sie die API, um mit Datenbanksammlungen und größeren Objekten zu arbeiten. AMO wird sowohl von Visual Studio als auch von SSMS verwendet, um eine Verbindung mit einer Analysis Services-Instanz herzustellen.

ADOMD

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

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

Überprüfen, ob .NET Core bereits installiert ist

OLEDDB (MSOLAP)

  1. Gehe zu C:\Program Files\Microsoft Analysis Services\AS OLEDB\. Wählen Sie den Ordner mit der höheren Zahl, falls Sie mehr als einen Ordner haben.

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

    Dialogfeld "Details zur MSOLAP-Clientbibliothek"

AMO

  1. Gehe zu C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\. Wählen Sie den Ordner mit der höheren Zahl, falls Sie mehr als einen Ordner haben.

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

    Dialogfeld mit Details zur AMO-Clientbibliothek

ADOMD

  1. Gehe zu C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\. Wählen Sie den Ordner mit der höheren Zahl, falls Sie mehr als einen Ordner haben.

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

    Dialogfeld "Details zur ADOMD-Clientbibliothek"

Manuelles Aktualisieren von

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

So laden Sie herunter und aktualisieren

  1. Klicken Sie auf:

  2. Klicken Sie unter Downloads auf Windows Installer-Paket, um Setup ausführen zu können.

  3. Klicken Sie unter Setup auf Weiter.

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

  5. Klicken Sie auf Installieren.

  6. Klicken Sie nach Abschluss auf Fertig stellen.