Power Query と Azure DevOps 関数を使用して接続する
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Azure DevOps 用 Data Connector には、クエリ作成者が使用できる Power Query M 関数が含まれています。 これらの関数は、認証などの Azure DevOps 固有の要件を処理できます。 この記事では、関数の引数と、それらを使用して Analytics に接続する方法について説明します。
VSTS。AccountContents 関数は、Power Query M 関数 Web.Contents に代わる関数です。 より高度なシナリオ (VSTS) を対象としています。AccountContents は、Analytics の URL からダウンロードした内容をバイナリ値として返します。 これを使用して 、AzureDevOps REST API を呼び出すことができます。
重要
- VSTS を使用します。AccountContents は 、Analytics で使用できないデータにアクセスする場合にのみ行われます。 Azure DevOps からデータを直接プルし、他の Azure DevOps ユーザーを保護するために、調整の影響を受けやすくなります。 「VSTS でサポートされているサブドメイン」を参照してください。AccountContents セクションは、この記事の後半で説明します。 その他の方法については、「 Power BI 統合の概要」を参照してください。
- Vsts。AccountContents では、Azure Boardsデータ (作業項目) のみがサポートされます。 データ コネクタでは、パイプラインなどの他のデータ型はサポートされていません。 現時点では、他のデータ型をサポートするようにコネクタを更新する予定はありません。
Vsts。AccountContents
Analytics の URL からダウンロードした内容をバイナリ値として返す高度な関数。
関数には VSTS.AccountContents 、 と同じ引数、オプション、および戻り値の形式があります Web.Contents。 詳細については、「Power Query (M) 数式リファレンス - Web.Contents」を参照してください。
既に を使用して Web.Contents Analytics (REST API または OData) から作業追跡データにアクセスしている場合は、 に置き換えて VSTS.AccountContents Data Connector 認証を使用できます。 これらの要求が同じデータ ソースを参照していることを Power BI に通知します。 Power BI Service では、単一のデータ ソース制約に違反することなく、データを結合できます。 ただし、 VSTS.AccountContent Azure Boardsからのデータのみがサポートされており、パイプラインやその他のサービスのクエリをサポートするために使用することはできません。
'VSTS。AccountContents' には、'OData.Contents' で使用できる引数とオプションのサブセットが用意されています。 具体的な制限事項については、次の表を参照してください。
VSTS の引数。内容
| 引数 | 説明 |
|---|---|
url |
Azure DevOps サービス エンドポイントの 1 つへの URL。 |
options |
この関数の動作を制御するオプション レコード。 |
VSTS のオプション フィールド。内容
| フィールド | 説明 |
|---|---|
IsRetry |
この論理値を true に指定すると、データのフェッチ時にキャッシュ内の既存の応答が無視されます。 |
ManualStatusHandling |
この値をリストとして指定すると、応答にこれらの状態コードのいずれかが含まれる HTTP 要求に対する組み込み処理が禁止されます。 |
MaxSize |
クライアントが関心を持つテーブルの最大サイズを制御します。 要求がこの制限を超えると、サーバーは要求をすぐに失敗させることができます。 既定値は 0 で、サーバー サーバーに既定値を使用するように指示します。 |
Query |
プログラムによってクエリ パラメーターを URL に追加します。 |
RelativePath |
この値をテキストとして指定すると、要求を行う前にベース URL に追加されます。 |
Timeout |
期間としてこの値を指定すると、HTTP 要求のタイムアウトが変更されます。 既定値は 600 秒です。 |
Version |
データ モデルのバージョン。 このオプションは、診断のプライマリです。 |
VSTS でサポートされているサブドメイン。AccountContents
現在、 メソッドは VSTS.AccountContents() 以下に示すサブドメインでのみ機能します。 Release サービスなどの他のサービスはまだサポートされていません。
https://dev.azure.com/https://analytics.dev.azure.com/https://vsrm.dev.azure.com/