Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/elgris/sqrl
Fluent SQL generation for golang
https://github.com/elgris/sqrl
Last synced: 14 days ago
JSON representation
Fluent SQL generation for golang
- Host: GitHub
- URL: https://github.com/elgris/sqrl
- Owner: elgris
- License: mit
- Fork: true (Masterminds/squirrel)
- Created: 2014-06-25T10:03:06.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2023-06-15T08:13:47.000Z (over 1 year ago)
- Last Synced: 2024-07-31T20:50:02.283Z (3 months ago)
- Language: Go
- Homepage:
- Size: 188 KB
- Stars: 274
- Watchers: 11
- Forks: 38
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-go - sqrl - SQL query builder, fork of Squirrel with improved performance. (Database / SQL Query Builders)
- awesome-go-storage - sqrl - SQL query builder, fork of Squirrel with improved performance. (Database)
- awesome-go-extra - sqrl - 06-25T10:03:06Z|2022-04-20T08:34:43Z| (Generators / SQL Query Builders)
- awesome-go-storage - sqrl - SQL query builder, fork of Squirrel with improved performance. (Database)
- awesome-go - sqrl - Fluent SQL generation for golang - ★ 132 (Database)
README
# sqrl - fat-free version of squirrel - fluent SQL generator for Go
**Non thread safe** fork of [squirrel](http://github.com/lann/squirrel). The same handy fluffy helper, but with extra letters removed :)
```go
import "github.com/elgris/sqrl"
```
[](https://godoc.org/github.com/elgris/sqrl)
[](https://travis-ci.org/elgris/sqrl)
**Requires Go 1.8 and higher**
## Inspired by
- [squirrel](https://github.com/lann/squirrel)
- [dbr](https://github.com/gocraft/dbr)
## Why to make good squirrel lighter?
Ask [benchmarks](https://github.com/elgris/golang-sql-builder-benchmark) about that ;). Squirrel is good, reliable and thread-safe with it's immutable query builder. Although immutability is nice, it's resource consuming and sometimes redundant. As authors of `dbr` say: "100% of our application code was written without the need for this".
## Why not to use dbr then?
Although, `dbr`'s query builder is proven to be much [faster than squirrel](https://github.com/tyler-smith/golang-sql-benchmark) and even faster than [sqrl](https://github.com/elgris/golang-sql-builder-benchmark), it doesn't have all syntax sugar. Especially I miss support of JOINs, subqueries and aliases.
## Usage
**sqrl is not an ORM.**, it helps you build SQL queries from composable parts.
**sqrl is non thread safe**. SQL builders change their state, so using the same builder in parallel is dangerous.
It's very easy to switch between original squirrel and sqrl, because there is no change in interface:
```go
import sq "github.com/elgris/sqrl" // you can easily use github.com/lann/squirrel here
users := sq.Select("*").From("users").Join("emails USING (email_id)")
active := users.Where(sq.Eq{"deleted_at": nil})
sql, args, err := active.ToSql()
sql == "SELECT * FROM users JOIN emails USING (email_id) WHERE deleted_at IS NULL"
```
```go
sql, args, err := sq.
Insert("users").Columns("name", "age").
Values("moe", 13).Values("larry", sq.Expr("? + 5", 12)).
ToSql()
sql == "INSERT INTO users (name,age) VALUES (?,?),(?,? + 5)"
```
Like [squirrel](https://github.com/lann/squirrel), sqrl can execute queries directly:
```go
stooges := users.Where(sq.Eq{"username": []string{"moe", "larry", "curly", "shemp"}})
three_stooges := stooges.Limit(3)
rows, err := three_stooges.RunWith(db).Query()
// Behaves like:
rows, err := db.Query("SELECT * FROM users WHERE username IN (?,?,?,?) LIMIT 3", "moe", "larry", "curly", "shemp")
```
Build conditional queries with ease:
```go
if len(q) > 0 {
users = users.Where("name LIKE ?", q)
}
```
### MySQL-specific functions
#### [Multi-table delete](https://dev.mysql.com/doc/refman/5.7/en/delete.html)
```go
sql, args, err := sq.Delete("a1", "a2").
From("z1 AS a1").
JoinClause("INNER JOIN a2 ON a1.id = a2.ref_id").
Where("b = ?", 1).
ToSql()
```
```go
sql, args, err := sq.Delete("a1").
Using("a2").
Where("a1.id = a2.ref_id AND a2.num = ?", 42).
ToSql()
```
### PostgreSQL-specific functions
Package [pg](https://godoc.org/github.com/elgris/sqrl/pg) contains PostgreSQL specific operators.
#### [Update from](https://www.postgresql.org/docs/current/static/sql-update.html)
```go
sql, args, err := sq.Update("a1").
Set("foo", 1).
From("a2").
Where("id = a2.ref_id AND a2.num = ?", 42).
ToSql()
```
#### [Delete using](https://www.postgresql.org/docs/current/static/sql-delete.html)
```go
sql, args, err := sq.Delete("a1").
Using("a2").
Where("id = a2.ref_id AND a2.num = ?", 42).
ToSql()
```
#### [Returning clause](https://www.postgresql.org/docs/current/static/dml-returning.html)
```go
sql, args, err := Update("a").
Set("foo", 1).
Where("id = ?", 42).
Returning("bar").
ToSql()
```
#### [JSON values](https://www.postgresql.org/docs/current/static/functions-json.html)
JSON and JSONB use json.Marshal to serialize values and cast them to appropriate column type.
```go
sql, args, err := sq.Insert("posts").
Columns("content", "tags").
Values("Lorem Ipsum", pg.JSONB([]string{"foo", "bar"})).
ToSql()
```
#### [Array values](https://www.postgresql.org/docs/current/static/arrays.html)
Array serializes single and multidimensional slices of string, int, float32 and float64 values.
```go
sql, args, err := sqrl.Insert("posts").
Columns("content", "tags").
Values("Lorem Ipsum", pg.Array([]string{"foo", "bar"})).
ToSql()
```
## License
Sqrl is released under the
[MIT License](http://www.opensource.org/licenses/MIT).