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는 단일 레코드를 반환합니다. 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 데이터 원본을 사용합니다.
이 테이블은 다음 공식을 사용하여 컬렉션에 배치할 수 있습니다(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 ) | 요청된 레코드가 테이블의 범위를 벗어나므로 오류를 반환합니다. | 오류 |