適用対象:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
Microsoft.AnalysisServices.Deployment ユーティリティを使用すると、コマンド プロンプトから SQL Server Analysis Services 配置エンジンを起動できます。 このユーティリティは、入力ファイルとして、SQL Server Data Tools で SQL Server Analysis Services プロジェクトをビルドすることによって生成された XML 出力ファイルを使用します。 入力ファイルは、SQL Server Analysis Services プロジェクトの展開をカスタマイズするために簡単に変更できます。 生成されたデプロイ スクリプトは、後でデプロイするためにすぐに実行または保存できます。
SQL Server Analysis Services 展開ウィザード/ユーティリティは、 SQL Server Managment Studio (SSMS) と共にインストールされます。 最新バージョンを使用していることを確認してください。 既定では、SSMS 18.x 以降でインストールされた最新バージョンの展開ユーティリティは、C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE にインストールされます。 以前の 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
SQL Server Analysis Services 配置スクリプト (.asdatabase) ファイルが配置されているフォルダーの完全なパス。 このファイルは、SQL Server Data Tools でプロジェクトを配置するときに生成されます。 プロジェクトの bin フォルダーにあります。 .asdatabase ファイルには、配置するオブジェクト定義が含まれています。 指定しない場合は、現在のフォルダーが使用されます。
/S
ユーティリティをサイレント モードで実行し、ダイアログ ボックスは表示しません。 モードの詳細については、このトピックの「 モード」セクションを参照してください。
ログファイル
ログ ファイルの完全なパスとファイル名。 トレース イベントは、指定されたログ ファイルに記録されます。 ログ ファイルが既に存在する場合は、ファイルの内容が置き換えられます。
/ある
応答モードでユーティリティを実行します。 ユーティリティのウィザード部分で行われたすべての応答は、入力ファイルに書き戻す必要がありますが、実際にはデプロイ ターゲットに変更は加えわれません。
/o
出力モードでユーティリティを実行します。 配置は行われませんが、通常は配置ターゲットに送信される XML for Analysis (XMLA) スクリプトは、代わりに指定された出力スクリプト ファイルに保存されます。
output_script_fileが指定されていない場合、ユーティリティは、配置オプション (.deploymentoptions) 入力ファイルで指定された出力スクリプト ファイルの使用を試みます。 デプロイ オプションの入力ファイルに出力スクリプト ファイルが指定されていない場合は、エラーが発生します。
モードの詳細については、このトピックの「 モード」セクションを参照してください。
output_script_file
出力スクリプト ファイルの完全なパスとファイル名。
/d
/o 引数を使用する場合は、ユーティリティがターゲット インスタンスに接続しないように指定します。 デプロイ ターゲットへの接続は行われないため、出力スクリプトは入力ファイルから取得された情報のみに基づいて生成されます。
注
/d 引数は、出力モードでのみ使用されます。 この引数は、応答モードまたはサイレント モードで指定されている場合は無視されます。 モードの詳細については、このトピックの「 モード」セクションを参照してください。
注釈
Microsoft.AnalysisServices.Deployment ユーティリティは、オブジェクト定義、展開ターゲット、展開オプション、および構成設定を提供する一連のファイルを取得し、指定した展開オプションと構成設定を使用して、指定した展開ターゲットにオブジェクト定義を展開しようとします。 このユーティリティは、応答ファイルまたは出力モードで呼び出されたときにユーザー インターフェイスを提供できます。 このユーティリティに提供されているユーザー インターフェイスを使用して応答ファイルを作成する方法の詳細については、「 配置ウィザードを使用してモデル ソリューションを配置する」を参照してください。
このユーティリティは、\Program ファイル (x86)\Microsoft SQL Server\140\Binn\ManagementStudio フォルダーにあります。
モード
このユーティリティは、次の表に示すモードで実行できます。
| Mode | Description |
|---|---|
| サイレント モード | ユーザー インターフェイスは表示されておらず、デプロイに必要なすべての情報が入力ファイルによって提供されます。 ユーティリティがサイレント モードで進行状況を表示しません。 代わりに、オプションのログ ファイルを使用して、後で確認できるように進行状況とエラー情報をキャプチャできます。 |
| 応答モード | 展開ウィザードのユーザー インターフェイスが表示され、後で展開するために、指定された入力ファイルにユーザー応答が保存されます。 デプロイは応答モードでは行われません。 応答モードの唯一の目的は、ユーザーの応答をキャプチャすることです |
| 出力モード | ユーザー インターフェイスは表示されておらず、デプロイに必要なすべての情報が入力ファイルによって提供されます。 ただし、サイレント・モードとは異なり、ユーティリティーからの出力は出力スクリプト・ファイルに書き込まれ、入力ファイルに示されているデプロイメント・ターゲットには送信されません。 /d 引数を指定しない限り、ユーティリティは各デプロイ ターゲットと接続して、出力スクリプト ファイルの生成中にメタデータを比較します。 |
例示
次の例は、SQL Server 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