플로우에서 행 목록 사용

행 나열 작업을 사용하여 구조화된 쿼리를 통해 Microsoft Dataverse에서 한 번에 여러 행을 검색합니다.

행 목록 가져오기

다음 단계에 따라 흐름에 행 나열 작업을 추가하여 Dataverse의 계정 테이블에서 최대 5000개의 계정을 반환합니다.

Power Automate에서는 새 디자이너 또는 클래식 디자이너를 사용하여 클라우드 흐름을 구성할 수 있습니다. 두 디자이너 모두에서 단계는 비슷합니다. 새 디자이너와 클래식 디자이너의 차이점 파악에서 자세히 알아보세요(예시 포함).

새 디자이너
클래식 디자이너

더하기 기호(+) >작업 추가를 선택합니다.
작업 추가 화면에서 검색 필드에 목록 행을 입력합니다.
Microsoft Dataverse에서 행 나열(프리뷰)을 선택합니다.
왼쪽에 있는 매개 변수 탭의 테이블 이름 드롭다운 메뉴에서 계정을 선택합니다.
선택하여 화면을 닫습니다(<<).

페이지 매김을 켜서 5000개 이상의 행을 요청합니다.

쿼리에서 자동으로 5,000개 이상의 행을 가져오려면 설정에서 페이지 매김 기능을 켭니다.

페이지 매김을 설정하고 행 수가 구성한 임계값을 초과하면 응답에 다음 행 집합을 요청하는 매개 변수가 포함되지 @odata.nextLink 않습니다. 응답에 다음 행 집합을 요청하는 데 사용할 수 있는 @odata.nextLink 매개 변수가 포함되도록 페이지 매김을 해제합니다. 사용 방법을 알아보려면 토큰 건너뛰기로 이동하세요.

일반적인 서비스 보장을 위해 콘텐츠 처리량 제한 및 메시지 크기 제한을 적용합니다.

새 디자이너
클래식 디자이너

행 목록 표시 카드를 선택합니다.
왼쪽 창에서 설정 탭 >네트워킹을 선택합니다.
아직 켜져 있지 않다면 페이지 매김 슬라이더를 켜짐 위치로 이동하세요.
임계값에 요청된 최대 행 수를 입력합니다. 구성 가능한 최대 임계값은 100,000입니다.

내부적으로 이 숫자는 기본 페이지 크기 단위로 반올림됩니다. 예를 들어 해당 페이지 크기가 5,000이고 7,000을 입력하면 반환되는 행의 수는 10,000입니다.

고급 옵션

행 나열 작업에 대한 고급 옵션을 사용하면 쿼리 결과를 정렬, 필터링, 정렬 및 확장할 수 있습니다.

새 디자이너
클래식 디자이너

작업 구성 창에서 옵션을 설정합니다.

옵션을 보려면 행 나열 카드를 선택하세요.
[매개 변수] 탭의 [고급 매개 변수] 드롭다운 메뉴에서 고급 옵션을 선택합니다.

전체 메타데이터 반환

이 설정은 성능 향상을 위해 테이블에서 모든 열을 로드할지 아니면 필수 열만 로드할지를 제어합니다. 설정하지 않으면 흐름에서 필요한 동적 콘텐츠 또는 식을 사용하는 경우 작업이 자동으로 전체 메타데이터를 반환합니다.

열 선택

Account 테이블의 경우 name,createdon,preferredcontactmethodcode,emailaddress1,telephone1와 같이 반환할 열 목록을 쉼표로 구분하여 입력합니다.

행 필터링

이 필드를 사용하여 OData 스타일 필터 식을 정의하여 Dataverse에서 반환하는 행 집합의 범위를 좁힐 수 있습니다(예: createdon ge 2021-01-01T00:00:00-00:00createdon 이 2021년보다 크거나 같은 행의 경우).

행을 필터링하여 Filter Query 식을 구성하는 방법을 알아보세요.

특정 문자(예: &, #및 +)를 해당 URL로 인코딩된 해당 문자로 바꿉니다. 자세한 내용은 URL 인코딩 특수 문자를 참조하세요.

중요

필터 식은 이 문자열 $filter=을 포함할 수 없습니다. 이는 API를 직접 사용할 때만 적용되기 때문입니다.

정렬 기준

이 필드를 사용하여 항목이 반환되는 순서(예: name desc.)를 정의하는 OData 스타일 식을 정의합니다. asc 또는 desc 접미사를 사용하여 각각 오름차순 또는 내림차순을 나타냅니다. 기본 순서는 오름차순입니다.

쿼리 확장

이 필드를 사용하여 Dataverse가 관련 테이블에서 반환하는 데이터를 정의하는 OData 스타일 식을 지정합니다. 예를 들어 primarycontactid($select=contactid,fullname) 계정의 primarycontactid를 사용하여 응답의 ID contactid와 관련된 연락처에서 전체 이름 열을 검색합니다.

다음에서 사용할 수있는 두 가지 유형의 탐색 속성이 있습니다. 쿼리 확장:

단일 값 탐색 속성은 다대일 관계를 지원하고 다른 테이블에 대한 참조를 설정할 수 있는 조회 열에 해당합니다.
컬렉션 값을 갖는 탐색 속성은 일대다 또는 다대다 관계에 해당합니다.

탐색 속성의 이름만 포함하는 경우 관련 행에 대한 모든 속성을 받게 됩니다. OData를 사용하여 테이블 조인에 대해 자세히 알아보세요.

흐름 단계에서 사용하려면 쿼리 확장 필드에 다음 OData 식을 입력하세요: primarycontactid(contactid,fullname). 이는 각 계정의 primarycontactid에 대한 contactid 및 fullname 열을 가져오는 방법을 보여줍니다.

행 수

행 개수 설정을 사용하여 Dataverse에서 반환할 행 수를 지정합니다.

XML 쿼리 가져오기

현재 FetchXML 쿼리에서 행 나열 작업을 사용할 때는 집계 쿼리를 사용할 수 없습니다. 하지만 연산자를 distinct 사용할 수 있습니다.

새 디자이너
클래식 디자이너

사용자 지정 쿼리를 보다 유연하게 작성할 수 있는 Dataverse 스타일 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 함수를 사용하여 중복 행을 제거할 수 있습니다. 예를 들어 선택 작업을 사용하여 목록 행 연결의 응답을 필요한 특정 배열 형식으로 변환한 다음 식을 union(body('Select'),body('Select')) 사용하여 고유 행이 있는 배열을 가져오는 변수를 만들 수 있습니다.

Xml 쿼리 가져오기 필드에 다음 텍스트를 입력합니다.

FetchXML을 사용하여 계정 예제를 나열합니다.

고유 연산자는 현재 행 나열 작업의 FetchXML 쿼리에서 직접 지원되지 않으므로 공용 구조체 함수 를 사용하여 중복 행을 제거합니다. 예를 들어 선택 작업을 사용하여 목록 행 연결의 응답을 필요한 특정 배열 형식으로 변환한 다음 식을 union(body('Select'),body('Select')) 사용하여 고유 행이 있는 배열을 가져오는 변수를 만들 수 있습니다.

토큰 건너뛰기

Power Automate 콘텐츠 처리량 제한 및 메시지 크기 제한을 적용하여 일반 서비스를 보장합니다. 이러한 한도 내에서 작업하려면 페이지 매김 을 사용하여 반환되는 테이블 행 수에 대한 기본 한도가 아닌 더 적은 수의 행을 일괄 처리로 반환합니다.

페이지 매김을 사용하지 않는 경우 기본 페이지 제한은 5,000개 행입니다.

페이지 매김을 사용하려면 루프를 구현하여 JSON 응답에서 \@odata.nextLink 값을 구문 분석하고, skip 토큰을 추출한 다음, 필요한 수의 행을 나열할 때까지 다른 요청을 보냅니다.

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

Elastic 테이블의 데이터를 검색하는 동안 partitionId를 지정합니다. 자세한 내용은 탄력적 테이블에 대한 분할 및 수평 크기 조정을 참조하세요.

피드백

이 페이지가 도움이 되었나요?

2026-09-25 에 마지막으로 업데이트됨