Visual Studio から表形式モデルをデプロイする

[アーティクル]
11/10/2023

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

Visual Studio からの表形式モデルプロジェクトのデプロイは簡単なプロセスですが、モデルが正しいサーバーインスタンスまたは Power BI ワークスペースにデプロイされ、適切な構成オプションを使用して確実にデプロイされるようにするには、特定の手順を実行する必要があります。

表形式モデルは、いくつかのデプロイ固有のプロパティで定義されます。デプロイすると、 [サーバー] プロパティで指定された Analysis Services インスタンスへの接続が確立されます。 Database プロパティで指定された名前の新しいモデルが、まだ存在しない場合は、そのインスタンスに作成されます。モデルプロジェクトの Model.bim ファイルからのメタデータは、配置サーバー上のモデルデータベース内のオブジェクトを構成するために使用されます。 [処理オプション]では、モデルメタデータのみを配置するだけであるか、model データベースを作成するかを指定できます。または、 [既定] または [完全] が指定されている場合は、データソースへの接続に使用した権限借用の資格情報がメモリ内でモデルワークスペースデータベースから配置済みの model データベースに渡されます。 Analysis Services により、配置済みのモデルにデータを取り込む処理が実行されます。デプロイと処理が完了すると、Power BI や Excel などのクライアントレポートアプリケーションによってモデルに接続できるようになります。

Visual Studio から Power BI Premium ワークスペースに表形式モデルプロジェクトをデプロイするには、最初のデプロイで処理を完了するための追加の手順がいくつかあります。詳細については、「 Visual Studio から Power BI にモデルプロジェクトをデプロイする」を参照してください。

展開のプロパティ

プロジェクトの配置オプションと配置サーバーのプロパティは、モデルをステージングまたは運用環境の Analysis Services 環境にデプロイする方法と場所を指定します。すべてのモデルプロジェクトに対して既定のプロパティ設定が定義されていますが、固有の配置要件に応じて、プロジェクトごとにそれらのプロパティ設定を変更できます。

配置オプション

プロパティ	既定の設定	説明
処理オプション	[Default]	オブジェクトへの変更をデプロイするときに必要な処理の種類を指定します。このプロパティには、次のオプションがあります。既定値 - この設定では、Analysis Services が必要な処理の種類を決定することを指定します。未処理のオブジェクトは処理され、必要に応じて、属性リレーションシップ、属性階層、ユーザー階層、および計算列が再計算されます。通常は、[完全処理] オプションを使用するよりも、配置時間が高速になります。 [処理しない ] - この設定では、メタデータのみをデプロイすることを指定します。配置後、配置済みのモデルに対して処理操作を実行してデータの更新および再計算を実行する必要がある場合があります。 Full - この設定では、メタデータがデプロイされ、プロセスの完全な操作が実行されることを指定します。これにより、配置済みのモデルには、メタデータおよびデータの最新の更新が含まれます。
トランザクション配置	False	デプロイがトランザクションであるかどうかを指定します。既定では、すべてのオブジェクトまたは変更されたオブジェクトの配置は、それらを配置した後の処理とトランザクション関係がありません。処理に失敗しても、配置は成功して持続できます。これを変更して、配置と処理を 1 つのトランザクションに組み込むこともできます。
ADAL キャッシュ	[Default]	Azure Analysis Servicesに接続するときに USEADALCache 接続文字列プロパティを使用することを指定します。

配置サーバー

プロパティ	既定の設定	説明
[サーバー]	localhost	モデルをデプロイするAzure Analysis Servicesサーバーリソース URL、Power BI ワークスペース接続 URL、またはSQL Server Analysis Servicesインスタンス名を指定します。
エディション	ワークスペースデータベースが配置されているインスタンスと同じエディション。	このプロパティでは、モデルを配置する Analysis Services サーバーのエディションを指定します。サーバーエディションにより、プロジェクトに組み込むことができるさまざまな機能が定義されます。既定では、エディションはローカル Analysis Services サーバーになり、統合ワークスペースを使用している場合は Visual Studio エディションになります。
[データベース]	<Projectname>	このプロパティでは、配置時にモデルオブジェクトがインスタンス化される Analysis Services データベースの名前を指定します。この名前は、レポートクライアントデータ接続や .bism データ接続ファイルにも指定されます。この名前は、モデルの作成中にいつでも変更できます。モデルを配置した後に名前を変更した場合、配置後に行った変更は既に配置されているモデルには反映されません。たとえば、 TestDB という名前のソリューションを開き、既定の model データベース名の Model という名前のソリューションを配置した後、ソリューションを変更して、model データベースの名前を Salesに変更すると、そのソリューションが配置された Analysis Services インスタンスには、Model という名前のデータベースと Sales という名前のデータベースが別々に表示されます。
モデル名	Model	このプロパティは、クライアントアプリケーションとツールに示すようにモデル名を指定します。

表形式モデルをデプロイする

ソリューションエクスプローラーでプロジェクト名を右クリックし、[配置] をクリックします。

[配置] ダイアログボックスが表示され、メタデータの配置の状態とモデルに含まれる各テーブルの処理が示されます ([処理オプション] プロパティが [処理しない] に設定されている場合を除きます)。

配置状態

[配置] ダイアログボックスでは、配置操作の進行状況を監視できます。配置操作を停止することもできます。

状態
配置操作が正常に行われたかどうかを示します。

詳細
配置されたメタデータ項目と各メタデータ項目の状態を一覧表示し、何か問題があればメッセージを表示します。

[展開の停止]
クリックすると、配置操作が停止されます。このオプションは、配置操作に時間がかかりすぎる場合や、エラーが多すぎる場合に有効です。

Power BI Premium ワークスペースへのデプロイ

初めてデプロイすると、model.bim のメタデータを使用して、セマンティックモデルがワークスペースに作成されます。デプロイ操作の一環として、モデルメタデータからワークスペースにモデルが作成された後、データソースからモデルにデータを読み込む処理 は失敗します。

処理が失敗する理由は、Azure または SQL Server 分析サーバーインスタンスに配置する場合 (データソースの資格情報が配置操作の一部として要求される) とは異なり、Premium ワークスペースに配置する場合は、データソースの資格情報を配置操作の一部として指定できないためです。代わりに、メタデータのデプロイが成功し、モデルが作成された後、データソースの資格情報がセマンティックモデル設定で Power BI サービスで指定されます。ワークスペースで、[セマンティックモデル>] [設定] [>データソースの資格情報] [資格情報の編集] の順に>クリックします。

重要

パブリックプレビュー中は、モデルプロジェクトでロールメンバーシップを指定できません。モデルプロジェクトを配置できない場合は、どのロールにもユーザーが指定されていないことを確認してください。モデルが正常にデプロイされたら、Power BI サービスのモデルロールのユーザーを指定します。

注意

DirectQuery モデルの場合、モデルに集計アイテム、計算列、または計算テーブルが含まれている場合は、デプロイ後にデータベースに対して プロセス再計算 を実行する必要があります。 SSMS からのモデルデータベースの処理の詳細については、「データベース、テーブル、またはパーティションの処理」を参照してください。

デプロイプロセスが完了したら、SSMS を使用してサーバーまたはワークスペースに接続し、新しいモデルデータベースオブジェクトが作成されたことを確認します。

こちらもご覧ください

表形式モデルソリューションのデプロイ
 既定のデータモデリングとデプロイプロパティを構成する
 データベース、テーブル、またはパーティションの処理

次の方法で共有