配置ユーティリティを使用してモデル ソリューションをデプロイする
適用対象:
SQL Server Analysis Services Azure Analysis Services Power BI Premium
Microsoft.AnalysisServices.Deployment ユーティリティを使用すると、コマンド プロンプトAnalysis Services展開エンジンを起動できます。 このユーティリティは、入力ファイルとして、プロジェクト内のプロジェクトをビルドして生成Analysis Services XML 出力ファイルをSQL Server Data Tools。 入力ファイルを簡単に変更して、プロジェクトのデプロイをカスタマイズAnalysis Servicesできます。 生成された配置スクリプトは直ちに実行することも、今後の配置のために保存することもできます。
Analysis Services 配置ウィザード/ユーティリティは、SQL Server Managment Studio (SSMS) と一緒にインストールされます。 最新バージョンを使用してください。 既定では、SSMS 18.x 以上でインストールされている配置ユーティリティの最新バージョンは、C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE にインストールされます。 以前の SSMS SSMS 17.x でインストールされている場合、既定のパスは C:\Program Files (x86)\Microsoft SQL Server\140\Tools\Binn\ManagementStudio です。
構文
Microsoft.AnalysisServices.Deployment [ASdatabasefile]
{[/s[:logfile]] | [/a] | [[/o[:output_script_file]] [/d]]}
引数
ASdatabasefile
配置スクリプト (.asdatabase) ファイルAnalysis Servicesフォルダーの完全なパス。 このファイルは、プロジェクトをプロジェクトに配置するときに生成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\140\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