Azure Portal での Power BI Embedded 容量の作成

[アーティクル]
08/02/2024

この記事では、Microsoft Azure で Power BI Embedded の容量を作成する方法について説明します。 Power BI Embedded では Power BI の各種機能がシンプルになりました。目を見張るようなビジュアル、レポート、ダッシュボードをアプリに簡単に追加できます。

前提条件

容量を作成するには、以下が必要です。

Microsoft Entra ID: サブスクリプションは、Microsoft Entra 組織のテナントに関連付けられている必要があります。また、"そのテナントのアカウントで Azure にサインインする必要があります"。 Microsoft 個人アカウントはサポートされていません。詳細については、「認証とユーザーのアクセス許可」を参照してください。
Power BI テナント: ご利用の Microsoft Entra テナントの少なくとも 1 つのアカウントを Power BI にサインアップしておく必要があります。そのアカウントから Power BI にサインインします。
Azure サブスクリプション: まだお持ちでない場合は、Azure 無料試用版にアクセスしてアカウントを作成してください。
リソースグループ: 既にあるリソースグループを使用するか、新しく作成します。

容量を作成する

注意

容量を作成または管理するには、共同作成者またはそれ以上の組み込みのロールが必要です。

Power BI Embedded 容量を作成する前に、少なくとも一度、Power BI にサインインしてください。

Azure Portal にサインインします。
[Azure サービス] で、[Power BI Embedded] を選択します。
[Power BI Embedded] 内で、[作成] を選択します。
必須情報を入力し、[確認および作成] を選択します。
- サブスクリプション - 容量を作成するサブスクリプション。
- リソースグループ - この新しい容量が含まれるリソースグループ。既存のリソースグループから選択するか、新しく作成します。詳細については、「Azure Resource Manager の概要」を参照してください。
- リソース名 - 容量のリソース名。容量名は、同じリージョン内で一意である必要があり、文字で始まり、3 から 63 の小文字または数字を使う必要があることに注意してください。
- 場所 - お使いのテナントの Power BI がホストされている場所。既定の場所はホーム領域ですが、Multi-Geo オプションを使用して場所を変更できます。
- サイズ - 必要な A SKU。詳細については、「SKU のメモリとコンピューティング能力」を参照してください。
- Power BI 容量管理者 - 容量の管理者。
  注意
  - 既定では、容量管理者は容量を作成するユーザーです。
  - 別のユーザーまたはサービスプリンシパルを容量管理者として選択できます。
  - 容量管理者は、容量がプロビジョニングされるテナントに属する必要があります。企業間 (B2B) ユーザーを容量管理者にすることはできません。

Azure Cloud Shell を使用する

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには:

オプション	例とリンク
コードブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードは Cloud Shell に自動的にコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell でこの記事のコードを実行するには:

Cloud Shell を開始します。
[コピー] ボタンを選択して、コードブロックをコードにコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードを実行します。

環境を準備する

Power BI Embedded 容量コマンドでは、バージョン 2.3.1 以降の Azure CLI を必要とします。 az --version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。インストールまたはアップグレードする必要には、「Azure CLI のインストール」をご覧ください。

サインインします。

CLI のローカルインストールを使用する場合は、az login コマンドを使用してサインインします。
```
az login
```
ターミナルに表示される手順に従って、認証プロセスを完了します。
Azure CLI 拡張機能をインストールします。

Azure CLI の拡張機能の参照を操作する場合は、最初に拡張機能をインストールする必要があります。 Azure CLI 拡張機能を使用すると、まだコア CLI の一部として出荷されていない実験用とプレリリースのコマンドにアクセスできます。更新とアンインストールを含む拡張機能の詳細については、「Azure CLI で拡張機能を使用する」を参照してください。

次のコマンドを実行し、Power BI Embedded 容量の拡張機能をインストールします。
```
az extension add --name powerbidedicated
```

Azure CLI で容量を作成する

az Power BI embedded-capacity create コマンドを使用し、容量を作成します。

az powerbi embedded-capacity create --location westeurope
                                    --name
                                    --resource-group
                                    --sku-name "A1"
                                    --sku-tier "PBIE_Azure"

Azure CLI で容量を削除する

Azure CLI を使用して容量を削除するには、Azure Power BI embedded-capacity delete コマンドを使用します。

az powerbi embedded-capacity delete --name
                                    --resource-group

Azure CLI で容量を管理する

Azure Power BI ですべての Power BI Embedded Azure CLI コマンドを表示できます。

Resource Manager テンプレートの使用

Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。このテンプレートでは、デプロイしようとしているものを、それを作成する一連のプログラミングコマンドを記述しなくても記述できる、宣言型の構文を使用しています。 Resource Manager テンプレートの開発に関する詳細を学ぶには、Resource Manager ドキュメントとテンプレートリファレンスを参照してください。

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

テンプレートを確認する

このクイックスタートで使用されるテンプレートは Azure クイックスタートテンプレートからのものです。

Azure リソースがテンプレート Microsoft.PowerBIDedicated/capacities Azで定義されたら、Power BI Embedded 容量を作成します。

このテンプレートを使用して、クラシック Power BI Embedded リソースを作成します。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "string",
            "metadata": {
                "description": "The capacity name, which is displayed in the Azure portal and the Power BI admin portal"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "The location where Power BI is hosted for your tenant"
            }
        },
        "sku": {
            "type": "string",
            "allowedValues": [
                "A1",
                "A2",
                "A3",
                "A4",
                "A5",
                "A6"
            ],
            "metadata": {
                "description": "The pricing tier, which determines the v-core count and memory size for the capacity"
            }
        },
        "admin": {
            "type": "string",
            "metadata": {
                "description": "A user within your Power BI tenant, who will serve as an admin for this capacity"
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.PowerBIDedicated/capacities",
            "apiVersion": "2021-01-01",
            "name": "[parameters('name')]",
            "location": "[parameters('location')]",
            "sku": {
                "name": "[parameters('sku')]"
            },
            "properties": {
                "administration": {
                    "members": [
                        "[parameters('admin')]"
                    ]
                }
            }
        }
    ]
}

テンプレートのデプロイ

Azure にサインインして、テンプレートを開くには、次のリンクを選択します。テンプレートによって Power BI Embedded 容量が作成されます。
必須情報を入力し、[確認および作成] を選択します。

$スクリーンショットには、Azure portal で新しい容量を作成するための [Create a Power BI Embedded capacity]$Power BI Embedded の容量を作成する$ ページの [基本] タブが示されています。$
- サブスクリプション - 容量を作成するサブスクリプション。
- リソースグループ - この新しい容量が含まれるリソースグループ。既存のリソースグループから選択するか、新しく作成します。詳細については、「Azure Resource Manager の概要」を参照してください。
- リージョン - 容量が属するリージョン。
- 名前 - 容量名。
- 場所 - お使いのテナントの Power BI がホストされている場所。既定の場所はホーム領域ですが、Multi-Geo オプションを使用して場所を変更できます。
- SKU - 必要な A SKU。詳細については、「SKU のメモリとコンピューティング能力」を参照してください。
- 管理者 - 容量の管理者。
  注意
  - 既定では、容量管理者は容量を作成するユーザーです。
  - 別のユーザーまたはサービスプリンシパルを容量管理者として選択できます。
  - 容量管理者は、容量がプロビジョニングされるテナントに属する必要があります。企業間 (B2B) ユーザーを容量管理者にすることはできません。

デプロイの検証

デプロイを検証するには、次の手順に従います。

Azure Portal にサインインします。
検索ボックスで Power BI Embedded を検索します。
Power BI Embedded 容量の一覧を見て、作成した新しい容量が一覧に記載されていることを確認します。

リソースをクリーンアップする

作成した容量を削除するには、次の手順を実行します。

Azure Portal にサインインします。
検索ボックスで Power BI Embedded を検索します。
作成した容量のコンテキストメニューを開き、[削除] をクリックします。
確認ページで、容量の名前を入力し、[削除] を選択します。

考慮事項と制限事項

サブスクリプションは、Microsoft Entra 組織アカウントに関連付けられている必要があります。 Microsoft 個人アカウントはサポートされていません

他にわからないことがある場合は、 Power BI コミュニティで質問してみてください。

次の方法で共有

Azure Portal での Power BI Embedded 容量の作成

前提条件

容量を作成する

Azure Cloud Shell を使用する

環境を準備する

Azure CLI で容量を作成する

Azure CLI で容量を削除する

Azure CLI で容量を管理する

Resource Manager テンプレートの使用

テンプレートを確認する

テンプレートのデプロイ

デプロイの検証

リソースをクリーンアップする

考慮事項と制限事項

フィードバック

その他のリソース

次の方法で共有

Azure Portal での Power BI Embedded 容量の作成

前提条件

容量を作成する

考慮事項と制限事項

関連するコンテンツ

フィードバック

その他のリソース