このクイック スタートでは、Azure Resource Graph Power BI コネクタを使用してクエリを実行する方法について説明します。 既定では、Power BI コネクタはテナント レベルでクエリを実行しますが、スコープをサブスクリプションまたは管理グループに変更できます。 Azure Resource Graph は既定で最大 1,000 レコードを返しますが、クエリ結果に 1,000 を超えるレコードがある場合、Power BI コネクタにはすべてのレコードを返すオプションの設定があります。
ヒント
プライベート プレビューに参加している場合は、 AzureResourceGraph.mez プレビュー ファイルを削除します。 ファイルが削除されない場合は、認定コネクタではなく Power Query によってカスタム コネクタが使用される可能性があります。
[前提条件]
- アクティブなサブスクリプションを持つ Azure アカウントがない場合は、開始する前に 無料アカウント を作成してください。
- 組織のテナント内の Power BI Desktop または Power BI サービス ワークスペース。
- Azureのロールベースアクセス制御の権限で、少なくとも読み取りロールがリソースに割り当てられていること。 ロールの割り当ての詳細については、 Azure portal を使用して Azure ロールを割り当てる方法に関するページを参照してください。
Power BI コネクタを使用して Azure Resource Graph を接続する
Power BI Desktop または Power BI サービスを使用してクエリを実行できます。 クエリを入力するときにコメントを使用しないでください。
クエリがない場合は、ストレージ アカウントに対してクエリを実行する次のサンプルを使用できます。
resources
| where type == 'microsoft.storage/storageaccounts'
Power BI Desktop がインストールされたら、クエリを実行できるように、Azure Resource Graph を Power BI コネクタに接続できます。
次の例では、既定の設定でクエリを実行します。
コンピューターで Power BI Desktop アプリを開き、表示されているダイアログ ボックスをすべて閉じます。
ホーム>オプションと設定>データソース設定を選択します。
[ホーム>データを取得>詳細>Azure>Azure Resource Graph] に移動し、[接続] を選択します。
![Azure Resource Graph コネクタを選択する Power BI Desktop の [データの取得] ダイアログ ボックスのスクリーンショット。](media/power-bi-connector-quickstart/power-bi-get-data.png)
[ Azure Resource Graph ] ダイアログ ボックスで、[クエリ] ボックスに クエリ を入力します。
![クエリを入力し、既定の設定を使用するための [Azure Resource Graph] ダイアログ ボックスのスクリーンショット。](media/power-bi-connector-quickstart/query-dialog-box.png)
[OK] を選択. メッセージが表示されたら、資格情報を入力し、[ 接続 ] を選択してクエリを実行します。
[データ の読み込み または 変換] を選択します。
- 読み込み により、クエリ結果が Power BI Desktop にインポートされます。
- [データの変換 ] では、クエリ結果と共に Power Query エディターが開きます。
![Azure Resource Graph コネクタを選択する Power BI サービスの [データの取得] ダイアログ ボックスのスクリーンショット。](media/power-bi-connector-quickstart/power-bi-service-get-data.png)
![Power BI サービスの [Azure Resource Graph] ダイアログ ボックスのスクリーンショット。クエリを入力し、既定の設定を使用します。](media/power-bi-connector-quickstart/power-bi-service-query-dialog-box.png)
省略可能な設定を使用する
オプションの値を選択して、クエリが実行される Azure サブスクリプションまたは管理グループを変更したり、1,000 を超えるレコードのクエリ結果を取得したりできます。
| Option | Description |
|---|---|
| Scope | サブスクリプションまたは管理グループを選択できます。 テナントは、選択されていない場合の既定のスコープです。 |
| サブスクリプション ID | サブスクリプション スコープを選択する場合は必須。 Azure サブスクリプション ID を指定します。 複数のサブスクリプションに対してクエリを実行するには、コンマ区切りリストを使用します。 |
| 管理グループ ID | 管理グループスコープを選択する場合は必須です。 Azure 管理グループ ID を指定します。 複数の管理グループに対してクエリを実行するには、コンマ区切りのリストを使用します。 |
| 詳細オプション | 1,000 を超えるレコードを取得するには、 $resultTruncated が FALSEに変更されます。 既定では、Azure Resource Graph は最大 1,000 個のレコードを返します。 |
たとえば、1,000 を超えるレコードを返すサブスクリプションに対してクエリを実行するには、次のようにします。
- スコープをサブスクリプションに設定します。
- サブスクリプション ID を入力します。
-
$resultTruncatedをFALSEに設定します。
![スコープ、サブスクリプション ID、$resultTruncatedのオプション設定を使用したクエリの Power BI サービスの [Azure Resource Graph] ダイアログ ボックスのスクリーンショット。](media/power-bi-connector-quickstart/power-bi-service-dialog-box-options.png)
リソースをクリーンアップする
完了したら、Power BI Desktop または Power Query ウィンドウを閉じて、クエリを保存または破棄します。
次のステップ
クエリ言語またはリソースの探索方法の詳細については、次の記事を参照してください。
- Power BI コネクタのトラブルシューティング ガイド。
- Azure Resource Graph クエリ言語について。
- Resource Graph を使用して Azure リソースを探索します。
- テーブルまたはカテゴリ別に一覧表示されるサンプル クエリ。