フローで行のリストを使用する

行の一覧 アクションを使用して、構造化クエリで Microsoft Dataverse から一度に複数の行を取得します。

行の一覧を取得する

次の手順に従って、行を一覧表示 アクションをフローに追加して、Dataverse の アカウント テーブルから最大 5000 アカウントを返します。

Power Automate では、新しいデザイナーまたは従来のデザイナーのいずれかを使用して、クラウドフローを構成できます。手順はどちらのデザイナーでも似ています。事例付きの詳細は、新しいデザイナーとクラシックなデザイナーの違いを見分けるをご参照ください。

新しいデザイナー
クラシックデザイナー

アクションペインで、プラス記号 (+) >アクションの追加 を選択します。
アクションの追加 画面で、検索フィールドに 行の一覧表示 と入力します。
Microsoft Dataverse で、リスト行 (プレビュー) を選択します。
左側の パラメーター タブで、テーブル名 ドロップダウンメニューから アカウント を選択します。
(<<) を選択して画面を閉じます。

5,000 行を超える要求を行うには、ページネーションをオンにします

クエリから 5000 行を超える行を自動的に取得するには、設定から ページ付け 機能をオンにします。

ページネーションが設定されていて、行数が構成されたしきい値のその数を超える場合、応答には次の行セットを要求する @odata.nextLink パラメーターは含まれません。次の行セットの要求に使用できる @odata.nextLink パラメーターが応答に含まれるように、ページネーションをオフにします。使用方法については、スキップトークンをご覧ください。

一般的なサービスを保証するために、コンテンツスループットの制限とメッセージサイズの制限が適用されます。

新しいデザイナー
クラシックデザイナー

行のリスト化 カードをを選択します。
左側のペインで、設定タブ >ネットワーキング を選択します。
まだオンになっていない場合は、ページネーション のスライダーをオンにします。
しきい値で、要求された行の最大数を入力します。構成可能な最大しきい値は 100,000 です。

内部的には、この数値は規定のページサイズの増分で四捨五入されます。たとえば、ページサイズが 5,000 の場合、7,000 と入力すると、返される行数は 10,000 になります。

詳細オプション

行を一覧にするアクションの詳細オプションを使用すると、クエリの結果を並べ替え、フィルタリング、配置、拡張できます。

新しいデザイナー
クラシックデザイナー

アクション構成ペインでオプションを設定できます。

オプションにアクセスするには、行のリスト化 カードを選択します。
パラメーター タブで、新しいパラメーターの追加 ドロップダウンメニューから詳細オプションを選択します。

完全なメタデータを返す

この設定は、テーブルからすべての列を読み込むか、パフォーマンスを向上させるために、重要な列のみを読み込むかを制御します。設定しない場合でも、フローで動的コンテンツまたは必要な式が使用されている場合は、完全なメタデータが自動的に返されます。

列の選択

取引先企業テーブルの "name,createdon,preferredcontactmethodcode,emailaddress1,telephone1" のように、返す列のリストをカンマで区切って入力します。

行のフィルター

OData 形式のフィルター式を定義して、Dataverse が返す行のセットを絞り込みます。例: 「createdon ge 2021-01-01T00:00:00-00:00」では、2021 年またはそれ以降の createdon を含む行を返します。

行をフィルターして、フィルタークエリ 式を作成する方法について説明します。

&、#、+ などの特定の文字は、URL エンコードされた同等のものに置き換える必要があります。詳細: URL エンコード特殊文字

重要

API を直接使用する場合にのみ適用されるため、フィルター式に文字列 $filter= を含めることはできません。

並べ替え順

「name desc」など、項目が返される順序を定義する OData スタイルの式を定義するために使用します。 asc または desc 接尾辞を使用して、それぞれ昇順または降順を示します。既定の順序は昇順です。

クエリの展開

Dataverse が関連テーブルから返すデータを定義する OData 形式の式を指定するために使用します。たとえば、primarycontactid($select=contactid,fullname) はアカウントの primarycontactid を使用して、レスポンス内の contactid という ID を持つ関連コンタクトから fullname カラムを取得します。

拡張クエリで使用できるナビゲーションプロパティには、次の 2 種類があります。

単一値 ナビゲーションプロパティは、多対一のリレーションシップをサポートし、別のテーブルへの参照を設定できる検索列に対応します。
コレクション値 ナビゲーションプロパティは、一対多または多対多のリレーションシップに対応します。

ナビゲーションプロパティ名のみを含める場合、関連する行のすべてのプロパティが表示されます。詳細については、OData を使用してテーブルを結合するを参照してください。

フローステップで使用するには、展開クエリ フィールドに次の Odata 式を入力します: primarycontactid(contactid,fullname)。各 取引先企業 の primarycontactid の contactid 列と fullname 列を取得する方法を示しています。

行数

Dataverse が返す行数を指定します。これは、10 行を要求する方法を示す例です。

Fetch Xml クエリ

FetchXML クエリで 行の一覧表示 アクションを使用する場合、集計クエリは現在サポートされていません。ただし、個別の演算子はサポートされています。

新しいデザイナー
クラシックデザイナー

Dataverse-style FetchXML クエリを使用することで、カスタムクエリをさらに柔軟に構築できます。これらのクエリは、複数の関連テーブルがあるテーブルを操作する場合、またはページ割り付けを処理する場合に役立ちます。次のスクリーンショットは、FetchXML の使用方法を示しています。

重要

ページネーションでは、FetchXml クエリはサポートされていません。 5,000 行を超える行を要求するには、FetchXml クエリを使用して直接ページングを管理する必要があります。

アカウントテーブルの FetchXML クエリの例:

<fetch count="10">
   <entity name="account">
      <attribute name="name" />
      <attribute name="preferredcontactmethodcode" />
      <attribute name="emailaddress1" />
      <attribute name="telephone1" />
         <link-entity name="contact" to="primarycontactid" from="contactid">
               <attribute name="fullname" />
      </link-entity>
      <filter> 
         <condition attribute="createdon" operator="ge" value="2021-01-01T00:00:00-00:00" />
      </filter>
      <order attribute="name" descending="true" />
   </entity>
</fetch>

distinct 演算子は現在、行の一覧アクションからの FetchXML クエリで直接サポートされていないため、union 関数を使用して重複行を削除できます。たとえば、Select アクションを使用して、行の一覧接続の応答を必要な特定の配列形式に変換し、式 union(body('Select'),body('Select')) で変数を作成して、個別の行を持つ配列を取得できます。

スキップトークン

Power Automate では、一般的なサービス保証を確保するために、コンテンツスループット制限やメッセージのサイズ制限を適用しているため、既定で返されるテーブル行数の制限ではなく、ページ割り付け を使用してより少ない数の行を一括して返すことが有効な場合があります。

ページネーションを使用しない場合、既定では 5,000 行のページ制限が適用されます。

これを使用するには、ループを実装して JSON 応答の @odata.nextLink 値を解析し、スキップトークン を抽出して、必要な行数が一覧されるまで別の要求を送信します。

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0  
Content-Length: 402  
Preference-Applied: odata.maxpagesize=3  
  
{  
   "@odata.context":"[Organization URI]/api/data/v9.1/$metadata#accounts(name)",
   "value":[  
      {  
         "@odata.etag":"W/\"437194\"",
         "name":"Fourth Coffee (sample)",
         "accountid":"7d51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"437195\"",
         "name":"Litware, Inc. (sample)",
         "accountid":"7f51925c-cde2-e411-80db-00155d2a68cb"
      },
      {  
         "@odata.etag":"W/\"468026\"",
         "name":"Adventure Works (sample)",
         "accountid":"8151925c-cde2-e411-80db-00155d2a68cb"
      }
   ],
   "@odata.nextLink":"[Organization URI]/api/data/v9.1/accounts?$select=name&$skiptoken=%3Ccookie%20pagenumber=%222%22%20pagingcookie=%22%253ccookie%2520page%253d%25221%2522%253e%253caccountid%2520last%253d%2522%257b8151925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520first%253d%2522%257b7D51925C-CDE2-E411-80DB-00155D2A68CB%257d%2522%2520%252f%253e%253c%252fcookie%253e%22%20/%3E"
}

パーティション ID

エラスティックテーブルのデータを取得する際に partitionId を指定するオプション。詳細については、エラスティックテーブルのパーティション分割と水平スケーリングを参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-01