配置ウィザードを使用してモデル ソリューションをデプロイする

適用対象: 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) を使用して、パーティションの作成とデータの入力を自動化できます。

展開ウィザードを実行する

展開ウィザードは、次の方法で実行できます。

• 対話形式 - 対話形式で実行すると、ユーザー入力によって対話形式で変更された入力ファイルに基づいて配置スクリプトが生成されます。 ウィザードは、ユーザーの変更を展開スクリプトにのみ適用します。 ウィザードは入力ファイルを変更しません。

• コマンド プロンプト から - コマンド プロンプトで実行すると、展開ウィザードは、ウィザードの実行に使用するスイッチに基づいて配置スクリプトを生成します。 ウィザードでは、次のいずれかを実行できます。ユーザー入力を求め、その入力に基づいて入力ファイルを変更します。入力ファイルをそのまま使用して、サイレントで無人の展開を実行する。または、後で使用できるデプロイ スクリプトを作成します。

インタラクティブに実行する

対話形式で実行すると、配置ウィザードによって入力ファイルから値が読み取られ、この情報が表示されます。 これらの入力値 (展開先、構成設定、展開オプション、接続文字列パスワードなど) を変更するか、そのままにしておくことができます。 入力値を変更した場合、ウィザードでは、展開スクリプトの生成時にこれらの変更が使用されます。 ただし、ウィザードは入力ファイル内の値を変更しません。

入力値を確認し、必要な変更を加えた後、ウィザードによってデプロイ スクリプトが生成されます。 このデプロイ スクリプトは、移行先サーバーですぐに実行することも、後で使用するために保存することもできます。

Analysis Services 配置ウィザードを対話形式で実行するには

• [ スタート] をクリックし、「 Analysis Services 展開ウィザード」と入力します。

  -又は-

• SQL Server Analysis Services プロジェクトの [プロジェクト ] フォルダーで、 <project name>.asdatabase ファイルをダブルクリックします。

  注

  .asdatabase ファイルが見つからない場合は、検索を使用して *.asdatabase を指定してみてください。 または、SSDT でプロジェクトをビルドする必要がある場合があります。

コマンド プロンプトで実行する

展開ウィザードは、コマンド プロンプトで実行することもできます。 コマンド プロンプトで実行する場合は、.asdatabase ファイルへの完全なパスを指定し、次のいずれかのモードでウィザードを実行します。

応答ファイル モード
応答ファイル モードでは、SQL Server Analysis Services プロジェクトが SQL Server Data Tools でビルドされたときに最初に生成された入力ファイルを対話形式で変更できます。 ウィザードは、展開スクリプトを生成する前に、これらの変更された入力ファイルを保存します。 変更された入力ファイルは、次にウィザードを実行するときの新しい開始点になります。

応答ファイル モードでウィザードを実行するには、 /a スイッチを使用します。

サイレント モード
サイレントモードでは、ウィザードは、入力ファイルに含まれる情報に基づいて、無人展開を実行します。

ウィザードをサイレント モードで実行するには、 /s スイッチを使用します。 ウィザードをサイレント モードで実行すると、メッセージがコンソールまたはログ ファイル (指定されている場合) に出力されます。

出力モード
出力モードでは、ウィザードによって、入力ファイルに基づいて後で実行するための配置スクリプトが生成されます。

出力モードでウィザードを実行するには、 /o スイッチを使用し、出力ファイル名を指定します。

これらのコマンド ライン スイッチの詳細については、「 配置ユーティリティを使用したモデル ソリューションの配置」を参照してください。

コマンド プロンプトで Analysis Services 配置ウィザードを実行するには

1. SSMS 18.x でインストールされている場合は、コマンド プロンプトを開き、既定のパス C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE に移動します。

2. 次に、Microsoft.AnalysisServices.Deployment.exe を実行するウィザードのモードに対応するスイッチを入力してください。

デプロイ スクリプトについて

展開ウィザードによって生成される XMLA 配置スクリプトは、次の 2 つのセクションで構成されます。

• 配置スクリプトの最初の部分には、移行先データベース内の適切な Microsoft SQL Server オブジェクトを作成、変更、または削除するために必要なコマンドが含まれています。 既定では、SQL Server Analysis Services プロジェクトによって生成される入力ファイルは、増分配置に基づいています。 その結果、XMLA デプロイ スクリプトは、変更または削除されたオブジェクトにのみ影響します。

• デプロイ スクリプトの 2 番目の部分には、移行先サーバーで作成または変更されたオブジェクト ([既定の処理] オプション) のみを処理したり、移行先データベースを完全に処理したりするために必要なコマンドが含まれています。 デプロイ スクリプトに処理コマンドを含めないことを選択することもできます。

デプロイ スクリプト全体は、1 つのトランザクションまたは複数のトランザクションで実行できます。 スクリプトが複数のトランザクションで実行される場合、スクリプトの最初の部分は 1 つのトランザクションとして実行され、各オブジェクトは独自のトランザクションで処理されます。

配置スクリプト ファイル - デプロイ スクリプトの作成に使用される入力

プロジェクトをビルドすると、SQL Server Data Tools によってプロジェクトのファイルが生成されます。 SQL Server Data Tools は、これらのファイルをプロジェクトの出力フォルダーに配置します。 既定では、出力は \Bin フォルダーに格納されます。 次の表に、SQL Server Data Tools によって作成される XML ファイルを示します。

SQL Server Data Tools では、プロジェクト ファイルにパスワードが格納されることはありません。

入力ファイルの変更

入力ファイルの値または入力ファイルから取得した値を変更すると、 <プロジェクト名>.asdatabase ファイル全体 (または既存の SQL Server Analysis Services データベースからスクリプトを生成する場合はスクリプト ファイル全体) を編集することなく、展開先、構成設定、および配置オプションを変更できます。 個々のファイルを変更できるため、さまざまな目的で異なるデプロイ スクリプトを簡単に作成できます。

配置スクリプト ファイル - インストール 先の指定

展開ウィザードは、 <project name>.deploymenttargets ファイルからインストール 先の情報を読み取ります。 SQL Server Data Tools では、プロジェクトのビルド時にこのファイルが作成されます。 SQL Server Data Tools では、<>Properties Pages ダイアログ ボックスの [配置] ページで指定されたデータベースとサーバーを使用して、<プロジェクト名>.targets ファイルを作成します。

インストール 先の変更

場合によっては、[配置] ページで指定したプロジェクトとは異なるデータベースまたはインスタンスにプロジェクトを 配置 することが必要になる場合があります。 たとえば、配置前にテストのためにプロジェクトをサーバーに配置し、テストが完了した後に運用サーバーに配置することができます。 また、完了したテスト済みのプロジェクトを、ネットワーク負荷分散クラスター内の複数の運用サーバー、またはステージング サーバーと運用サーバーにデプロイすることもできます。

プロジェクトを別のデータベースまたはインスタンスに配置するには、次の手順で説明する方法のいずれかを使用して、入力ファイル内のインストール 先を変更します。

入力ファイルの生成後にインストール 先を変更するには

• SQL Server Analysis Services 配置ウィザードを対話形式で実行します。 [ インストール先 ] ページで、SQL Server Analysis Services インスタンスとデータベースの新しい変換先を指定します。

  -又は-

• コマンド プロンプトで SQL Server Analysis Services 配置ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。

  -又は-

• 任意のテキスト エディターを使用して、 <project name>.deploymenttargets ファイルを変更します。

デプロイ スクリプト ファイル - パーティションとロールの展開オプション

展開ウィザードは、 <project name>.deploymentoptions ファイルからパーティションとロールの展開オプションを読み取ります。 SQL Server Data Tools では、プロジェクトのビルド時にこのファイルが作成されます。 SQL Server Data Tools では、 <project name>.deploymentoptions ファイルが作成されるときに、現在のプロジェクトのパーティションとロールの展開オプションが使用されます。

パーティションと役割のデプロイ オプションの確認

< project name>.deploymentoptions ファイルの展開オプションには、次のものが含まれます。

パーティションのデプロイ オプション
< project name>.deploymentoptions ファイルは、コピー先データベース内の既存のパーティションを保持するか上書きするかを指定します (既定)。 既存のパーティションが保持されている場合は、新しいパーティションのみがデプロイされ、既存のすべてのメジャー グループのパーティションと集計デザインは変更されません。

パーティションが存在するメジャー グループが削除されると、パーティションは自動的に削除されます。

ロールの展開オプション
< project name>.deploymentoptions ファイルは、次のいずれかのロール展開オプションを指定します。

• 移行先データベースの既存のロールとロール メンバーは保持され、新しいロールとロール メンバーのみがデプロイされます。

• 移行先データベース内のすべての既存のロールとメンバーは、デプロイされるロールとメンバーに置き換えられます。

• 移行先データベースの既存のロールとロール メンバーは保持され、新しいロールはデプロイされません。

既存のロールとメンバーが保持されると、それらのロールに関連付けられているアクセス許可は none にリセットされます。 セキュリティ権限は、保護するオブジェクトに含まれ、関連付けられたセキュリティ ロールには含まれません。 Analysis Service 展開ウィザードを使用してこの動作を操作する方法の詳細については、Microsoft サポート技術情報の「役割とメンバーの保持」を参照してください。

パーティションとロールのデプロイ オプションの変更

< project name>.deploymentoptions ファイルに格納されているものとは異なるパーティションとロールのオプションを使用してプロジェクトを配置する必要がある場合があります。 たとえば、 <project name>.deploymentoptions ファイルに示されているように、既存のすべてのパーティション、ロール、およびメンバーを置き換えるのではなく、既存のパーティション、ロール、およびロール メンバーを保持することができます。

プロジェクト内のパーティションとロールの配置を変更するには、SQL Server Data Tools の [<プロジェクト名>プロパティ ページ] ダイアログ ボックスにこれらのオプションが表示されないため、プロジェクト内のパーティションとロールの設定を変更することはできません。 ロールとパーティションの展開オプションを変更する場合は、 <project name>.deploymentoptions ファイル自体でこの情報を変更する必要があります。 次の手順では、 <project name>.deploymentoptions ファイル内のパーティションとロールの展開オプションを変更する方法について説明します。

入力ファイルの生成後にパーティションまたはロールのデプロイを変更するには

• 展開ウィザードを対話形式で実行し、[ パーティションとロールの展開オプション] ページで、パーティションとロールの新しい展開オプションを指定します。

  -又は-

• コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。

  -又は-

• 任意のテキスト エディターで <project name>.deploymentoptions を開き、オプションを手動で変更します。 PartitionDeployment のオプションは、DeployPartitions、RetainPartitions です。 RoleDeployment のオプションは、DeployRolesAndMembers、DeployRolesRetainMembers、RetainRoles です。

配置スクリプト ファイル - ソリューションの配置構成設定

配置ウィザードは、展開スクリプトで使用するパーティションとロールの配置オプションを、 <project name>.configsettings ファイルから読み取ります。 多次元プロジェクトの場合、SQL Server Data Tools はプロジェクトのビルド時にこのファイルを作成します。 表形式プロジェクトの場合、バージョンによっては、.configsettings ファイルを生成するために、応答モードで配置ウィザードを実行することが必要な場合があります。 SQL Server Data Tools では、現在のプロジェクトの構成設定を使用して、 <project name>.configsettings ファイルが作成されます。

構成設定の確認

< project name>.configsettings ファイルに格納されている構成設定を次に示します。

• データ ソース接続文字列 - プロジェクトで指定された値に基づく各データ ソースの接続文字列です。 ユーザー ID とパスワードは、文字列の残りの部分がこのファイルに格納される前に、接続文字列から常に削除されます。 ただし、展開ウィザードが Analysis Services インスタンスに直接展開している場合は、適切なユーザー ID とパスワード情報をウィザード内に追加して、配置データベースの正常な処理を有効にすることができます。 この接続情報は、展開ウィザードによって保存されている場合、展開スクリプト自体には保存されません。

• 偽装アカウント - この設定では、SQL Server Analysis Services が各データ ソースでステートメントを実行するために使用するユーザー名を指定します。 偽装アカウントが指定されていない場合、SQL Server Analysis Services はログオン アカウントを使用してステートメントを実行します。 ログオン アカウントにデータ ソース内で直接アクセス許可が付与されている場合、SQL Server Analysis Services インスタンス内のすべてのデータベースのすべてのデータベース管理者は、ログオン アカウントを介してデータ ソースにアクセスできます。 ユーザー アカウントとパスワードが指定されている場合、偽装情報がこのファイルに格納される前に、この情報は常に削除されます。 ただし、展開ウィザードが Analysis Services インスタンスに直接展開している場合は、適切なユーザー ID とパスワード情報をウィザード内に追加して、配置データベースの正常な処理を有効にすることができます。 この偽装情報は、展開ウィザードによって保存されている場合、展開スクリプト自体には格納されません。

  注

  構造化プロバイダー データ ソース接続との互換性レベルが 1400 以上の表形式モデルの場合、ウィザードの [構成プロパティの指定] ページで [既存のオブジェクトの構成設定を保持 する] を選択すると、ターゲット サーバーの表形式モデル データベースに格納されているユーザー名とパスワードは保持されません。 管理者は、デプロイの完了後に SSMS を使用してユーザー名とパスワードを手動で設定する必要があります。

• キー エラー ログ ファイル - この設定では、データベース内のキューブ、メジャー グループ、パーティション、およびディメンションごとに、キー エラー ログ ファイルのファイル名とパスを指定します。

• [保存場所] - この設定では、データベース内のキューブ、メジャー グループ、パーティションごとに格納場所を指定します。 オブジェクトに値が指定されていない場合、展開ウィザードはオブジェクトの既定の場所を使用します。 たとえば、パーティションはメジャー グループの場所を使用し、メジャー グループはキューブの場所を使用し、キューブはサーバー インスタンス上のオブジェクトの既定の場所を使用します。 ストレージの場所には、ローカル パスまたは汎用名前付け規則 (UNC) パスを指定できます。

• レポート サーバー - この設定では、データベース内の各キューブで定義されている各レポート アクションのレポート サーバーとフォルダーの場所を指定します。

構成設定の変更

場合によっては、 <project name>.configsettings ファイルに格納されているものとは異なる構成設定を使用してプロジェクトを配置する必要があります。 たとえば、接続文字列を 1 つ以上のデータ ソースに変更したり、特定のパーティションまたはメジャー グループの保存場所を指定したりできます。

プロジェクト内のパーティションとロールの配置を変更するには、次の手順で説明するように、 <project name>.configsettings ファイル内でこの情報を変更する必要があります。 SQL Server Data Tools の [<プロジェクト名>プロパティ ページ] ダイアログ ボックスにこれらのオプションが表示されないため、プロジェクト内のパーティションとロールの設定を変更することはできません。

入力ファイルの生成後に構成設定を変更するには

• 展開ウィザードを対話形式で実行し 、[構成設定] ページで、展開するオブジェクトの構成設定を指定します。

  -又は-

• コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。

  -又は-

• 任意のテキスト エディターを使用して、 <project name>.configsettings ファイルを変更します。

デプロイ スクリプト ファイル - 処理オプション

配置ウィザードは、 <project name>.deploymentoptions ファイルから処理オプションを読み取ります。 SQL Server Data Tools では、プロジェクトのビルド時にこのファイルが作成されます。 SQL Server Data Tools では、>Properties Pages ダイアログ ボックスの [展開] ページで指定された処理オプションを使用して、<プロジェクト名>.deploymentoptions ファイルを作成します。

処理オプションの確認

< project name>.deploymentoptions ファイル内に格納される構成設定は次のとおりです。

• [処理方法] - この設定では、配置されたオブジェクトを展開後に処理するかどうか、および実行される処理の種類を制御します。 次の 3 つの処理オプションがあります。

  • 既定の処理 (既定値) は、データベース オブジェクトのプロセス状態を検出し、処理されていないオブジェクトまたは部分的に処理されたオブジェクトを完全に処理された状態に配信するために必要な処理を実行します。

  • 完全処理では、オブジェクトとそのオブジェクトに含まれるすべてのオブジェクトが処理されます。 既に処理されているオブジェクトに対してプロセスフルが実行されると、Analysis Services はオブジェクト内のすべてのデータを削除してから、オブジェクトを処理します。

  • None は、処理が実行されていないことを意味します。

• 書き戻しテーブルのオプション - プロジェクトで書き戻しが有効になっている場合、この設定によって書き戻しの処理方法が定義されます。 書き戻しテーブルには、次の 3 つのオプションがあります。

  • 既定では、書き戻しテーブルが存在する場合は使用されます。 書き戻しテーブルが存在しない場合は、新しい書き戻しテーブルが作成されます。

  • 書き戻しテーブルが既に存在する場合、デプロイは失敗します。 書き戻しテーブルが存在しない場合は、新しい書き戻しテーブルが作成されます。

  • 書き戻しテーブルが既に存在するかどうかに関係なく、新しい書き戻しテーブルが作成されます。 この場合、配置ウィザードは既存のテーブルを削除し、新しい書き戻しテーブルに置き換えます。

• トランザクション展開 - この設定では、メタデータの変更とプロセス コマンドの展開を 1 つのトランザクションで行うか、別のトランザクションで行うかを制御します。

  • このオプションが True (既定値) の 場合、SQL Server Analysis Services は、すべてのメタデータ変更とすべてのプロセス コマンドを 1 つのトランザクション内に展開します。

  • このオプションが False の場合、SQL Server Analysis Services はメタデータの変更を 1 つのトランザクションに展開し、各処理コマンドを独自のトランザクションに展開します。

処理オプションの変更

ただし、 <project name>.deploymentoptions ファイルに格納されているものとは異なる処理オプションを使用してプロジェクトを配置する必要がある場合があります。 たとえば、すべてのオブジェクトを完全に処理するか、既定の処理オプションを使用して処理するか、処理を行いません。 キューブまたはディメンションが書き込み可能な場合は、新規または既存の書き戻しテーブルを使用するかどうかを指定できます。

配置時に使用される処理オプションを変更するには、プロジェクトを編集して再構築するか、次の手順で説明する方法のいずれかを使用して入力ファイルの処理オプションを変更します。

入力ファイルの生成後に処理オプションを変更するには

• 展開ウィザードを対話形式で実行します。 [ 処理オプション] ページで、配置するプロジェクトの処理オプションを指定します。

  -又は-

• コマンド プロンプトで展開ウィザードを実行し、応答ファイル モードで実行するようにウィザードを設定します。

  -又は-

• 任意のテキスト エディターを使用して、 <project name>.deploymentoptions ファイルを変更します。

こちらも参照ください

XMLA を使用してモデル ソリューションをデプロイする
配置ユーティリティを使用してモデル ソリューションをデプロイする