Document

OrchardCMS · Nov 7, 2024 · 3e1dbdf · 3e1dbdf
1 parent 3aa6ab8
commit 3e1dbdf
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 0 deletions.
diff --git a/src/docs/reference/modules/Queries/README.md b/src/docs/reference/modules/Queries/README.md
@@ -289,6 +289,12 @@ The SQL parser is also able to convert some specific functions to the intended d
 | `year(_date_)`   | Returns the years part of a date.   |
 | `now()`          | Returns current date time (utc).    |
 
+Order By clauses can also use the `random()` function (case insensitive) to order results randomly, e.g., 
+
+```
+SELECT * FROM ContentItemIndex ORDER BY random()
+```
+
 ## Scripting
 
 The following JavaScript functions are available with this module.

diff --git a/test/OrchardCore.Tests/Orchard.Queries/SqlParserTests.cs b/test/OrchardCore.Tests/Orchard.Queries/SqlParserTests.cs
@@ -246,6 +246,7 @@ public void ShouldParseSubquery(string sql, string expectedSql)
 
     [Theory]
     [InlineData("select a order by RANDOM()", "SELECT [a] ORDER BY newid();")]
+    [InlineData("select a order by random()", "SELECT [a] ORDER BY newid();")]
     [InlineData("select a order by RANDOM", "SELECT [a] ORDER BY [RANDOM];")]
     public void ShouldOrderByRandom(string sql, string expectedSql)
     {