Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/genkami/memeduck
memeduck is a SQL query builder for Cloud Spanner
https://github.com/genkami/memeduck
cloud-spanner go golang google-cloud query-builder spanner sql
Last synced: about 23 hours ago
JSON representation
memeduck is a SQL query builder for Cloud Spanner
- Host: GitHub
- URL: https://github.com/genkami/memeduck
- Owner: genkami
- License: apache-2.0
- Created: 2021-05-21T11:52:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-08T16:05:43.000Z (10 days ago)
- Last Synced: 2024-11-08T17:19:40.736Z (10 days ago)
- Topics: cloud-spanner, go, golang, google-cloud, query-builder, spanner, sql
- Language: Go
- Homepage:
- Size: 254 KB
- Stars: 10
- Watchers: 3
- Forks: 6
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# memeduck
[](https://pkg.go.dev/github.com/genkami/memeduck)
The memeduck is a SQL query builder for Cloud Spanner. (named after [MakeNowJust/memefish](https://github.com/MakeNowJust/memefish))
**This project is currently in an experimental state and any API will be changed in an backward-incompatible way.**
## Examples
### Select
```go
query, _ := memeduck.Select("user", []string{"name", "created_at"}).
Where(memeduck.Eq(memeduck.Ident("good_at"), "cooking")).
LimitOffset(10, 3).
SQL()
fmt.Println(query)
// Output: SELECT name, created_at FROM user WHERE good_at = "cooking" LIMIT 10 OFFSET 3
```
```go
// user has many items
itemStmt := memeduck.Select("user_item", []string{"item_id", "count"}).
Where(memeduck.Eq(memeduck.Ident("user_id"), "user-id")).
AsStruct()
// user has one status
statusStmt := memeduck.Select("user_status", []string{"state"}).
Where(memeduck.Eq(memeduck.Ident("user_id"), "user-id")).
AsStruct()
query.Stmt, _ := memeduck.Select("user", []string{"name"}).
SubQuery(
memeduck.ArraySubQuery(itemStmt).As("user_item"),
memeduck.ScalarSubQuery(statusStmt).As("user_status"),
).
Where(memeduck.Eq(memeduck.Ident("user_id"), "user-id")).
SQL()
// Output:
// SELECT
// name,
// ARRAY(SELECT AS STRUCT item_id, count FROM user_item WHERE user_id = "user-id") AS user_item,
// ARRAY(SELECT AS STRUCT state FROM user_status WHERE user_id = "user-id") AS user_status
// FROM user WHERE user_id = "user-id"
```
### Insert
```go
type ExampleUserStruct struct {
Name string `spanner:"UserName"`
Papa string `spanner:"PapaName"`
}
```
```go
query, _ := memeduck.Insert("users", []string{"UserName", "PapaName"}).Values([]ExampleUserStruct{
{Name: "Kiara", Papa: "huke"},
}).SQL()
fmt.Println(query)
// Output: INSERT INTO users (UserName, PapaName) VALUES ("Kiara", "huke")
```
### Update
```go
query, _ := memeduck.Update("user").
Set(memeduck.Ident("age"), memeduck.Param("age")).
Where(memeduck.Eq(memeduck.Ident("shark"), true)).
SQL()
fmt.Println(query)
// Output: UPDATE user SET age = @age WHERE shark = TRUE
```
### Delete
```go
query, _ := memeduck.Delete("user").
Where(memeduck.Eq(memeduck.Ident("id"), 123)).
Where(memeduck.Eq(memeduck.Ident("unused"), true)).
SQL()
fmt.Println(query)
// Output: DELETE FROM user WHERE id = 123 AND unused = TRUE
```
You can see more examples in the examples sectionss of the [documentation](https://pkg.go.dev/github.com/genkami/memeduck).
## License
Distributed under the Apache License, Version 2.0. See LICENSE for more information.