It is the library to work with "database/sql" of GO SDK to offer some advantages:
- Simplify common database operations, such as CRUD (Create, Read, Update, Delete) operations, transactions, and batch processing, by providing high-level abstractions and utilities.
- The sample is at go-sql-sample.
- It is compatible with various SQL databases such as Postgres, My SQL, MS SQL, Oracle, SQLite, offer flexibility in terms of database driver selection, and query building capabilities.
Some use cases that we optimize the performance:
- When insert many rows, we build a single SQL statement and execute once. The syntax of Oracle is different from Postgres, My SQL, MS SQL, SQLite.
- Source code to build dynamic SQL statement is here, and the sample is at project-samples/go-import
- When you want to insert or update, we build a single SQL statement.
- Cons: The syntax is specified for Oracle, MS SQL, Postgres, My SQL, SQLite. So, source code is long and complicated.
- Props: Because it interacts with DB once, it has a better performance.
- Reduce boilerplate code associated with database interactions, allowing developers to focus more on application logic rather than low-level database handling
- In this layer architecture sample, you can see we can reduce a lot of source code at data access layer, or you use generic repository to replace all repository source code.
You can refer to Generic CRUD Repository and Data Processing for more details.
- Support decimal, which is useful for currency
- Utilities to build dynamic SQL queries programmatically.
- Support for common SQL operations (SELECT, INSERT, UPDATE, DELETE).
- Support insert or update (upsert) operations, support Oracle, Postgres, My SQL, MS SQL, SQLite
- Functions to map SQL rows to Go structs.
- Benefits:
- Simplifies the process of converting database rows into Go objects.
- Reduces repetitive code and potential errors in manual data mapping.
- Enhances code readability and maintainability
- Support for database transactions, including commit and rollback.
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="mappers">
<select id="user">
select *
from users
where
<if test="username != null">
username like #{username} and
</if>
<if test="displayName != null">
displayName like #{displayName} and
</if>
<if test="status != null">
status in (#{status}) and
</if>
<if test="q != null">
(username like #{q} or displayName like #{q} or email like #{q}) and
</if>
1 = 1
<if test="sort != null">
order by {sort}
</if>
<if test="sort == null">
order by userId
</if>
</select>
</mapper>
Repository is like CrudRepository of Spring, it provides these advantages:
- Simplicity: provides a set of standard CRUD (Create, Read, Update, Delete) operations out of the box, reducing the amount of boilerplate code developers need to write.
- Especially, it provides "Save" method, to build an insert or update statement, specified for Oracle, MySQL, MS SQL, Postgres, SQLite.
- Consistency: By using Repository, the code follows a consistent pattern for data access across the application, making it easier to understand and maintain.
- Rapid Development: reducing boilerplate code and ensuring transactional integrity.
- Flexibility: offers flexibility and control over complex queries, because it uses "database/sql" at GO SDK level.
- Type Safety: being a generic interface, it provides type-safe access to the entity objects, reducing the chances of runtime errors.
- Learning Curve: it supports utilities at GO SDK level. So, a developer who works with "database/sql" at GO SDK can quickly understand and use it.
- Composite primary key: it supports composite primary key.
- You can look at the sample at go-sql-composite-key.
- In this sample, the company_users has 2 primary keys: company_id and user_id
- You can define a GO struct, which contains 2 fields: CompanyId and UserId
package model type UserId struct { CompanyId string `json:"companyId" gorm:"column:company_id;primary_key"` UserId string `json:"userId" gorm:"column:user_id;primary_key"` }
- Conclusion: The Repository offers a straightforward way to implement basic CRUD operations, promoting rapid development and consistency across applications. While it provides many advantages, such as reducing boilerplate code and ensuring transactional integrity, it also it also offers flexibility and control over complex queries, because it uses "database/sql" at GO SDK level.
- Samples: The sample is at go-sql-generic-sample. The composite key sample is at go-sql-composite-key.
- Filtering is the process of narrowing down a dataset based on specific criteria or conditions. This allows users to refine the results to match their needs, making it easier to find relevant data.
- Pagination is the process of dividing a large dataset into smaller pages. Key Concepts of Pagination:
- Page Size: The number of items displayed on each page.
- Example: If you have 100 items and a page size of 10, there will be 10 pages in total.
- Page Number: The current page being viewed.
- Example: If you are on page 3 with a page size of 10, items 21 to 30 will be displayed.
- Offset and Limit:
- Offset: The number of items to skip before starting to collect the result set.
- Limit: The maximum number of items to return.
- Example: For page 3 with a page size of 10, the offset would be 20, and the limit would be 10 (SELECT * FROM items LIMIT 10 OFFSET 20).
- Page Size: The number of items displayed on each page.
- Sorting: build a dynamic SQL with sorting:
- Build multi-column sorting based on dynamic parameters:
- Input: sort=phone,-id,username,-dateOfBirth
- Output: order by phone, id desc, username, date_of_birth desc
- You can define your own format, and inject your own function to map
- Safe and Secure Input Handling
- See the above output, you can see we map JSON field name to database column name: username with username, dateOfBirth with date_of_birth
- If you pass the columns which does not exist, the library ignore these columns.
- Build multi-column sorting based on dynamic parameters:
The flow for search/paging:
- Build the dynamic query
- Build the paging query from dynamic query (it specified for Oracle, Postgres, My SQL, MS SQL, SQLite)
- Query data and map to array of struct
- Build the count query
- Count the total records for paging
- SQL Writer: to insert or update data
- SQL Inserter: to insert data
- SQL Updater: to update data
- SQL Stream Writer: to insert or update data. When you write data, it keeps the data in the buffer, it does not write data. It just writes data when flush.
- SQL Stream Inserter: to insert data. When you write data, it keeps the data in the buffer, it does not write data. It just writes data when flush. Especially, we build 1 single SQL statement to improve the performance.
- SQL Stream Updater: to update data. When you write data, it keeps the data in the buffer, it does not write data. It just writes data when flush.
- Batch Inserter: to insert a batch of records. It builds a single SQL statement to improve the performance, specified for Oracle, Postgres, My SQL, MS SQL, SQLite.
- Batch Updater
- Batch Writer
- Monitors the health of database connections
- Sample is at go-sql-sample.
- Save Action Log with dynamic database design
- Look at this sample user, you can see it automatically build a dynamic query for serach.
func BuildFilter(
filter *model.UserFilter) (string, []interface{}) {
buildParam := s.BuildDollarParam
var where []string
var params []interface{}
i := 1
if len(filter.Id) > 0 {
params = append(params, filter.Id)
where = append(where,
fmt.Sprintf(`id = %s`, buildParam(i)))
i++
}
if filter.DateOfBirth != nil {
if filter.DateOfBirth.Min != nil {
params = append(params, filter.DateOfBirth.Min)
where = append(where,
fmt.Sprintf(`date_of_birth >= %s`, buildParam(i)))
i++
}
if filter.DateOfBirth.Max != nil {
params = append(params, filter.DateOfBirth.Max)
where = append(where,
fmt.Sprintf(`date_of_birth <= %s`, buildParam(i)))
i++
}
}
if len(filter.Username) > 0 {
q := filter.Username + "%"
params = append(params, q)
where = append(where,
fmt.Sprintf(`username like %s`, buildParam(i)))
i++
}
if len(filter.Email) > 0 {
q := filter.Email + "%"
params = append(params, q)
where = append(where,
fmt.Sprintf(`email like %s`, buildParam(i)))
i++
}
if len(filter.Phone) > 0 {
q := "%" + filter.Phone + "%"
params = append(params, q)
where = append(where,
fmt.Sprintf(`phone like %s`, buildParam(i)))
i++
}
if len(where) > 0 {
return strings.Join(where, " and "), params
}
return "", params
} |
buildQuery := query.UseQuery[
model.User,
*model.UserFilter](db, "users")
query, args := buildQuery(filter) |
- For example in this file adapter.go, you can see it reduces a lot of source code.
func (r *UserAdapter) Load(
ctx context.Context,
id string) (*User, error) {
query := `
select
id,
username,
email,
phone,
date_of_birth
from users where id = ?`
rows, err := r.DB.QueryContext(ctx, query, id)
if err != nil {
return nil, err
}
defer rows.Close()
for rows.Next() {
var user User
err = rows.Scan(
&user.Id,
&user.Username,
&user.Phone,
&user.Email,
&user.DateOfBirth)
return &user, nil
}
return nil, nil
} |
import q "github.com/core-go/sql"
func (r *UserAdapter) Load(
ctx context.Context,
id string) (*User, error) {
var users []User
query := fmt.Sprintf(`
select
id,
username,
email,
phone,
date_of_birth
from users where id = %s limit 1`,
q.BuildParam(1))
err := q.Select(ctx, r.DB, &users, query, id)
if err != nil {
return nil, err
}
if len(users) > 0 {
return &users[0], nil
}
return nil, nil
} |
- For example in this file adapter.go, you can see it reduces a lot of source code.
func (r *UserAdapter) Create(
ctx context.Context,
user *User) (int64, error) {
query := `
insert into users (
id,
username,
email,
phone,
date_of_birth)
values (
?,
?,
?,
?,
?)`
tx := GetTx(ctx)
stmt, err := tx.Prepare(query)
if err != nil {
return -1, err
}
res, err := stmt.ExecContext(ctx,
user.Id,
user.Username,
user.Email,
user.Phone,
user.DateOfBirth)
if err != nil {
return -1, err
}
return res.RowsAffected()
} |
import q "github.com/core-go/sql"
func (r *UserAdapter) Create(
ctx context.Context,
user *User) (int64, error) {
query, args := q.BuildToInsert("users", user, q.BuildParam)
tx := q.GetTx(ctx)
res, err := tx.ExecContext(ctx, query, args...)
return q.RowsAffected(res, err)
} |
- For example, in this service layer and this data access layer, it simplifies transaction handling, at GO SDK level.
func (s *userService) Create(
ctx context.Context,
user *User) (int64, error) {
tx, err := s.db.Begin()
if err != nil {
return -1, nil
}
ctx = context.WithValue(ctx, "tx", tx)
res, err := s.repository.Create(ctx, user)
if err != nil {
er := tx.Rollback()
if er != nil {
return -1, er
}
return -1, err
}
err = tx.Commit()
return res, err
} |
func (s *userService) Create(
ctx context.Context,
user *User) (int64, error) {
ctx, tx, err := q.Begin(ctx, s.db)
if err != nil {
return -1, err
}
res, err := s.repository.Create(ctx, user)
return q.End(tx, res, err)
} |
- In another example, in this service layer and this data access layer, it simplifies transaction handling, at GO SDK level.
func (s *userService) Create(
ctx context.Context,
user *User) (int64, error) {
tx, err := s.db.Begin()
if err != nil {
return -1, nil
}
ctx = context.WithValue(ctx, "tx", tx)
res, err := s.repository.Create(ctx, user)
if err != nil {
er := tx.Rollback()
if er != nil {
return -1, er
}
return -1, err
}
err = tx.Commit()
return res, err
} |
func (s *UserUseCase) Create(
ctx context.Context, user *model.User) (int64, error) {
return tx.Execute(ctx, s.db, func(ctx context.Context) (int64, error) {
return s.repository.Create(ctx, user)
})
} |
- Utilities to simplify common database operations: the sample is at go-sql-sample.
- The sample of generic CRUD repository is at go-sql-generic-sample.
- The composite key sample is at go-sql-composite-key.
- The sample of dynamic query builder is at user
- The sample of Mybatis for GO is at go-admin. Mybatis file is at query.xml.
- The sample of export data is at go-sql-export.
- The sample of import data is at go-sql-import.
Please make sure to initialize a Go module before installing core-go/sql:
go get -u github.com/core-go/sql
Import:
import "github.com/core-go/sql"