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

  • [アーティクル]

適用対象:SQL Server Analysis Services Azure Analysis Services Power BI Premium

Analysis Services 配置ウィザードでは、Analysis Services プロジェクトから生成された JSON 出力ファイルを入力ファイルとして使用します。 これらの入力ファイルは、Analysis Services プロジェクトの配置をカスタマイズするために簡単に変更できます。 生成された配置スクリプトは直ちに実行することも、今後の配置のために保存することもできます。

配置ウィザード/ユーティリティは、 SQL Server Management Studio (SSMS) と共にインストールされます。 最新バージョンを使用していることを確認してください。 コマンドプロンプトからを実行している場合、既定では、展開ウィザードの最新バージョンが C:\Program files (x86) \ Microsoft SQL Server Management Studio 18 \ common7\ide にインストールされます。

ここで説明するように、ウィザードを使用してをデプロイできます。 配置を自動化したり、同期機能を使用したりすることもできます。 配置するデータベースが大きい場合は、配置先のシステムでパーティションを使用することを検討してください。 表形式オブジェクトモデル (TOM)、表形式モデル Scriting 言語 (TMSL)、および分析管理オブジェクト (AMO) を使用して、パーティションの作成と作成を自動化できます。

重要

出力ファイルと配置スクリプトのどちらにも、データソースの接続文字列または権限借用の目的で指定されたユーザー id またはパスワードは含まれません。 このシナリオの処理ではユーザー ID およびパスワードが必要であるため、この情報を手動で追加します。 配置の際に処理を行わない場合は、この接続および権限借用のための情報を必要に応じて配置後に追加できます。 配置の際に処理を行う場合は、この情報をウィザードで入力するか、保存した配置スクリプトに追加することができます。

配置ウィザードを実行する

配置ウィザードを実行するには、次の方法を使用します。

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

  • コマンドプロンプトから-コマンドプロンプトで実行すると、ウィザードの実行に使用するスイッチに基づいて配置スクリプトが生成されます。 ウィザードでは、ユーザーの入力を求めてその入力に基づいて入力ファイルを変更するか、入力ファイルをそのまま使用して自動的に配置を実行するか、後で使用可能な配置スクリプトを作成します。

対話形式で実行

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

注意

配置ウィザードで入力値を変更する場合は、コマンドプロンプトでウィザードを実行し、ウィザードを応答ファイルモードで実行するように設定します。

入力値を確認し、必要に応じて変更を行うと、ウィザードによって配置スクリプトが生成されます。 この配置スクリプトは配置先サーバーで直ちに実行することも、後で使用するために保存することもできます。

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

  • [ スタート] をクリックし、「 Analysis Services Deployment Wizard」と入力します。

    \- または -

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

    注意

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

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

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

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

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

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

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

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

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

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

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

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

  2. 「 Microsoft.AnalysisServices.Deployment.exe 」の後に、ウィザードを実行するモードに対応するスイッチを入力します。

配置スクリプトについて理解する

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

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

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

配置スクリプト全体は、単一のトランザクションまたは複数のトランザクションで実行できます。 スクリプトを複数のトランザクションで実行する場合は、スクリプトの最初の部分が単一のトランザクションとして実行され、各オブジェクトはそれぞれのトランザクションで処理されます。

重要

Analysis Services 配置ウィザードでは、オブジェクトが1つの Analysis Services データベースにのみ配置されます。 サーバー レベルのオブジェクトまたはデータは配置しません。

デプロイ スクリプト ファイル - デプロイ スクリプトを作成するために使用される入力

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

ファイル 説明
<プロジェクト名> 。backup-asdatabase 多次元または1100/1103 の表形式モデルプロジェクト用の XMLA ファイル、または表形式1200およびそれ以降のモデルプロジェクト用の JSON ファイル。 プロジェクト内のすべての Analysis Services オブジェクトの宣言定義を格納します。
<プロジェクト名> 。deploymenttargets Analysis Services オブジェクトが作成される Analysis Services インスタンスおよびデータベースの名前を格納します。
<プロジェクト名> 。configsettings データ ソース接続情報やオブジェクト格納場所など、環境に固有の設定が含まれています。 このファイルの設定は、 <プロジェクト名> . asdatabase ファイルの設定をオーバーライドします。
<プロジェクト名> 。deploymentoptions 配置がトランザクションであるかどうかや、配置したオブジェクトを配置後に処理するかどうかなどの配置オプションが含まれています。

SQL Server Data Tools は、プロジェクトファイルにパスワードを格納しません。

入力ファイルの変更

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

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

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

インストール先の変更

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

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

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

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

    \- または -

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

    \- または -

  • 任意のテキストエディターを使用して、プロジェクト名> の < deploymenttargets ファイルを変更します。

配置スクリプト ファイル - パーティションおよびロールの配置オプション

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

パーティションおよびロールの配置オプションの確認

プロジェクト名> . deploymentoptions ファイルの配置オプション < は次のとおりです。

パーティション配置オプション
Deploymentoptions ファイルは、 < 転送先データベースの既存のパーティションを保持するか上書きするか (既定値) を指定します。> 既存のパーティションを保持する場合、新しいパーティションのみが配置され、既存のすべてのメジャー グループのパーティションおよび集計デザインはそのまま残されます。

パーティションが含まれているメジャー グループを削除すると、パーティションも自動的に削除されます。

ロール配置オプション
プロジェクト> deploymentoptions ファイルで < は、次のいずれかのロール配置オプションを指定します。

  • 配置先データベースの既存のロールおよびロール メンバーは保持され、新しいロールおよびロール メンバーのみが配置されます。

  • 配置先データベースの既存のすべてのロールおよびメンバーは、配置するロールおよびメンバーに置き換えられます。

  • 配置先データベースの既存のロールおよびロール メンバーは保持され、新しいロールは配置されません。

既存のロールおよびメンバーが保持されている場合、それらのロールに関連付けられている権限は [なし] にリセットされます。 セキュリティ権限は、オブジェクトが関連付けられているセキュリティ ロールではなく、オブジェクト自体に含まれています。 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 とパスワードを入力して、配置するデータベースを正常に処理することができます。 配置ウィザードで配置スクリプトを保存する場合、この接続情報は配置スクリプト内に保存されません。

  • [権限借用アカウント]-この設定では、各データソースでステートメントを実行するために Analysis Services 使用するユーザー名を指定します。 権限借用アカウントが指定されていない場合、Analysis Services はそのログオンアカウントを使用してステートメントを実行します。 ログオンアカウントにデータソース内で権限が直接付与されている場合、Analysis Services インスタンス内のすべてのデータベースのすべてのデータベース管理者は、ログオンアカウントを使用してデータソースにアクセスできます。 ユーザー アカウントとパスワードが指定された場合、このファイルに権限借用情報が保存される前に常にこの情報は削除されます。 ただし、配置ウィザードで Analysis Services インスタンスに直接配置を行う場合は、ウィザードで適切なユーザー ID とパスワードを入力して、配置するデータベースを正常に処理することができます。 配置ウィザードで配置スクリプトを保存する場合、この権限借用情報は配置スクリプト内に保存されません。

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

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

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

構成設定の変更

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

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

注意

構成設定は、すべてのオブジェクトに適用することも、新たに作成したオブジェクトのみに適用することもできます。 以前に配置した Analysis Services データベースに追加のオブジェクトを配置し、既存のオブジェクトを上書きしない場合にのみ、新しく作成されたオブジェクトに構成設定を適用します。 構成設定をすべてのオブジェクトに適用するか、新しく作成したものにのみ適用するかを指定するには、プロジェクト名> deploymentoptions ファイルで < このオプションを設定します。

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

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

    \- または -

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

    \- または -

  • 任意のテキストエディターを使用して、プロジェクト名> の < configsettings ファイルを変更します。

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

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

処理オプションの確認

プロジェクト名> deploymentoptions ファイル内 < に格納されている構成設定は次のとおりです。

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

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

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

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

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

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

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

    • 書き戻しテーブルが既に存在するかどうかにかかわらず、新しい書き戻しテーブルが作成されます。 この場合、配置ウィザードによって既存のテーブルが削除され、新しい書き戻しテーブルに置き換えられます。

  • トランザクション配置 -この設定は、1つのトランザクションで、または別のトランザクションで、メタデータの変更および処理コマンドの配置を実行するかどうかを制御します。

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

    • このオプションが Falseの場合、Analysis Services はメタデータの変更を1つのトランザクションに配置し、それぞれの処理コマンドをそれぞれのトランザクションに配置します。

処理オプションの変更

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

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

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

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

    \- または -

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

    \- または -

  • 任意のテキストエディターを使用して、プロジェクト名> の < deploymentoptions ファイルを変更します。

こちらもご覧ください

XMLA を使用したモデル ソリューションの配置
配置ユーティリティを使用したモデルソリューションの配置