8.17.7 ORDER BY節
ORDER BY節ではオブジェクトや値が順序付けされてクエリの結果を返します。ORDER BY節の記述例を次に示します。
SELECT e FROM Employee AS e ORDER BY e.monthlySalary DESC
ORDER BY節について説明します。
-
一つ以上のorder項目が指定された場合,orderby項目要素の左から右へ順に優先度を決め,いちばん左のorderby項目がいちばん高い優先度を持ちます。
-
ASCは昇順のときに,DESCは降順のときに指定します。なお,デフォルト値はASCです。
-
null値がある場合の順番はSQLのルールを適用します。
-
ORDER BY節が使用された場合,クエリの結果の順番はクエリメソッドの結果に保存されます。
なお,ORDER BY節の構文については,「付録G JPQLのBNF」を参照してください。
また,ORDER BY節では次に示す条件を満たす必要があります。
-
ORDER BY節で指定するorder項目は順序付けができること。
-
ORDER BY節で指定するorder項目はSELECT節のselect式からたどれること。
これらの条件に合わない場合,CJPAプロバイダでは例外が発生するおそれがあります。ただし,例外が発生しない場合でも動作は保証しません。