サービスプリンシパルによる自動化

[アーティクル]
03/09/2023

サービスプリンシパルは、リソースおよびサービスレベルの無人操作を実行する目的でテナント内で作成する Microsoft Entra アプリケーションリソースです。アプリケーション ID とパスワードまたは証明書が与えられた、独自のユーザー ID です。サービスプリンシパルには、割り当てられたロールとアクセス許可によって定義されるタスクを実行するために必要な権限のみが与えられます。

Analysis Services では、サービスプリンシパルは Azure Automation、PowerShell 無人モード、カスタムクライアントアプリケーション、Web アプリと共に使用し、共通タスクを自動化します。たとえば、サーバーのプロビジョニング、モデルのデプロイ、データ更新、拡大縮小、一時停止/再開をすべて、サービスプリンシパルを利用することで自動化できます。アクセス許可は、通常の Microsoft Entra UPN アカウントとほぼ同じように、ロールメンバーシップを介してサービスプリンシパルに割り当てられます。

Analysis Services では、サービスプリンシパルを使用してマネージド ID によって実行される操作は "サポートされていません"。詳細については、Azure リソースのマネージド ID に関するページと Microsoft Entra 認証をサポートする Azure サービスに関するページを参照してください。

サービスプリンシパルの作成

サービスプリンシパルは Azure Portal で作成するか、PowerShell を利用して作成できます。詳細については、以下をご覧ください。

サービスプリンシパルを作成する - Azure Portal
サービスプリンシパルを作成する - PowerShell

Azure Automation に資格情報と証明書資産を保存する

Runbook 操作のために、サービスプリンシパルの資格情報と証明書を Azure Automation に安全に格納できます。詳細については、以下をご覧ください。

Azure Automation の資格情報資産
 Azure Automation の証明書資産

サービスプリンシパルをサーバー管理者ロールに追加する

Analysis Services サーバー管理操作のためにサービスプリンシパルを使用するには、最初にサービスプリンシパルをサーバー管理者ロールに追加する必要があります。サービスプリンシパルは、サーバー管理者ロールに "直接" 追加する必要があります。サービスプリンシパルをセキュリティグループに追加してから、そのセキュリティグループをサーバー管理者ロールに追加することはサポートされていません。詳細については、「サーバー管理者ロールへのサービスプリンシパルの追加」を参照してください。

接続文字列のサービスプリンシパル

サービスプリンシパル appID とパスワードまたは証明書は、UPN とほぼ同じように接続文字列で使用できます。

PowerShell

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を開始するには、Azure PowerShell のインストールに関する記事を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

Az.AnalysisServices モジュールの使用

Az.AnalysisServices モジュールによるリソース管理操作でサービスプリンシパルを使用するときは、Connect-AzAccount コマンドレットを使用します。

次の例では、appID とパスワードを使用してコントロールプレーンの操作を実行し、読み取り専用レプリカおよびスケールアップ/アウトに対する同期を行っています。

Param (
        [Parameter(Mandatory=$true)] [String] $AppId,
        [Parameter(Mandatory=$true)] [String] $PlainPWord,
        [Parameter(Mandatory=$true)] [String] $TenantId
       )
$PWord = ConvertTo-SecureString -String $PlainPWord -AsPlainText -Force
$Credential = New-Object -TypeName "System.Management.Automation.PSCredential" -ArgumentList $AppId, $PWord

# Connect using Az module
Connect-AzAccount -Credential $Credential -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx"

# Synchronize a database for query scale out
Sync-AzAnalysisServicesInstance -Instance "asazure://westus.asazure.windows.net/testsvr" -Database "testdb"

# Scale up the server to an S1, set 2 read-only replicas, and remove the primary from the query pool. The new replicas will hydrate from the synchronized data.
Set-AzAnalysisServicesServer -Name "testsvr" -ResourceGroupName "testRG" -Sku "S1" -ReadonlyReplicaCount 2 -DefaultConnectionMode Readonly

SQLServer モジュールの使用

次の例では、appID とパスワードを使用し、モデルデータベース更新操作を実行します。

Param (
        [Parameter(Mandatory=$true)] [String] $AppId,
        [Parameter(Mandatory=$true)] [String] $PlainPWord,
        [Parameter(Mandatory=$true)] [String] $TenantId
       )
$PWord = ConvertTo-SecureString -String $PlainPWord -AsPlainText -Force

$Credential = New-Object -TypeName "System.Management.Automation.PSCredential" -ArgumentList $AppId, $PWord

Invoke-ProcessTable -Server "asazure://westcentralus.asazure.windows.net/myserver" -TableName "MyTable" -Database "MyDb" -RefreshType "Full" -ServicePrincipal -ApplicationId $AppId -TenantId $TenantId -Credential $Credential

AMO と ADOMD

クライアントアプリケーションや Web アプリと接続するとき、AMO と ADOMD のクライアントライブラリバージョン 15.0.2 以降の、NuGet からインストールできるパッケージでは、接続文字列にサービスプリンシパルを指定できます。構文 app:AppID とパスワードまたは cert:thumbprint を利用します。

次の例では、appID と password を使用し、モデルデータベース更新操作を実行します。

string appId = "xxx";
string authKey = "yyy";
string connString = $"Provider=MSOLAP;Data Source=asazure://westus.asazure.windows.net/<servername>;User ID=app:{appId};Password={authKey};";
Server server = new Server();
server.Connect(connString);
Database db = server.Databases.FindByName("adventureworks");
Table tbl = db.Model.Tables.Find("DimDate");
tbl.RequestRefresh(RefreshType.Full);
db.Model.SaveChanges();

次のステップ

Azure PowerShell を使用してサインインする
 Logic Apps を使用した更新
 Azure Automation を使用した更新
 サーバー管理者ロールへのサービスプリンシパルの追加
 サービスプリンシパルを使用した Power BI Premium ワークスペースとデータセットのタスクの自動化

サービス プリンシパルによる自動化

サービス プリンシパルの作成