Commit 22d0af5

committed

two improvements to doc for HQL 'order by'

1 parent 4c94ee7 commit 22d0af5Copy full SHA for 22d0af5

File tree

+10

-2

lines changed

documentation/src/main/asciidoc
- querylanguage
  - Relational.adoc
- userguide/chapters/query/hql
  - QueryLanguage.adoc

+10

-2

lines changed

Lines changed: 8 additions & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -563,7 +563,8 @@ Even the identification variable of an entity with a sortable identifier type ma`
`563`	`563`	`[NOTE]`
`564`	`564`	`====`
`565`	`565`	The JPQL specification requires that every sorted item in the `order by` clause also occur in the `select` clause.
`566`		`-HQL does not enforce this restriction, but applications desiring database portability should be aware that some databases _do_.`
	`566`	`+HQL does not enforce this restriction, but if you desire cross-database portability, you should be aware that some databases _do_.`
	`567`	+And even databases which don't usually enforce this restriction do enforce it for `distinct` queries.
`567`	`568`
`568`	`569`	`Therefore, you might wish to avoid the use of complex expressions in the sort list.`
`569`	`570`	`====`
`@@ -615,6 +616,12 @@ having year(order.dateTime) > 2000`
`615`	`616`	`order by yearlyTotalSold desc, year desc`
`616`	`617`	`----`
`617`	`618`
	`619`	`+[TIP]`
	`620`	`+====`
	`621`	+If a query doesn't explicitly specify `nulls first` or `nulls last`, then, by default, the precedence of null values depends on the database.
	`622`	+To obtain platform-independent behavior for queries which don't specify `nulls first` or `nulls last`, set the configuration property `hibernate.order_by.default_null_ordering` to `first` or `last`.
	`623`	`+====`
	`624`	`+`
`618`	`625`	`Queries with an ordered result list may have limits or pagination.`
`619`	`626`
`620`	`627`	`[[limit-offset]]`

Lines changed: 2 additions & 1 deletion

Original file line number	Diff line number	Diff line change
`@@ -3902,7 +3902,8 @@ Even the identification variable of an entity with a sortable identifier type ma`
`3902`	`3902`	`[NOTE]`
`3903`	`3903`	`====`
`3904`	`3904`	The JPQL specification requires that every sorted item in the `order by` clause also occur in the `select` clause.
`3905`		`-HQL does not enforce this restriction, but applications desiring database portability should be aware that some databases _do_.`
	`3905`	`+HQL does not enforce this restriction, but if you desire cross-database portability, you should be aware that some databases _do_.`
	`3906`	+And even databases which don't usually enforce this restriction do enforce it for `distinct` queries.
`3906`	`3907`
`3907`	`3908`	`Therefore, you might wish to avoid the use of complex expressions in the sort list.`
`3908`	`3909`	`====`

Comments

(0)