feat: add InRandomOrder method

contracts/database/orm/constants.go

@@ -3,6 +3,7 @@ package orm
 const (
 	DriverMysql      Driver = "mysql"
 	DriverPostgresql Driver = "postgresql"
+	DriverPostgres   Driver = "postgres"
 	DriverSqlite     Driver = "sqlite"
 	DriverSqlserver  Driver = "sqlserver"
 )

contracts/database/orm/orm.go

@@ -74,6 +74,8 @@ type Query interface {
 	Group(name string) Query
 	// Having specifying HAVING conditions for the query.
 	Having(query any, args ...any) Query
+	// InRandomOrder specifies the order randomly.
+	InRandomOrder() Query
 	// Join specifying JOIN conditions for the query.
 	Join(query string, args ...any) Query
 	// Limit the number of records returned.

database/gorm/query.go

@@ -455,6 +455,21 @@ func (r *QueryImpl) OrderByDesc(column string) ormcontract.Query {
 	return r.Order(fmt.Sprintf("%s DESC", column))
 }
 
+func (r *QueryImpl) InRandomOrder() ormcontract.Query {
+	order := ""
+	switch r.Driver() {
+	case ormcontract.DriverMysql:
+		order = "RAND()"
+	case ormcontract.DriverSqlserver:
+		order = "NEWID()"
+	case ormcontract.DriverPostgres:
+		order = "RANDOM()"
+	case ormcontract.DriverSqlite:
+		order = "RANDOM()"
+	}
+	return r.Order(order)
+}
+
 func (r *QueryImpl) OrWhere(query any, args ...any) ormcontract.Query {
 	tx := r.instance.Or(query, args...)
 

database/gorm/query_test.go

@@ -1973,6 +1973,28 @@ func (s *QueryTestSuite) TestOrderByDesc() {
 	}
 }
 
+func (s *QueryTestSuite) TestInRandomOrder() {
+	for driver, query := range s.queries {
+		s.Run(driver.String(), func() {
+			for i := 0; i < 30; i++ {
+				user := User{Name: "random_order_user", Avatar: "random_order_avatar"}
+				s.Nil(query.Create(&user))
+				s.True(user.ID > 0)
+			}
+
+			var users1 []User
+			s.Nil(query.Where("name = ?", "random_order_user").InRandomOrder().Find(&users1))
+			s.True(len(users1) == 30)
+
+			var users2 []User
+			s.Nil(query.Where("name = ?", "random_order_user").InRandomOrder().Find(&users2))
+			s.True(len(users2) == 30)
+
+			s.True(users1[0].ID != users2[0].ID || users1[14].ID != users2[14].ID || users1[29].ID != users2[29].ID)
+		})
+	}
+}
+
 func (s *QueryTestSuite) TestPaginate() {
 	for driver, query := range s.queries {
 		s.Run(driver.String(), func() {