다음을 통해 공유


First, FirstN, Index, Last 및 LastN 함수

적용 대상: 캔버스 앱 바탕 화면 흐름 모델 기반 앱 Power Pages Power Platform CLI

테이블에서 첫 번째, 마지막 또는 특정 레코드 또는 첫 번째 또는 마지막 레코드 집합을 반환합니다.

설명

First 함수는 테이블의 첫 번째 레코드를 반환합니다.

FirstN 함수는 테이블의 첫 번째 레코드 집합을 반환합니다. 두 번째 인수는 반환할 레코드 수를 지정합니다.

Last 함수는 테이블의 마지막 레코드를 반환합니다.

LastN 함수는 테이블의 마지막 레코드 집합을 반환합니다. 두 번째 인수는 반환할 레코드 수를 지정합니다.

Index 함수는 테이블에서 정렬된 위치를 기반으로 테이블의 레코드를 반환합니다. 레코드 번호 매기기는 1로 시작하므로 First( table )Index( table, 1 )와 동일한 레코드를 반환합니다. Index 는 요청된 레코드 인덱스가 1보다 작거나, 테이블의 레코드 수보다 크거나, 테이블이 비어 있는 경우 오류를 반환합니다.

First, Index, Last 는 단일 레코드를 반환합니다. FirstNLastN 은 단일 레코드만 지정하더라도 테이블을 반환합니다.

위임

데이터 원본과 함께 사용할 경우 이러한 함수를 위임할 수 없습니다. 데이터 원본의 첫 번째 부분만 검색된 다음 함수가 적용됩니다. 결과는 전체 스토리를 나타내지 않을 수 있습니다. 승인 시 경고가 나타나 이러한 제한을 상기시키고 가능한 경우 위임 가능한 대체 항목으로 전환할 것을 제안할 수 있습니다. 자세한 내용은 위임 개요를 참조하십시오.

예를 들어, 백만 개의 레코드가 있는 큰 테이블이 포함된 데이터 원본과 함께 사용하는 경우 Last는 비위임 제한의 적용을 받으며 전체 데이터 원본의 마지막 레코드를 반환하지 않습니다. 마찬가지로 Index를 사용하여 레코드 100만 개 중간에 레코드를 요청하면 비위임 한도에 따라 인덱스가 범위를 벗어났기 때문에 오류가 발생합니다.

구문

첫 번째( )
마지막( 테이블 )

  • - 필수. 연산을 수행할 테이블입니다.

첫 번째N( 테이블 [, 레코드 수 ])
마지막N( 테이블 [, 레코드 수 ] )

  • - 필수. 연산을 수행할 테이블입니다.
  • NumberOfRecords - 선택 사항. 반환할 레코드의 수입니다. 이 인수를 지정하지 않으면 함수는 하나의 레코드를 반환합니다.

인덱스( 테이블, 레코드인덱스 )

  • - 필수. 연산을 수행할 테이블입니다.
  • RecordIndex - 필수. 반환할 레코드의 색인입니다. 레코드 번호는 1부터 시작합니다.

다음 예에서는 이 테이블의 데이터가 포함된 IceCream 데이터 원본을 사용합니다.

IceCream 예.

이 테이블은 다음 공식을 사용하여 컬렉션에 배치할 수 있습니다(Button 컨트롤에 대해 OnStart 공식을 입력하고 단추를 누름).

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
수식 설명 Result
첫 번째( 아이스크림 ) IceCream의 첫 번째 레코드를 반환합니다. { Flavor: "Chocolate", Quantity: 100 }
마지막(아이스크림) IceCream의 마지막 레코드를 반환합니다. { Flavor: "Pistachio", Quantity: 200 }
인덱스( 아이스크림, 3 ) IceCream의 세 번째 레코드를 반환합니다. { Flavor: "Strawberry", Quantity: 300 }
FirstN(아이스크림, 2) IceCream의 처음 두 레코드를 포함하는 테이블을 반환합니다. 초콜릿과 바닐라에 대한 레코드를 포함하는 테이블
라스트엔(아이스크림, 2) IceCream의 마지막 두 레코드를 포함하는 테이블을 반환합니다. 민트 초콜릿과 피스타치오에 대한 레코드를 포함하는 테이블
인덱스(아이스크림, 4).수량 테이블의 네 번째 레코드를 반환하고 Quantity 열을 추출합니다. 60
인덱스( 아이스크림, 10 ) 요청된 레코드가 테이블의 범위를 벗어나므로 오류를 반환합니다. 오류