このトピックでは、デザイナーまたは管理ツールのいずれかで設定できる接続文字列プロパティ、または Analysis Services データに接続してクエリを実行するクライアント アプリケーションによって構築された接続文字列を参照する方法について説明します。 そのため、使用可能なプロパティのサブセットのみが対象になります。 完全な一覧には、多数のサーバーとデータベースのプロパティが含まれており、サーバーでのインスタンスまたはデータベースの構成方法に関係なく、特定のアプリケーションの接続をカスタマイズできます。
アプリケーション コードでカスタム接続文字列を作成する開発者は、ADOMD.NET クライアントの API ドキュメントを確認して、より詳細な一覧を表示する必要があります。 ConnectionString
このトピックで説明するプロパティは、Analysis Services クライアント ライブラリ、ADOMD.NET、AMO、および Analysis Services 用 OLE DB プロバイダーによって使用されます。 接続文字列プロパティの大部分は、3 つのクライアント ライブラリすべてで使用できます。 例外は説明で呼び出されます。
このトピックのセクションは次のとおりです。
Analysis Services で使用される接続文字列の形式
注
プロパティを設定するときに、誤って同じプロパティを 2 回設定した場合は、接続文字列の最後のプロパティが使用されます。
既存の Microsoft アプリケーションで Analysis Services 接続を指定する方法の詳細については、「 クライアント アプリケーションからの接続 (Analysis Services)」を参照してください。
一般的な接続パラメーター
次の表では、接続文字列を構築するときに最もよく使用されるプロパティについて説明します。
| プロパティ | 説明 | 例 |
|---|---|---|
Data Source または DataSource |
サーバー インスタンスを指定します。 このプロパティは、すべての接続に必要です。 有効な値には、サーバーのネットワーク名または IP アドレス、ローカル接続用のローカルホストまたは localhost、サーバーが HTTP または HTTPS アクセス用に構成されている場合の URL、またはローカル キューブ (.cub) ファイルの名前が含まれます。 |
Data source=AW-SRV01 既定のインスタンスとポートの場合 (TCP 2383)。Data source=AW-SRV01$Finance:8081 名前付きインスタンス ($Finance) と固定ポート。Data source=AW-SRV01.corp.Adventure-Works.com 既定のインスタンスとポートを前提として、完全修飾ドメイン名の場合。Data source=172.16.254.1 サーバーの IP アドレスの場合は、DNS サーバー参照をバイパスします。接続の問題のトラブルシューティングに役立ちます。 |
Initial Catalog または Catalog |
接続先の Analysis Services データベースの名前を指定します。 データベースは Analysis Services に配置する必要があり、それに接続するためのアクセス許可が必要です。 このプロパティは AMO 接続では省略可能ですが、ADOMD.NET に必要です。 | Initial catalog=AdventureWorks2012 |
Provider |
有効な値には、MSOLAP または MSOLAP.< が含まれますversion>。 <version> は 3、4、または 5 のいずれかです。 ファイル システム上では、SQL Server 2012 バージョンの場合はデータ プロバイダー名が msolap110.dll であり、SQL Server 2008 および 2008 R2 の場合は msolap100.dll、SQL Server 2005 の場合は msolap90.dll です。 現在のバージョンは MSOLAP.5 です。 このプロパティは省略可能です。 既定では、クライアント ライブラリは、レジストリから OLE DB プロバイダーの現在のバージョンを読み取ります。 このプロパティを設定する必要があるのは、SQL Server 2008 インスタンスへの接続など、特定のバージョンのデータ プロバイダーが必要な場合のみです。 データ プロバイダーは、SQL Server のバージョンに対応します。 組織で現在および以前のバージョンの Analysis Services を使用している場合は、ほとんどの場合、手動で作成する接続文字列で使用するプロバイダーを指定する必要があります。 また、必要なバージョンがないコンピューターに、特定のバージョンのデータ プロバイダーをダウンロードしてインストールする必要がある場合もあります。 ダウンロード センターの SQL Server Feature Pack ページから OLE DB プロバイダーをダウンロードできます。 Microsoft SQL Server 2012 Feature Pack に移動して、SQL Server 2012 用 Analysis Services OLE DB プロバイダーをダウンロードします。 MSOLAP.4 は、SQL Server 2008 と SQL Server 2008 R2 の両方でリリースされました。 2008 R2 バージョンでは PowerPivot ブックがサポートされており、SharePoint サーバーに手動でインストールする必要がある場合があります。 これらのバージョンを区別するには、プロバイダーのファイル プロパティでビルド番号を確認する必要があります。プログラム ファイル\Microsoft Analysis Services\AS OLEDB\10 に移動します。 msolap110.dll を右クリックし、[ プロパティ] を選択します。 [詳細]をクリックします。 ファイルのバージョン情報を表示します。 SQL Server 2008 R2 のバージョンには 10.50.<buildnumber> が含まれている必要があります。 詳細については、「 Analysis Services 接続に使用される SharePoint サーバーおよびデータ プロバイダーに Analysis Services OLE DBプロバイダーをインストールする」を参照してください。 MSOLAP.3 は SQL Server 2005 でリリースされました。 MSOLAP.4 は SQL Server 2008 でリリースされ、SQL Server 2008 R2 でもリリースされました MSOLAP.5 は SQL Server 2012 でリリースされました |
Provider=MSOLAP.3 は、SQL Server 2005 バージョンの OLE DB プロバイダー for Analysis Services を必要とする接続に使用されます。 |
Cube |
キューブ名またはパースペクティブ名。 データベースには、複数のキューブとパースペクティブを含めることができます。 複数のターゲットが可能な場合は、接続文字列にキューブ名またはパースペクティブ名を含めます。 |
Cube=SalesPerspective は、キューブ接続文字列プロパティを使用して、キューブの名前またはパースペクティブの名前を指定できることを示しています。 |
認証およびセキュリティ
このセクションには、認証と暗号化に関連する接続文字列プロパティが含まれています。 Analysis Services では Windows 認証のみが使用されますが、接続文字列のプロパティを設定して、特定のユーザー名とパスワードを渡すことができます。
プロパティはアルファベット順に一覧表示されます。
| プロパティ | 説明 |
|---|---|
EffectiveUserName |
エンド ユーザー ID をサーバーで偽装する必要がある場合に使用します。 ドメイン/ユーザー形式でアカウントを指定します。 このプロパティを使用するには、呼び出し元に Analysis Services の管理アクセス許可が必要です。 SharePoint の Excel ブックでこのプロパティを使用する方法の詳細については、「SharePoint Server 2013 での Analysis Services EffectiveUserName の使用」を参照してください。 Reporting Services でこのプロパティを使用する方法の図については、「 EffectiveUserName を使用して SSAS で偽装する」を参照してください。EffectiveUserName は、使用情報をキャプチャするために PowerPivot for SharePoint のインストールで使用されます。 ユーザー ID がサーバーに提供されるため、ユーザー ID を含むイベントまたはエラーをログ ファイルに記録できます。 PowerPivot の場合、承認の目的では使用されません。 |
| パスワードの暗号化 | ローカル キューブの暗号化にローカル パスワードを使用するかどうかを指定します。 有効な値は True または False です。 既定値は False です。 |
Encryption Password |
暗号化されたローカル キューブの暗号化を解除するために使用されるパスワード。 既定値は空です。 この値は、ユーザーが明示的に設定する必要があります。 |
Impersonation Level |
クライアントを偽装するときにサーバーが使用できる権限借用のレベルを示します。 有効な値は次のとおりです。 匿名: クライアントはサーバーに対して匿名です。 サーバー プロセスは、クライアントに関する情報を取得することも、クライアントを偽装することもできません。 識別: サーバー プロセスはクライアント ID を取得できます。 サーバーは承認のためにクライアント ID を偽装できますが、システム オブジェクトにクライアントとしてアクセスすることはできません。 偽装: これが既定値です。 クライアント ID は偽装できますが、すべての呼び出しではなく、接続が確立されている場合にのみ使用できます。 デリゲート: サーバー プロセスは、クライアントの代わりに動作しながら、クライアントのセキュリティ コンテキストを偽装できます。 サーバー プロセスは、クライアントの代理として動作しながら、他のサーバーへの発信呼び出しを行うこともできます。 |
Integrated Security |
呼び出し元の Windows ID は、Analysis Services への接続に使用されます。 有効な値は空白、SSPI、BASIC です。Integrated Security
=
SSPI は、NTLM、Kerberos、または匿名認証を許可する TCP 接続の既定値です。 空白は HTTP 接続の既定値です。SSPIを使用する場合、ProtectionLevelは、Connect、PktIntegrity、PktPrivacyのいずれかに設定する必要があります。 |
Persist Encrypted |
クライアント アプリケーションで、暗号化された形式でパスワードなどの機密性の高い認証情報を保持するデータ ソース オブジェクトが必要な場合に、このプロパティを設定します。 既定では、認証情報は保持されません。 |
Persist Security Info |
有効な値は True と False です。 True に設定すると、接続文字列で以前に指定したユーザー ID やパスワードなどのセキュリティ情報は、接続後に接続から取得できます。 既定値は False です。 |
ProtectionLevel |
接続で使用されるセキュリティ レベルを決定します。 有効な値は次のとおりです。None。 認証されていない接続または匿名接続。 サーバーに送信されたデータに対して認証を実行しません。Connect。 認証された接続。 クライアントがサーバーとの関係を確立した場合にのみ認証します。PktIntegrity。 暗号化された接続。 すべてのデータがクライアントから受信され、転送中に変更されていないことを確認します。PktPrivacy。 署名付き暗号化。XMLA でのみサポートされます。 すべてのデータがクライアントから受信されていること、転送中に変更されていないことを確認し、暗号化することでデータのプライバシーを保護します。詳細については、「ADOMD.NET でのセキュリティで保護された接続の確立」を参照してください。 |
Roles |
そのロールによって伝達されるアクセス許可を使用してサーバーまたはデータベースに接続する定義済みロールのコンマ区切りの一覧を指定します。 このプロパティを省略すると、すべてのロールが使用され、有効なアクセス許可はすべてのロールの組み合わせになります。 プロパティを空の値 (Roles=' 'など) に設定すると、クライアント接続にはロール メンバーシップがありません。 このプロパティを使用する管理者は、ロールによって伝達されるアクセス許可を使用して接続します。 一部のコマンドは、ロールが十分なアクセス許可を提供しない場合に失敗することがあります。 |
SSPI |
Integrated Securityが SSPI に設定されている場合に、クライアント認証に使用するセキュリティ パッケージを明示的に指定します。 SSPI は複数のパッケージをサポートしていますが、このプロパティを使用して特定のパッケージを指定できます。 有効な値は、ネゴシエート、Kerberos、NTLM、匿名ユーザーです。 このプロパティが設定されていない場合、すべてのパッケージが接続で使用できるようになります。 |
Use Encryption for Data |
データ転送を暗号化します。 値は True と False です。 |
User ID=...; Password= |
User ID と Password が一緒に使用されます。 Analysis Services は、これらの資格情報を使用して指定されたユーザー ID を偽装します。 Analysis Services 接続では、コマンド ラインに資格情報を配置することは、サーバーが HTTP アクセス用に構成されていて、IIS 仮想ディレクトリに統合セキュリティではなく基本認証を指定した場合にのみ使用されます。ユーザー名とパスワードは、ローカル ユーザー アカウントまたはドメイン ユーザー アカウントの Windows ID の資格情報である必要があります。 User IDには埋め込みスペースがあることに注意してください。 このプロパティのその他のエイリアスには、 UserName (スペースなし)、および UIDがあります。
PasswordのエイリアスはPWD。 |
特殊な目的のパラメーター
このセクションでは、接続文字列パラメーターの残りの部分について説明します。 これらは、アプリケーションで必要な特定の接続動作を保証するために使用されます。
プロパティはアルファベット順に一覧表示されます。
| プロパティ | 説明 |
|---|---|
Application Name |
接続に関連付けられているアプリケーションの名前を設定します。 この値は、特に複数のアプリケーションが同じデータベースにアクセスしている場合に、トレース イベントを監視する場合に役立ちます。 たとえば、次のスクリーンショットに示すように、接続文字列に Application Name='test' を追加すると、SQL Server Profiler トレースに 'test' が表示されます。
このプロパティのエイリアスには、 sspropinitAppName、 AppNameが含まれます。 詳細については、「 SQL Server に接続するときにアプリケーション名パラメーターを使用する」を参照してください。 |
AutoSyncPeriod |
クライアントとサーバーのキャッシュ同期の頻度 (ミリ秒単位) を設定します。 ADOMD.NET は、メモリ オーバーヘッドが最小限の頻繁に使用されるオブジェクトのクライアント キャッシュを提供します。 これにより、サーバーへのラウンド トリップの数を減らすことができます。 既定値は 1,0000 ミリ秒 (または 10 秒) です。 null または 0 に設定すると、自動同期がオフになります。 |
Character Encoding |
要求で文字をエンコードする方法を定義します。 有効な値は既定値または UTF-8 (同等)、UTF-16 です |
CompareCaseSensitiveStringFlags |
指定したロケールの大文字と小文字を区別する文字列比較を調整します。 このプロパティの設定の詳細については、「 CompareCaseSensitiveStringFlags プロパティ」を参照してください。 |
Compression Level |
TransportCompressionが XPRESS の場合は、圧縮レベルを設定して、使用する圧縮の量を制御できます。 有効な値は 0 ~ 9 で、0 は圧縮率が最も低く、9 は最も圧縮率が高くなります。 圧縮の増加により、パフォーマンスが低下します。 既定値は 0 です。 |
Connect Timeout |
クライアントがタイムアウトするまでに接続を試行する最大時間 (秒単位) を決定します。この期間内に接続が成功しない場合、クライアントは接続を終了し、エラーを生成します。 |
MDX Compatibility |
このプロパティの目的は、MDX クエリを発行するアプリケーションに対して一貫した MDX 動作のセットを確保することです。 Excel では、MDX クエリを使用して Analysis Services に接続されているピボットテーブルを設定および計算し、このプロパティを 1 に設定して、不規則階層のプレースホルダー メンバーがピボットテーブルに表示されるようにします。 有効な値には、0、1、2 が含まれます。 0 と 1 はプレースホルダー メンバーを公開します。2 は行いません。 これが空の場合、0 が想定されます。 |
MDX Missing Member Mode=Error |
MDX ステートメントで不足しているメンバーが無視されるかどうかを示します。 有効な値は、既定値、エラー、および無視です。 既定値では、サーバー定義の値が使用されます。 エラーは、メンバーが存在しない場合にエラーを生成します。 Ignore は、欠損値を無視することを指定します。 |
Optimize Response |
次のクエリ応答の最適化のうち、どの最適化が有効になっているかを示すビットマスク。 0x01: 既定値。 NormalTupleSet を使用する 0x02: スライサーが空の場合に使用する |
Packet Size |
512 から 32,767 までのネットワーク パケット サイズ (バイト単位)。 既定のネットワーク パケット サイズは 4096 です。 |
Protocol Format |
サーバーに送信される XML の形式を設定します。 有効な値は、既定値、XML、またはバイナリです。 プロトコルは XMLA です。 XML を圧縮形式 (既定)、未加工 XML、またはバイナリ形式で送信するように指定できます。 バイナリ形式では XML 要素と属性がエンコードされ、小さくなります。 圧縮は、要求と応答のサイズをさらに小さくする独自の形式です。 圧縮形式とバイナリ形式は、データ転送要求と応答を高速化するために使用されます。 バイナリ形式または圧縮形式を使用する場合は、接続でクライアント ライブラリを使用する必要があります。 OLE DB プロバイダーでは、要求と応答をバイナリ形式または圧縮形式で書式設定できます。 AMO と ADOMD.NET は要求をテキストとして書式設定しますが、応答はバイナリ形式または圧縮形式で受け入れます。 この接続文字列プロパティは、 EnableBinaryXML および EnableCompression サーバーの構成設定と同じです。 |
Real Time Olap |
キャッシュをバイパスするようにこのプロパティを設定すると、すべてのパーティションがクエリ通知をアクティブにリッスンします。 既定では、このプロパティは設定されていません。 |
Safety Options |
ユーザー定義の関数とアクションの安全性レベルを設定します。 有効な値は 0、1、2 です。 Excel 接続では、このプロパティは Safety Options=2 です。 このオプションの詳細については、 ConnectionStringを参照してください。 |
SQLQueryMode |
SQL クエリに計算を含めるかどうかを指定します。 有効な値は、Data、Calculated、IncludeEmpty です。 データは、計算が許可されていないことを意味します。 計算では計算が可能です。 IncludeEmpty を使用すると、計算と空の行をクエリ結果に返すことができます。 |
Timeout |
クライアント ライブラリがコマンドの完了を待機してからエラーが発生するまでの時間 (ミリ秒) を指定します。 |
Transport Compression |
Protocol Format プロパティを使用して圧縮を指定する場合に、クライアントとサーバーの通信を圧縮する方法を定義します。 有効な値は Default、None、Compressed、 gzipです。 既定値は TCP の場合は圧縮なし、HTTP の場合は gzip です。 None は、圧縮が使用されていないことを示します。 Compressed では XPRESS 圧縮が使用されます (SQL Server 2008 以降)。
gzip は HTTP 接続でのみ有効です。HTTP 要求には Accept-Encoding=gzip が含まれます。 |
UseExistingFile |
ローカル キューブに接続するときに使用されます。 このプロパティは、ローカル キューブを上書きするかどうかを指定します。 有効な値は True または False です。 True に設定すると、キューブ ファイルが存在する必要があります。 既存のファイルが接続のターゲットになります。 False に設定すると、キューブ ファイルが上書きされます。 |
VisualMode |
ディメンション セキュリティが適用されたときにメンバーを集計する方法を制御するには、このプロパティを設定します。 すべてのユーザーが表示できるキューブ データの場合、合計に寄与するすべての値が表示されるため、すべてのメンバーを集計することは理にかなっています。 ただし、ユーザー ID に基づいてディメンションをフィルター処理または制限すると、すべてのメンバーに基づいて合計が表示される (制限された値と許可された値の両方を 1 つの合計に結合する) 場合、混乱を招いたり、表示すべき以上の情報が表示されたりする可能性があります。 ディメンション セキュリティの適用時にメンバーを集計する方法を指定するには、このプロパティを True に設定して集計で使用できる値のみを使用するか、False を設定して制限された値を合計から除外することができます。 接続文字列に設定すると、この値はキューブまたはパースペクティブ レベルに適用されます。 モデル内では、ビジュアルの合計をより細かいレベルで制御できます。 有効な値は 0、1、2 です。 既定値は 0 です。 現在、既定の動作は 2 に相当し、集計にはユーザーに表示されない値が含まれます。 1 は、合計から非表示の値を除外します。 これは Excel の既定値です。 2 には、合計に非表示の値が含まれます。 これはサーバーの既定値です。 このプロパティのエイリアスには、 Visual Total または Default MDX Visual Modeが含まれます。 |
将来の使用のために予約済み
接続文字列では次のプロパティを使用できますが、Analysis Services の現在のリリースでは動作しません。
認証済みユーザー
キャッシュ認証
キャッシュ モード (このプロパティの使用は、以前のリリースで調査されました。使用を推奨するブログ記事は見つかるかもしれませんが、Microsoft サポートの指示がない限り、このプロパティの設定は避ける必要があります)。
キャッシュ ポリシー
キャッシュの比率
キャッシュ比率2
動的デバッグの制限
デバッグ モード
モード
SQLCompatibility
数式キャッシュを使用する
接続文字列の例
このセクションでは、一般的に使用されるアプリケーションで Analysis Services 接続を設定するときに使用する可能性が最も高い接続文字列を示します。
汎用接続文字列
Reporting Services から接続を構成する場合は、次のような接続文字列を使用できます。
Data source=<servername>; initial catalog=<databasename>
Excel の接続文字列
Excel の既定の ADOMD.NET 接続文字列は、データ プロバイダー、サーバー、データベース名、Windows 統合セキュリティを指定します。 MDX 互換性レベルは常に 1 に設定されます。 現在のセッションの値は変更できますが、ファイルが次に開かれると、MDX 互換性が 1 にリセットされます。
Provider=MSOLAP.5;Integrated Security=SSPI;Persist Security Info=True;Initial Catalog=Adventure Works DW 2008R2;Data Source=AW-SRV01;MDX Compatibility=1;Safety Options=2;MDX Missing Member Mode=Error
詳細については、「Reporting Services のデータ接続、データ ソース、接続文字列」および「SharePoint Server 2013 の Excel Services のデータ認証」を参照してください。
Analysis Services で使用される接続文字列の形式
このセクションでは、Analysis Services でサポートされているすべての接続文字列形式を示します。 PowerPivot データベースへの接続を除き、Analysis Services に接続するアプリケーションでこれらの接続文字列を指定できます。
サーバーへのネイティブ (または直接) 接続
Data Source=server[:port][\instance] ここで、"port" と "\instance" は省略可能です。 たとえば、"Data Source=server1" を指定すると、"server1" という名前のサーバー上の既定のインスタンス (および既定のポート 2383) への接続が開きます。
"Data Source=server1:port1" は、"server1" のポート "port1" で実行されている Analysis Services インスタンスへの接続を開きます。
"Data Source=server1\instance1" は SQL Browser (既定のポート 2382) への接続を開き、名前付きインスタンス "instance1" のポートを解決してから、その Analysis Services ポートへの接続を開きます。
"Data Source=server1:port1\instance1" は、"port1" で SQL Browser への接続を開き、"instance1" という名前のインスタンスのポートを解決してから、その Analysis Services ポートへの接続を開きます。
ローカル キューブ接続 (.cub ファイル)
Data Source=<path>(例: "Data Source=c:\temp\a.cub"
msmdpump.dllへの Http 接続
Data Source=<URL>URL は、msmdpump.dllを含む仮想 IIS フォルダーへの HTTP または HTTPS アドレスです。 詳細については、「 インターネット インフォメーション サービス (IIS) 8.0 で Analysis Services への HTTP アクセスを構成する」を参照してください。
PowerPivot ブック (.xlsx、.xlsb、または .xlsm ファイル) への Http 接続
Data Source=<URL>:URL は、SharePoint ライブラリに発行された PowerPivot ブックへの SharePoint パスです。 たとえば、"Data Source=https://localhost/Shared Documents/Sales.xlsx" などです。
BI セマンティック モデル接続ファイルへの Http 接続
Data Source=<URL> ここで、URL は .bism ファイルへの SharePoint パスです。 たとえば、"Data Source=https://localhost/Shared Documents/Sales.bism" などです。
埋め込み式 PowerPivot 接続
Data Source=$Embedded$ ここで、$embedded$ は、ブック内の埋め込み PowerPivot データ モデルを参照するモニカーです。 この接続文字列は、内部で作成および管理されます。 変更しないでください。 埋め込み接続文字列は、クライアント ワークステーション上の PowerPivot for Excel アドイン、または SharePoint ファーム内の PowerPivot for SharePoint インスタンスによって解決されます。
Analysis Services ストアド プロシージャのローカル サーバー コンテキスト
Data Source=** はローカルインスタンスに対して解決されます。
接続文字列の暗号化
Analysis Services は、各データ ソースへの接続に使用する接続文字列を暗号化して格納します。 データ ソースへの接続にユーザー名とパスワードが必要な場合は、Analysis Services に接続文字列を含む名前とパスワードを格納してもらうか、データ ソースへの接続が必要になるたびに名前とパスワードの入力を求めることができます。 Analysis Services からユーザー情報の入力を求められると、この情報を保存して暗号化する必要がないことを意味します。 ただし、この情報を接続文字列に格納する場合は、この情報を暗号化してセキュリティで保護する必要があります。
接続文字列情報を暗号化してセキュリティで保護するために、Analysis Services は Data Protection API を使用します。 Analysis Services では、個別の暗号化キーを使用して、各 Analysis Services データベースの接続文字列情報を暗号化します。 Analysis Services では、データベースの作成時にこのキーが作成され、Analysis Services スタートアップ アカウントに基づいて接続文字列情報が暗号化されます。 Analysis Services が起動すると、各データベースの暗号化されたキーが読み取り、復号化、および格納されます。 Analysis Services は、Analysis Services がデータ ソースに接続する必要がある場合に、適切な復号化されたキーを使用してデータ ソース接続文字列情報の暗号化を解除します。
こちらもご覧ください
インターネット インフォメーション サービス (IIS) 8.0 で Analysis Services への HTTP アクセスを構成する
Kerberos の制約付き委任のための Analysis Services の構成
Analysis Services 接続に使用されるデータ プロバイダー
Analysis Services への接続