デプロイメントウィザードを使用して、モデルソリューションをデプロイする。
適用対象:
SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium
SQL Server Analysis Services配置ウィザードでは、SQL Server Analysis Services プロジェクトから生成された JSON 出力ファイルを入力ファイルとして使用します。 これらの入力ファイルは、SQL Server Analysis Services プロジェクトの配置をカスタマイズするために簡単に変更できます。 生成された配置スクリプトは直ちに実行することも、今後の配置のために保存することもできます。
展開ウィザード/ユーティリティは、SQL Server Management Studio (SSMS) と共にインストールされます。 最新バージョンを使用していることを確認します。 コマンド プロンプトから実行している場合、既定では、展開ウィザードの最新バージョンが C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE にインストールされます。
こちらの説明に従って、ウィザードを使用して展開できます。 配置を自動化したり、同期機能を使用したりすることもできます。 配置するデータベースが大きい場合は、配置先のシステムでパーティションを使用することを検討してください。 パーティションの作成と作成を自動化するには、表形式オブジェクト モデル (TOM)、表形式モデルの書き込み言語 (TMSL)、および分析管理オブジェクト (AMO) を使用します。
重要
データ ソースまたは偽装の目的で接続文字列で指定されている場合、出力ファイルもデプロイ スクリプトにもユーザー ID またはパスワードは含めなくなります。 このシナリオの処理ではユーザー ID およびパスワードが必要であるため、この情報を手動で追加します。 配置の際に処理を行わない場合は、この接続および権限借用のための情報を必要に応じて配置後に追加できます。 配置の際に処理を行う場合は、この情報をウィザードで入力するか、保存した配置スクリプトに追加することができます。
展開ウィザードを実行する
展開ウィザードは、次の方法で実行できます。
対話形式 - 対話形式で実行すると、ユーザー入力によって対話形式で変更された入力ファイルに基づいて配置スクリプトが生成されます。 ユーザーによる変更は、配置スクリプトのみに適用されます。 入力ファイルが変更されることはありません。
コマンド プロンプト から - コマンド プロンプトで を実行すると、展開ウィザードは、ウィザードの実行に使用するスイッチに基づいて配置スクリプトを生成します。 ウィザードでは、ユーザーの入力を求めてその入力に基づいて入力ファイルを変更するか、入力ファイルをそのまま使用して自動的に配置を実行するか、後で使用可能な配置スクリプトを作成します。
対話形式で実行する
対話形式で実行すると、配置ウィザードによって入力ファイルから値が読み取られ、この情報が表示されます。 これらの入力値 (展開先、構成設定、展開オプション、パスワードの接続文字列など) を変更するか、そのままにしておくことができます。 入力値を変更すると、ウィザードは配置スクリプトの生成時にこれらの変更を使用します。 ただし、入力ファイルの値は変更されません。
注意
展開ウィザードで入力値を変更する場合は、コマンド プロンプトでウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。
入力値を確認し、必要な変更を行うと、ウィザードによって配置スクリプトが生成されます。 この配置スクリプトは配置先サーバーで直ちに実行することも、後で使用するために保存することもできます。
Analysis Services 配置ウィザードを対話的に実行するには
[ スタート] をクリックし、「 Analysis Services 配置ウィザード」と入力します。
または
SQL Server Analysis Services プロジェクトの [プロジェクト] フォルダーで、プロジェクト名>.asdatabase ファイルを<ダブルクリックします。
注意
.asdatabase ファイルが見つからない場合は、「*.asdatabase」を指定して検索してみてください。 または、SSDT でプロジェクトをビルドする必要がある場合があります。
コマンド プロンプトで を実行する
展開ウィザードは、コマンド プロンプトで実行することもできます。 コマンド プロンプトで を実行する場合は、.asdatabase ファイルへの完全なパスを指定し、次のいずれかのモードでウィザードを実行します。
応答ファイル モード
応答ファイル モードでは、SQL Server Analysis Services プロジェクトがSQL Server Data Toolsでビルドされたときに最初に生成された入力ファイルを対話的に変更できます。 ウィザードは、展開スクリプトを生成する前に、これらの変更された入力ファイルを保存します。 変更された入力ファイルは、次にウィザードを実行したときの開始点として使用されます。
応答ファイル モードでウィザードを実行するには、 /a スイッチを使用します。
サイレント モード
サイレント モードでは、ウィザードは入力ファイルに含まれている情報に基づいて、自動的に配置を実行します。
ウィザードをサイレント モードで実行するには、 /s スイッチを使用します。 サイレント モードでウィザードを実行した場合、メッセージはコンソールに出力されます。ログ ファイルを指定した場合はログ ファイルに出力されます。
出力モード
出力モードでは、ウィザードは入力ファイルに基づいて後で実行するための配置スクリプトを生成します。
出力モードでウィザードを実行するには、 /o スイッチを使用し、出力ファイル名を指定します。
これらのコマンド ライン スイッチの詳細については、「 配置ユーティリティを使用してモデル ソリューションをデプロイする」を参照してください。
Analysis Services 配置ウィザードをコマンド プロンプトで実行するには
SSMS 18.x でインストールされている場合は、コマンド プロンプトを開き、既定のパス C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE に移動します。
「 Microsoft.AnalysisServices.Deployment.exe 」の後に、ウィザードを実行するモードに対応するスイッチを入力します。
配置スクリプトについて理解する
展開ウィザードによって生成される XMLA 配置スクリプトは、次の 2 つのセクションで構成されます。
デプロイ スクリプトの最初の部分には、移行先データベース内の適切な Microsoft SQL Server オブジェクトを作成、変更、または削除するために必要なコマンドが含まれています。 既定では、SQL Server Analysis Services プロジェクトによって生成される入力ファイルは、増分配置に基づいています。 そのため、XMLA 配置スクリプトは、変更または削除されたオブジェクトにしか影響しません。
配置スクリプトの 2 番目の部分には、配置先サーバー上で作成または変更されたオブジェクトのみを処理するために必要なコマンド (既定の処理のオプション)、または配置先データベースを完全に処理するために必要なコマンドが含まれています。 また、配置スクリプトに処理コマンドを含めないこともできます。
配置スクリプト全体は、単一のトランザクションまたは複数のトランザクションで実行できます。 スクリプトを複数のトランザクションで実行する場合は、スクリプトの最初の部分が単一のトランザクションとして実行され、各オブジェクトはそれぞれのトランザクションで処理されます。
重要
SQL Server Analysis Services展開ウィザードでは、オブジェクトを 1 つのSQL Server Analysis Services データベースにのみ展開します。 サーバー レベルのオブジェクトまたはデータは配置しません。
デプロイ スクリプト ファイル - デプロイ スクリプトを作成するために使用される入力
プロジェクトをビルドすると、プロジェクトのファイルSQL Server Data Tools生成されます。 SQL Server Data Tools、これらのファイルをプロジェクトの Output フォルダーに配置します。 既定では、出力は \Bin フォルダーに格納されます。 次の表に、作成SQL Server Data Tools XML ファイルの一覧を示します。
| ファイル | 説明 |
|---|---|
| <プロジェクト名>。asdatabase | 多次元または 1100/1103 表形式モデル プロジェクト用の XMLA ファイル、または表形式 1200 以降のモデル プロジェクト用の JSON ファイル。 プロジェクト内のすべてのSQL Server Analysis Services オブジェクトの宣言型定義が含まれます。 |
| <プロジェクト名>。deploymenttargets | SQL Server Analysis Services オブジェクトが作成されるSQL Server Analysis Services インスタンスとデータベースの名前を格納します。 |
| <プロジェクト名>。configsettings | データ ソース接続情報やオブジェクト格納場所など、環境に固有の設定が含まれています。 このファイルの設定は、プロジェクト名>.asdatabase ファイルの<設定をオーバーライドします。 |
| <プロジェクト名>。deploymentoptions | 配置がトランザクションであるかどうかや、配置したオブジェクトを配置後に処理するかどうかなどの配置オプションが含まれています。 |
SQL Server Data Toolsは、パスワードをプロジェクト ファイルに格納しません。
入力ファイルの変更
入力ファイルの値、または入力ファイルから取得した値を変更すると、プロジェクト名>.asdatabase ファイル全体 (または既存のSQL Server Analysis Services データベースからスクリプトを生成する場合はスクリプト ファイル全体<) を編集せずに、配置先、構成設定、および配置オプションを変更できます。 個々のファイルを変更できると、さまざまな目的に合わせてさまざまな配置スクリプトを簡単に作成できます。
配置スクリプト ファイル - インストール 先の指定
配置ウィザードは、プロジェクト名>.deploymenttargets ファイルから<インストール 先の情報を読み取ります。 SQL Server Data Toolsは、プロジェクトをビルドするときにこのファイルを作成します。 SQL Server Data Toolsは、プロジェクト名>[プロパティ ページ] ダイアログ ボックスの<[配置] ページで指定されたデータベースとサーバーを使用して、プロジェクト名>.targets ファイルを<作成します。
インストール 先の変更
状況によっては、[配置] ページで指定したプロジェクトとは異なるデータベースまたはインスタンスにプロジェクトを 配置 することが必要になる場合があります。 たとえば、配置前のテストを行うためにプロジェクトをサーバーに配置し、テストの完了後にそのプロジェクトを実稼働サーバーに配置する必要が生じることがあります。 また、完成したテスト済みのプロジェクトをネットワーク負荷分散クラスター内の複数の実稼働サーバーに配置するか、ステージング サーバーおよび実稼働サーバーに配置する必要が生じることもあります。
プロジェクトを別のデータベースまたはインスタンスに配置するには、次の手順で説明する方法のいずれかを使用して、入力ファイルのインストール 先を変更します。
入力ファイルの生成後にインストール先を変更するには
SQL Server Analysis Services展開ウィザードを対話形式で実行します。 [インストール 先] ページで、SQL Server Analysis Services インスタンスとデータベースの新しい変換先を指定します。
または
コマンド プロンプトでSQL Server Analysis Services展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。
または
任意のテキスト エディターを<使用して、プロジェクト名>.deploymenttargets ファイルを変更します。
配置スクリプト ファイル - パーティションおよびロールの配置オプション
配置ウィザードは、プロジェクト名>.deploymentoptions ファイルからパーティションとロールの<配置オプションを読み取ります。 SQL Server Data Toolsは、プロジェクトをビルドするときにこのファイルを作成します。 SQL Server Data Toolsプロジェクト名>.deploymentoptions ファイルの作成時に、現在のプロジェクトのパーティションとロールの<配置オプションを使用します。
パーティションとロールのデプロイ オプションの確認
プロジェクト名>.deploymentoptions ファイルの<配置オプションには、次のものがあります。
パーティション配置オプション
プロジェクト名>.deploymentoptions ファイルは<、コピー先データベース内の既存のパーティションを保持するか上書きするかを指定します (既定値)。 既存のパーティションを保持する場合、新しいパーティションのみが配置され、既存のすべてのメジャー グループのパーティションおよび集計デザインはそのまま残されます。
パーティションが含まれているメジャー グループを削除すると、パーティションも自動的に削除されます。
ロール配置オプション
プロジェクト名>.deploymentoptions ファイルは<、次のいずれかのロール配置オプションを指定します。
配置先データベースの既存のロールおよびロール メンバーは保持され、新しいロールおよびロール メンバーのみが配置されます。
配置先データベースの既存のすべてのロールおよびメンバーは、配置するロールおよびメンバーに置き換えられます。
配置先データベースの既存のロールおよびロール メンバーは保持され、新しいロールは配置されません。
既存のロールとメンバーが保持されると、それらのロールに関連付けられているアクセス許可は none にリセットされます。 セキュリティ権限は、オブジェクトが関連付けられているセキュリティ ロールではなく、オブジェクト自体に含まれています。 Analysis Service 配置ウィザードを使用してこの動作を操作する方法の詳細については、Microsoft サポート技術情報の「ロールとメンバーの保持」を参照してください。
パーティションとロールのデプロイ オプションの変更
プロジェクト名>.deploymentoptions ファイルに格納されているものとは異なるパーティションとロールのオプションを使用して、プロジェクトを<配置する必要がある場合があります。 たとえば、プロジェクト名>.deploymentoptions ファイルに示されているように、既存のすべてのパーティション、ロール、およびメンバーを置き換える代わりに、既存のパーティション、ロール、ロール メンバーを<保持することができます。
プロジェクト内のパーティションとロールの配置を変更するには、プロジェクト内のパーティションとロールの設定を<変更できません。SQL Server Data Toolsのプロジェクト名>の [プロパティ ページ] ダイアログ ボックスにはこれらのオプションが表示されないためです。 ロールとパーティションの配置オプションを変更する場合は、プロジェクト名>.deploymentoptions ファイル自体内で<この情報を変更する必要があります。 次の手順では、プロジェクト名>.deploymentoptions ファイル内のパーティションとロールの配置オプションを<変更する方法について説明します。
入力ファイルの生成後にパーティションまたはロールの配置を変更するには
展開ウィザードを対話形式で実行し、[ パーティションとロールの展開オプション] ページで、パーティションとロールの新しい展開オプションを指定します。
または
コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。
または
任意の<テキスト エディターでプロジェクト名>.deploymentoptions を開き、オプションを手動で変更します。 PartitionDeployment のオプションは、DeployPartitions、RetainPartitions です。 RoleDeployment のオプションは、DeployRolesAndMembers、DeployRolesRetainMembers、RetainRoles です。
配置スクリプト ファイル - ソリューション展開の構成設定
配置ウィザードは、配置スクリプトで使用するパーティションとロールの配置オプションを <プロジェクト名>.configsettings ファイルから読み取ります。 多次元プロジェクトの場合、SQL Server Data Toolsプロジェクトのビルド時にこのファイルが作成されます。 表形式プロジェクトの場合、バージョンによっては、応答モードで配置ウィザードを実行して .configsettings ファイルを生成することが必要な場合があります。 SQL Server Data Toolsは、現在のプロジェクトの構成設定を使用して、プロジェクト名>.configsettings ファイルを作成<します。
構成設定の確認
プロジェクト名>.configsettings ファイルに<格納されている構成設定を次に示します。
データ ソースの接続文字列 - プロジェクトで指定された値に基づく各データ ソースの接続文字列です。 このファイルに接続文字列が保存される際には、常にユーザー ID とパスワードが削除されます。 ただし、配置ウィザードで Analysis Services インスタンスに直接配置を行う場合は、ウィザードで適切なユーザー ID とパスワードを入力して、配置するデータベースを正常に処理することができます。 配置ウィザードで配置スクリプトを保存する場合、この接続情報は配置スクリプト内に保存されません。
偽装アカウント - この設定では、各データ ソースでステートメントを実行するために使用SQL Server Analysis Servicesユーザー名を指定します。 偽装アカウントが指定されていない場合、SQL Server Analysis Servicesはログオン アカウントを使用してステートメントを実行します。 ログオン アカウントにデータ ソース内のアクセス許可が直接付与されている場合、SQL Server Analysis Services インスタンス内のすべてのデータベースのすべてのデータベース管理者は、ログオン アカウントを介してデータ ソースにアクセスできます。 ユーザー アカウントとパスワードが指定された場合、このファイルに権限借用情報が保存される前に常にこの情報は削除されます。 ただし、配置ウィザードで Analysis Services インスタンスに直接配置を行う場合は、ウィザードで適切なユーザー ID とパスワードを入力して、配置するデータベースを正常に処理することができます。 配置ウィザードで配置スクリプトを保存する場合、この権限借用情報は配置スクリプト内に保存されません。
注意
構造化プロバイダー データ ソース接続との互換性レベルが 1400 以上の表形式モデルの場合、ウィザードの [構成プロパティの指定] ページで [ 既存のオブジェクトの構成設定を保持 する] を選択すると、ターゲット サーバーの表形式モデル データベースに格納されているユーザー名とパスワードは保持されません。 管理者は、デプロイの完了後に SSMS を使用してユーザー名とパスワードを手動で設定する必要があります。
キー エラー ログ ファイル - この設定では、データベース内のキューブ、メジャー グループ、パーティション、およびディメンションごとに、キー エラー ログ ファイルのファイル名とパスを指定します。
[記憶域の場所] - この設定では、データベース内のキューブ、メジャー グループ、パーティションごとに格納場所を指定します。 オブジェクトに値が指定されていない場合、配置ウィザードは オブジェクトの既定の場所を使用します。 たとえば、パーティションはメジャー グループの場所を使用し、メジャー グループはキューブの場所を使用し、キューブはサーバー インスタンス上のオブジェクトの既定の場所を使用します。 ストレージの場所には、ローカルまたは汎用名前付け規則 (UNC) のどちらかのパスを指定できます。
レポート サーバー - この設定では、データベース内の各キューブで定義されている各レポート アクションのレポート サーバーとフォルダーの場所を指定します。
構成設定の変更
場合によっては、プロジェクト名>.configsettings ファイルに格納されているものとは異なる構成設定を<使用してプロジェクトを配置する必要がある場合があります。 たとえば、1 つまたは複数のデータ ソースへの接続文字列を変更するか、特定のパーティションまたはメジャー グループのストレージの場所を指定する必要が生じることがあります。
プロジェクト内のパーティションとロールの配置を変更するには、以下の手順で説明するように、プロジェクト名>.configsettings ファイル内<でこの情報を変更する必要があります。 SQL Server Data Toolsのプロジェクト名>[プロパティ ページ] ダイアログ ボックスにこれらのオプションが表示されないため<、プロジェクト内のパーティションとロールの設定を変更することはできません。
注意
構成設定は、すべてのオブジェクトに適用することも、新たに作成したオブジェクトのみに適用することもできます。 構成設定を新しく作成したオブジェクトに適用するのは、以前に配置したSQL Server Analysis Services データベースに追加のオブジェクトを展開し、既存のオブジェクトを上書きしない場合のみです。 構成設定をすべてのオブジェクトに適用するか、新しく作成したオブジェクトにのみ適用するかを指定するには、プロジェクト名>.deploymentoptions ファイルで<このオプションを設定します。
入力ファイルの生成後に構成設定を変更するには
配置ウィザードを対話形式で実行し 、[構成設定] ページで、展開するオブジェクトの構成設定を指定します。
または
コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。
または
任意のテキスト エディターを<使用して、プロジェクト名>.configsettings ファイルを変更します。
デプロイ スクリプト ファイル - 処理オプション
配置ウィザードは、プロジェクト名>.deploymentoptions ファイルから<処理オプションを読み取ります。 SQL Server Data Toolsは、プロジェクトをビルドするときにこのファイルを作成します。 SQL Server Data Toolsは、プロジェクト名>の [プロパティ ページ] ダイアログ ボックスの<[配置] ページで指定された処理オプションを使用して、プロジェクト名>.deploymentoptions ファイルを<作成します。
処理オプションの確認
プロジェクト名>.deploymentoptions ファイル内に<格納される構成設定は次のとおりです。
[処理方法] - この設定では、展開後に展開されたオブジェクトを処理するかどうか、および実行される処理の種類を制御します。 処理オプションには次の 3 つがあります。
既定の処理 (既定値) は、データベース オブジェクトの処理状態を検出し、処理されていないオブジェクトまたは部分的に処理されたオブジェクトを完全に処理された状態に配信するために必要な処理を実行します。
完全処理では、オブジェクトとそのオブジェクトに含まれるすべてのオブジェクトが処理されます。 既に処理されているオブジェクトに対して完全処理を実行すると、Analysis Services によってそのオブジェクトに含まれているすべてのデータが削除されてから、オブジェクトの処理が開始されます。
None は、処理が実行されていないことを意味します。
書き戻しテーブルのオプション - プロジェクトで書き戻しが有効になっている場合、この設定では、書き戻しの処理方法を定義します。 書き戻しテーブル オプションには次の 3 つがあります。
既定では、書き戻しテーブルが存在する場合、そのテーブルが使用されます。 書き戻しテーブルが存在しない場合は、新しい書き戻しテーブルが作成されます。
書き戻しテーブルが既に存在する場合、配置は失敗します。 書き戻しテーブルが存在しない場合は、新しい書き戻しテーブルが作成されます。
書き戻しテーブルが既に存在するかどうかにかかわらず、新しい書き戻しテーブルが作成されます。 この場合、配置ウィザードによって既存のテーブルが削除され、新しい書き戻しテーブルに置き換えられます。
トランザクション デプロイ - この設定では、メタデータの変更とプロセス コマンドの展開を 1 つのトランザクションで行うか、別のトランザクションで行うかを制御します。
このオプションが True (既定値) の場合、SQL Server Analysis Servicesは、すべてのメタデータ変更とすべてのプロセス コマンドを 1 つのトランザクション内にデプロイします。
このオプションが False の場合、SQL Server Analysis Servicesはメタデータの変更を 1 つのトランザクションにデプロイし、各処理コマンドを独自のトランザクションにデプロイします。
処理オプションの変更
ただし、プロジェクト名>.deploymentoptions ファイルに格納されているものとは異なる処理オプションを使用してプロジェクトを<配置する必要がある場合があります。 たとえば、すべてのオブジェクトを完全に処理するか、既定の処理オプションを使用して処理するか、まったく処理しないようにする必要が生じることがあります。 キューブまたはディメンションが書き込み可能である場合は、新しい書き戻しテーブルまたは既存の書き戻しテーブルのどちらを使用するかを指定できます。
配置時に使用する処理オプションを変更するには、プロジェクトを編集して再作成するか、次の手順のいずれかの方法に従って入力ファイル内の処理オプションを変更できます。
入力ファイルの生成後に処理オプションを変更するには
展開ウィザードを対話形式で実行します。 [処理オプション] ページで、配置するプロジェクトの処理オプションを指定します。
または
コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。
または
任意のテキスト エディターを<使用して、プロジェクト名>.deploymentoptions ファイルを変更します。
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示