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/