First, FirstN, Index, Last 및 LastN 함수

아티클
03/22/2024

적용 대상: 캔버스 앱 데스크톱 흐름 모델 기반 앱 Power Platform CLI

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

설명

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

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

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

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

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

First, Index, Last는 단일 레코드를 반환합니다. FirstN 및 LastN는 단일 레코드만 지정해도 테이블을 반환합니다.

위임

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

예를 들어, 백만 개의 레코드가 있는 큰 테이블이 포함된 데이터 원본과 함께 사용하는 경우 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 )	요청된 레코드가 테이블의 범위를 벗어나므로 오류를 반환합니다.	오류

First, FirstN, Index, Last 및 LastN 함수

설명

위임

구문

예

추가 리소스