FirstSortedValue - スクリプト関数

FirstSortedValue()では、value で指定された項目の中で sort_weight 引数のソート結果に対応する値が返されます。rank を指定している場合は、それも考慮されます。指定された sort_weightで複数の値が同じ rank を共有している場合、この関数は NULL を返します。

保存された値は、group by条件で定義されたレコードの数だけ反復処理されます。group by 条件が定義されていない場合は、すべてのデータ セットから集計されます。

構文:  

FirstSortedValue ([ distinct ] value, sort-weight [, rank ])

戻り値のデータ型: デュアル

引数:  

引数 説明
value Expression この関数は、数式 valueの値を特定します。これは、sort_weight のソート結果に対応します。
sort-weight Expression ソート対象となるデータが含まれている数式です。sort_weightの最初の値 (最小値) が返され、そこからvalue 数式の対応する値が特定されます。sort_weightの前にマイナス記号を付けると、最後にソートされた値 (最大値) が返されます。
rank Expression

rank"n" に 1 よりも大きな値を入力するとで、n 番目のソート値を取得できます。

distinct

関数の引数の前に DISTINCTという用語が付いている場合、関数の引数の評価から生じる重複は無視されます。

例と結果:  

ドキュメントに例のスクリプトを追加して実行します。その後、結果列に含まれている項目をドキュメントのシートに追加して結果を表示します。

結果
Temp:

LOAD * inline [

Customer|Product|OrderNumber|UnitSales|CustomerID

Astrida|AA|1|10|1

Astrida|AA|7|18|1

Astrida|BB|4|9|1

Astrida|CC|6|2|1

Betacab|AA|5|4|2

Betacab|BB|2|5|2

Betacab|DD|12|25|2

Canutility|AA|3|8|3

Canutility|CC|13|19|3

Divadip|AA|9|16|4

Divadip|AA|10|16|4

Divadip|DD|11|10|4

] (delimiter is '|');

 

FirstSortedValue:

LOAD Customer,FirstSortedValue(Product, UnitSales) as MyProductWithSmallestOrderByCustomer Resident Temp Group By Customer;

Customer MyProductWithSmallestOrderByCustomer

Astrida CC

Betacab AA

Canutility AA

Divadip DD

この関数は UnitSalesを最小値から最大値の順にソートし、Customer の値のうち UnitSales の最小値を持つものを、最小値から順に検索します。

これは、CCが customer Astrida の最小の注文 (値はUnitSales: 2) に対応するためです。AAは customer Betacab の最小注文 (4)、CC は customer Canutility の最小注文 (8)、DD は customer Divadip. の最小注文 (10) に対応します。

Tempテーブルが前の例のようにロードされた場合:

LOAD Customer,FirstSortedValue(Product, -UnitSales) as MyProductWithLargestOrderByCustomer Resident Temp Group By Customer;

Customer MyProductWithLargestOrderByCustomer

Astrida AA

Betacab DD

Canutility CC

Divadip -

sort_weight引数の前にマイナス記号を付けると、最大値から順にソートされます。

AAは customer Astrida の最大の注文 (値は UnitSales:18)、DD は customer Betacab の最大の注文 (12)、CC は customerCanutility の最大の注文 (13) に対応します。customer Divadipの最大の注文は 2 つの同じ値 (16) を持つため、結果は NULL となります。

Tempテーブルが前の例のようにロードされた場合:

LOAD Customer,FirstSortedValue(distinct Product, UnitSales) as MyProductWithSmallestOrderByCustomer Resident Temp Group By Customer;

Customer MyProductWithLargestOrderByCustomer

Astrida AA

Betacab DD

Canutility CC

Divadip AA

distinct修飾子が使用されている点を除くと、前の例と同じ結果になります。この場合は Divadipの結果が重複して無視され、NULL 以外の値を返すことができるようになります。