Power Query と Azure DevOps 関数を使用して接続する

Azure DevOps Services |Azure DevOps Server |Azure DevOps Server 2022

Azure DevOps 用 Data Connector には、クエリ作成者が使用できる Power Query M 関数が含まれています。 これらの関数は、認証などの Azure DevOps 固有の要件を処理できます。 この記事では、関数の引数と、それらを使用して Analytics に接続する方法について説明します。

VSTS。AccountContents 関数は、Power Query M 関数 Web.Contents に代わる関数です。 より高度なシナリオ (VSTS) を対象としています。AccountContents は、Analytics の URL からダウンロードしたコンテンツをバイナリ値として返します。 これを使用して 、AzureDevOps REST API を呼び出すことができます。

Important

VSTS.AccountContents

Analytics の URL からダウンロードした内容をバイナリ値として返す高度な関数。

VSTS.AccountContents関数には、Web.Contentsと同じ引数、オプション、戻り値の形式があります。 詳細については、「 Power Query (M) 数式リファレンス - Web.Contents」を参照してください。

Web.Contentsを使用して Analytics (REST API または OData) から作業追跡データに既にアクセスしている場合は、データ コネクタ認証を使用するVSTS.AccountContentsに置き換えることができます。 これらの要求が同じデータ ソースを参照していることを Power BI に通知します。 Power BI Service の単一のデータ ソース制約に違反することなく、データを結合できます。 ただし、 VSTS.AccountContent は Azure Boards からのデータのみをサポートしており、パイプラインやその他のサービスのクエリをサポートするために使用することはできません。

'VSTS。AccountContents' には、"OData.Contents" で使用できる引数とオプションのサブセットが用意されています。 具体的な制限事項については、次の表を参照してください。

VSTS.Contents の引数

Argument Description
url Azure DevOps サービス エンドポイントの 1 つへの URL。
options この関数の動作を制御するオプション レコード。

VSTS.Contents のオプションフィールド

フィールド Description
IsRetry この論理値を true に指定すると、データのフェッチ時にキャッシュ内の既存の応答が無視されます。
ManualStatusHandling この値をリストとして指定すると、応答にこれらの状態コードのいずれかが含まれる HTTP 要求に対する組み込み処理が禁止されます。
MaxSize クライアントが関心を持つテーブルの最大サイズを制御します。 要求がこの制限を超えた場合、サーバーはすぐに要求を失敗させることができます。 既定値は 0 で、サーバーにその既定値を使用するように指示します。
Query プログラムによって URL にクエリ パラメーターを追加します。
RelativePath 要求を行う前に、この値をテキストでベース URL に追加するように指定します。
Timeout 期間としてこの値を指定すると、HTTP 要求のタイムアウトが変更されます。 既定値は 600 秒です。
Version データ モデルのバージョン。 このオプションは、診断のプライマリです。

VSTS でサポートされているサブドメイン。AccountContents

現在、 VSTS.AccountContents() メソッドは、以下に示すサブドメインでのみ機能します。 リリース サービスなどの他のサービスはまだサポートされていません。

  • https://dev.azure.com/
  • https://analytics.dev.azure.com/
  • https://vsrm.dev.azure.com/

関連するコンテンツ

  • Last updated on