다음을 통해 공유


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만 개 중간에 레코드를 요청하면 비위임 한도에 따라 인덱스가 범위를 벗어났기 때문에 오류가 발생합니다.

구문

First( Table )
Last( Table )

  • Table – 필수 항목입니다. 연산을 수행할 테이블입니다.

FirstN( Table [, NumberOfRecords ] )
LastN( Table [, NumberOfRecords ] )

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

Index(Table, RecordIndex)

  • Table – 필수 항목입니다. 연산을 수행할 테이블입니다.
  • 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
First( IceCream ) IceCream의 첫 번째 레코드를 반환합니다. { Flavor: "Chocolate", Quantity: 100 }
Last( IceCream ) IceCream의 마지막 레코드를 반환합니다. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) IceCream의 세 번째 레코드를 반환합니다. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) IceCream의 처음 두 레코드를 포함하는 테이블을 반환합니다. 초콜릿과 바닐라에 대한 레코드를 포함하는 테이블
LastN( IceCream, 2 ) IceCream의 마지막 두 레코드를 포함하는 테이블을 반환합니다. 민트 초콜릿과 피스타치오에 대한 레코드를 포함하는 테이블
Index( IceCream, 4 ).Quantity 테이블의 네 번째 레코드를 반환하고 Quantity 열을 추출합니다. 60
Index( IceCream, 10 ) 요청된 레코드가 테이블의 범위를 벗어나므로 오류를 반환합니다. 오류