Analysis Services クライアントライブラリ

[アーティクル]
07/13/2022

適用対象: Azure Analysis Services Power BI Premiumを SQL Server Analysis Servicesする

クライアントアプリケーションとツールが Analysis Services に接続するためには、クライアントライブラリが必要です。 Power BI Desktop、Excel、SQL Server Management Studio (SSMS)、Visual Studio 向けの Analysis Services プロジェクト拡張機能などの Microsoft クライアントアプリケーションは、3 つのすべてのクライアントライブラリをインストールし、それらを通常のアプリケーションの更新と共に更新します。カスタムクライアントアプリケーションでも、クライアントライブラリがインストールされている必要があります。クライアントライブラリは、毎月更新されます。ダウンロードする前に、既知の問題を確認してください。

ダウンロード	バージョン
MSOLAP (amd64)	16.0.39.19
MSOLAP (x86)	16.0.39.19
AMO	19.46.0.0
ADOMD	19.46.0.0

パッケージ	バージョン
AMO	19.46.0.0
ADOMD	19.46.0.0

パッケージ	バージョン
AMO	19.46.0.0
ADOMD	19.46.0.0

必要な最小バージョン

トランスポート層セキュリティ (TLS) プロトコルバージョン 1.0/1.1 は、2021 年 6 月 30 日までに Azure Active Directory で非推奨になります。今後、TLS 1.2 以降が必要です。以前のバージョンの Analysis Services クライアントライブラリでは、TLS 1.2 はサポートされていません。新しいクライアントライブラリのバージョンには、TLS 1.2 以降のサポートのほか、その他の重要なセキュリティ強化が含まれます。

リスクと潜在的なセキュリティの脆弱性を最小限に抑えるには、2021 年 6 月 30 日から、Azure Analysis Servicesおよび Power BI のセキュリティ強化には、次以上のバージョンが必要です。

クライアントライブラリ	ファイルバージョン	バージョン
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

既知の問題

AMO と ADOMD

バージョン 19.42.0.4 以降、ADOMD.NET と AMO/TOM は、Power-BI や Azure Analysis Services などのクラウドベースのサービスへの接続を確立するときに、ADAL の代わりに MSAL (Microsoft.Identity.Client) バージョン 4.43.0 を使用して AAD を使用してユーザーを認証します。アプリケーションまたはアプリケーションが依存している別のコンポーネントが MSAL を使用している場合は、コンポーネントによって読み込まれた MSAL のバージョン間で競合がある場合は、アプリケーションのバインドリダイレクト設定を更新する必要があります。

AMO と ADOMD .Net Core

サポートされるシナリオには、Azure Analysis Services、Power BI Premium、およびSQL Server Analysis Servicesへの接続が含まれます。 TCP ベースの接続は、Windows コンピューターでのみサポートされています。

Azure Active Directory での対話型ログインは、Windows コンピューターでのみサポートされています。 .NET Core Desktop ランタイムが必要です。

MSAL の依存関係には、バージョン 4.43.0 以降が必要です。

.Net Core クライアントライブラリのバージョン 19.14.0 では、Self-Contained発行のプレビューサポート (発行済みディレクトリと単一ファイルモードの両方) と、.NET 5.0 プロジェクトによる使用のサポートが導入されました。以前のリリースで特定されたSQL Server Analysis Servicesへの接続に関連するいくつかの問題が修正されました。

.Net Core クライアントライブラリのバージョン 19.12.7.2 では、SQL Server Analysis Servicesのサポートが導入されました。下位プレビューバージョンでは、Azure Analysis Servicesと Power BI データセットのみがサポートされています。

AMO

AMO クライアントライブラリのバージョン 19.12.3.0 では、新しい列挙体 Microsoft.AnalysisServices.DataType が導入されています。ただし、前の列挙体 である Microsoft.AnalysisServices.Tabular.DataType はまだ存在します。コードが両方の名前空間 (Microsoft.AnalysisServices、Microsoft.AnalysisServices.Tabular) へのステートメントを含むコードファイル内の DataType として前の列挙体を単に参照している場合、あいまいさのため、コンパイル時にエラーが発生する可能性があります。エラーを解決するには、列挙への参照を完全に修飾します。

MSOLAP

AAD を使用したクラウドベースのシステムへの接続に関連する回帰が、16.0.4.17 バージョンの OLEDB (MSOLAP) で検出されました。 16.0.20.201 バージョンで修正されました。問題の性質上、インストールされている 16.0.4.17 バージョンと 16.0.20.201 より前の他のバージョンは、セットアップが修復モードで実行されている場合でも、プロバイダーをアップグレードするだけでは修正できません。 16.0.4.17 [またはその他の問題のある] バージョンを完全にアンインストールしてから、16.0.20.201 以降のバージョンをインストールすることをお勧めします。

クライアントライブラリについて

Analysis Services は、3 つのクライアントライブラリを利用します。 ADOMD.NET と Analysis Services 管理オブジェクト (AMO) は、マネージドクライアントライブラリです。 Analysis Services OLE DB プロバイダー (MSOLAP DLL) はネイティブクライアントライブラリです。通常は、3 つすべてが同時にインストールされます。

Power BI Desktop や Excel などの Microsoft クライアントアプリケーションでは、3 つのクライアントライブラリがすべてインストールされ、新しいバージョンが使用可能になると更新されます。更新プログラムのバージョンまたは頻度によっては、一部のクライアントライブラリが Azure Analysis Services および Power BI で必要な最新バージョンでない場合があります。これは、カスタムアプリケーションまたは AsCmd、TOM、ADOMD.NET など他のインターフェイスでも同様です。これらのアプリケーションでは、ライブラリを手動かプログラムでインストールする必要があります。手動インストール用のクライアントライブラリは、配布可能なパッケージとして SQL Server Feature Pack に含まれています。ただし、これらのクライアントライブラリは SQL Server のバージョンに対応しており、最新版ではない可能性があります。この記事からダウンロードできる最新のものを常にインストールしてください。

クライアントライブラリの種類

Analysis Services OLE DB Provider (MSOLAP)

Analysis Services OLE DB Provider (MSOLAP) は、Analysis Services データベース接続用のネイティブクライアントライブラリです。 ADOMD.NET と AMO の両方に間接的に使用され、接続要求をデータプロバイダーに委任します。アプリケーションコードから OLE DB Provider を直接呼び出すこともできます。

Analysis Services OLE DB Provider は、Analysis Services データベースへのアクセスに使用されるほとんどのツールおよびクライアントアプリケーションによって、自動的にインストールされます。 Analysis Services データへのアクセスに使用されるコンピューターにインストールする必要があります。

OLE DB プロバイダーは、多くの場合、接続文字列で指定されます。 Analysis Services 接続文字列では、異なる命名法を使用して OLE DB プロバイダー MSOLAP を参照します。<バージョン>.dll。

AMO

AMO は、サーバーの管理とデータの定義に使用されるマネージドクライアントライブラリです。ツールおよびクライアントアプリケーションによってインストールされ、使用されます。たとえば、SQL Server Management Studio (SSMS) は、AMO を使用して Analysis Services に接続します。 AMO を使用した接続は、通常は最小で、"data source=\<servername>" で構成されています。接続の確立後は、API を使用して、データベースコレクションおよび主要なオブジェクトを操作します。 Visual Studio と SSMS はどちらも、AMO を使用して Analysis Services インスタンスに接続します。

ADOMD

ADOMD.NET は、Analysis Services データの照会に使用されるマネージドデータクライアントライブラリです。ツールおよびクライアントアプリケーションによってインストールされ、使用されます。

データベースに接続する際、3 つのライブラリの接続文字列プロパティは、どれも似ています。 Microsoft.AnalysisServices.AdomdClient.AdomdConnection.ConnectionString を使用して ADOMD.NET に定義するほぼすべての接続文字列は、AMO と Analysis Services OLE DB Provider (MSOLAP) でも機能します。詳細については、「接続文字列のプロパティ」を参照してください。

インストールされているバージョンを確認する

OLEDDB (MSOLAP)

C:\Program Files\Microsoft Analysis Services\AS OLEDB\ にアクセスします。複数のフォルダーがある場合は、番号の大きい方を選択します。
[msolap.dll]>[プロパティ]>[詳細] の順にクリック (最初は右クリック) します。 製品バージョンプロパティを確認します。注: ファイル名がmsolap140.dllされている場合は、最新バージョンより古く、アップグレードする必要があります。

AMO

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices\ にアクセスします。複数のフォルダーがある場合は、番号の大きい方を選択します。
[Microsoft.AnalysisServices]>[プロパティ]>[詳細] の順にクリック (最初は右クリック) します。

ADOMD

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.AnalysisServices.AdomdClient\ にアクセスします。複数のフォルダーがある場合は、番号の大きい方を選択します。
[Microsoft.AnalysisServices.AdomdClient]>[プロパティ]>[詳細] の順にクリック (最初は右クリック) します。

を手動で更新する

通常、クライアントライブラリは、それらを使用するツールやクライアントアプリケーションと共に自動的にインストールおよび更新されます。ただし、場合によっては、クライアントライブラリが自動的に更新されない場合があり、それぞれを手動で更新する必要があります。手動で更新するには、クライアントライブラリごとに Windows インストーラー (.msi) パッケージをダウンロードして実行します。

ダウンロードして更新するには

次の機能を利用できます。
[ ダウンロード] で、Windows インストーラーパッケージをクリックしてセットアップを実行します。
[セットアップ] で、[ 次へ] をクリックします。
使用許諾契約書を読みます。同意する場合は、[ 使用許諾契約書の条項に同意する] を選択し、[ 次へ] をクリックします。
[ インストール] をクリックします。
完了したら、[ 完了] をクリックします。

Analysis Services クライアントライブラリ

最新のものをダウンロードする

Windows インストーラー