配置ユーティリティを使用したモデル ソリューションの配置
Microsoft.AnalysisServices.Deployment ユーティリティを使用すると、コマンド プロンプトから Microsoft SQL Server Analysis Services 展開エンジンを起動できます。 入力ファイルとして、ユーティリティは、SQL Server Data Tools (SSDT) で Analysis Services プロジェクトをビルドすることによって生成された XML 出力ファイルを使用します。 入力ファイルは、Analysis Services プロジェクトの配置をカスタマイズするために簡単に変更できます。 生成された配置スクリプトは直ちに実行することも、今後の配置のために保存することもできます。
構文
Microsoft.AnalysisServices.Deployment [ASdatabasefile]
{[/s[:logfile]] | [/a] | [[/o[:output_script_file]] [/d]]}
引数
ASdatabasefile
Analysis Services 配置スクリプト (.asdatabase) ファイルがあるフォルダーの完全パス。 このファイルは、プロジェクトを SQL Server Data Tools に配置するときに生成されます。 このファイルは、プロジェクトの bin フォルダーに配置されます。 .asdatabase ファイルには、配置されるオブジェクト定義が保存されている場所が含まれています。 指定されない場合、現在のフォルダーが使用されます。
/s
このユーティリティをサイレント モードで実行し、ダイアログ ボックスが表示されないようにします。 モードの詳細については、このトピックの後半にある「 モード」を参照してください。
ログファイル
ログ ファイルの完全パスとファイル名を指定します。 指定したログ ファイルにトレース イベントのログが記録されます。 ログ ファイルが既に存在する場合は、ファイルの内容が置き換えられます。
/a
このユーティリティをアンサー モードで実行します。 このユーティリティのウィザード部分での応答はすべて入力ファイルに書き戻されますが、実際には、配置ターゲットに変更が加えられることはありません。
/O
このユーティリティを出力モードで実行します。 配置は行われません。ただし、通常は配置ターゲットに送信される XML for Analysis (XMLA) スクリプトが、指定された出力スクリプト ファイルに保存されます。 output_script_file が指定されない場合、このユーティリティは、配置オプション (.deploymentoptions) 入力ファイルで指定された出力スクリプト ファイルの使用を試みます。 出力スクリプト ファイルが配置オプション入力ファイルで指定されていない場合は、エラーが発生します。
モードの詳細については、このトピックの後半にある「 モード」を参照してください。
output_script_file
出力スクリプト ファイルの完全パスとファイル名を指定します。
/d
/o 引数が使用されている場合は、このユーティリティは対象インスタンスに接続しません。 配置ターゲットへ接続されないため、出力スクリプトは、入力ファイルから取得された情報にのみ基づいて生成されます。
注意
/d 引数は、出力モードでのみ使用されます。 この引数は、アンサー モードまたはサイレント モードで指定された場合には無視されます。 モードの詳細については、このトピックの後半にある「 モード」を参照してください。
解説
Microsoft.AnalysisServices.Deployment ユーティリティは、オブジェクト定義、配置ターゲット、配置オプション、および構成設定を提供する一連のファイルを利用し、指定された配置オプションと構成設定を使用して、指定された配置ターゲットへのオブジェクト定義の配置を試みます。 このユーティリティは、アンサー ファイルまたは出力モードで呼び出された場合にはユーザー インターフェイスを提供することができます。 このユーティリティで提供されたユーザー インターフェイスを使用してアンサー ファイルを作成する方法の詳細については、「 配置ウィザードを使用したモデル ソリューションの配置」をご覧ください。
このユーティリティは、\Program files (x86)\Microsoft SQL Server\110\Binn\ManagementStudio フォルダーにあります。
モード
次の表は、このユーティリティを実行できるモードを示しています。
| モード | 説明 |
|---|---|
| サイレント モード | ユーザー インターフェイスは表示されません。また、配置に必要なすべての情報は入力ファイルによって提供されます。 このユーティリティは、サイレント モードでは進行状況を表示しません。 その代わり、オプションのログ ファイルを使用して進行状況やエラー情報をキャプチャし、後で参照することができます。 |
| アンサー モード | 配置ウィザードのユーザー インターフェイスが表示され、後で配置する場合に備えて、指定された入力ファイルにユーザーの応答が保存されます。 アンサー モードでは配置は行われません。 アンサー モードは、ユーザーの応答をキャプチャする場合にのみ使用できます。 |
| 出力モード | ユーザー インターフェイスは表示されません。また、配置に必要なすべての情報は入力ファイルによって提供されます。 ただし、サイレント モードと異なり、ユーティリティからの出力は出力スクリプト ファイルに書き込まれ、入力ファイルで指定された配置ターゲットには送信されません。 /d 引数が指定されない限り、このユーティリティはそれぞれの配置ターゲットに接続して、出力スクリプト ファイルの生成中にメタデータを比較します。 |
例
次の例は、Analysis Services プロジェクトをサイレント モードで展開し、後で確認するために進行状況とエラー メッセージをログに記録する方法を示しています。
Microsoft.AnalysisServices.Deployment.exe
<drive>:\My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin
/s: C:\ My Documents\Visual Studio 2010\Projects\AdventureWorksProject\Project1\bin\deployment.log