bingyi/gf

mirror of https://gitee.com/johng/gf synced 2026-07-08 22:40:30 +08:00

Files

Jack Ling 030cd84836 test(contrib/drivers/mariadb): add softtime, with, scanlist, union and do tests (#4721 )

## Summary

- Port 48 soft-time tests: soft create/update/delete with
timestamp/datetime/date types, SoftTime switches
(SoftTimeTypeOff/Delete/Timestamp), Unscoped, ForceDelete, joined
queries with soft-delete
- Port 19 With/ScanList tests: With/WithAll for eager loading of
hasOne/hasMany/belongsTo relations, ScanList for manual relation
mapping, nested With
- Port 12 union tests: Union/UnionAll with various parameter forms
(string/Model/subquery), combined with OrderBy, Limit, Where conditions
- Port 12 gdb.Do tests: DoSelect/DoInsert/DoUpdate/DoDelete raw
operation hooks, batch insert, InsertIgnore/InsertGetId/Replace via
DoInsert option

Includes testdata SQL files for With relation table schemas (with_tpl).
Soft-time tests create tables inline via SQL, no separate testdata files
needed.

All tests are structurally identical to the MySQL driver baseline. SQL
syntax is standard and shared. Package and import references are adapted
for MariaDB.

ref #4689

2026-03-12 11:15:42 +08:00

clickhouse

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

gaussdb

test(contrib/drivers/gaussdb): add soft time, with, scanlist test coverage (#4686 )

2026-02-26 09:51:52 +08:00

mariadb

test(contrib/drivers/mariadb): add softtime, with, scanlist, union and do tests (#4721 )

2026-03-12 11:15:42 +08:00

mssql

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

mysql

test(contrib/drivers/mysql): add pagination and error handling tests (#4703 )

2026-02-27 20:00:25 +08:00

oceanbase

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

oracle

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

pgsql

fix(contrib/drivers/pgsql): preserve bytea data integrity on read and write (#4678 )

2026-02-27 16:22:43 +08:00

sqlite

fix(databse/gdb): use COUNT(1) if fields number is greater than 1 even when parameter useFieldForCount is true in AllAndCount/ScanAndCount (#4701 )

2026-02-27 16:12:58 +08:00

sqlitecgo

fix(databse/gdb): use COUNT(1) if fields number is greater than 1 even when parameter useFieldForCount is true in AllAndCount/ScanAndCount (#4701 )

2026-02-27 16:12:58 +08:00

tidb

feat: new version v2.10.0 (#4657 )

2026-01-26 20:37:48 +08:00

README.MD

feat(contrib/drivers): more database drivers (#4553 )

2025-12-09 16:33:55 +08:00

README.MD

Database drivers

Powerful database drivers for package gdb.

Installation

Let's take mysql for example.

go get github.com/gogf/gf/contrib/drivers/mysql/v2@latest

# Easy for copying:
go get github.com/gogf/gf/contrib/drivers/clickhouse/v2@latest
go get github.com/gogf/gf/contrib/drivers/dm/v2@latest
go get github.com/gogf/gf/contrib/drivers/gaussdb/v2@latest
go get github.com/gogf/gf/contrib/drivers/mariadb/v2@latest
go get github.com/gogf/gf/contrib/drivers/mssql/v2@latest
go get github.com/gogf/gf/contrib/drivers/oceanbase/v2@latest
go get github.com/gogf/gf/contrib/drivers/oracle/v2@latest
go get github.com/gogf/gf/contrib/drivers/pgsql/v2@latest
go get github.com/gogf/gf/contrib/drivers/sqlite/v2@latest
go get github.com/gogf/gf/contrib/drivers/sqlitecgo/v2@latest
go get github.com/gogf/gf/contrib/drivers/tidb/v2@latest

Choose and import the driver to your project:

import _ "github.com/gogf/gf/contrib/drivers/mysql/v2"

Commonly imported at top of main.go:

package main

import (
	_ "github.com/gogf/gf/contrib/drivers/mysql/v2"

	// Other imported packages.
)

func main() {
	// Main logics.
}

Supported Drivers

MySQL

import _ "github.com/gogf/gf/contrib/drivers/mysql/v2"

MariaDB

import _ "github.com/gogf/gf/contrib/drivers/mariadb/v2"

TiDB

import _ "github.com/gogf/gf/contrib/drivers/tidb/v2"

OceanBase

import _ "github.com/gogf/gf/contrib/drivers/oceanbase/v2"

GaussDB

import _ "github.com/gogf/gf/contrib/drivers/gaussdb/v2"

SQLite

import _ "github.com/gogf/gf/contrib/drivers/sqlite/v2"

cgo version

When the target is a 32-bit Windows system, the cgo version needs to be used.

import _ "github.com/gogf/gf/contrib/drivers/sqlitecgo/v2"

PostgreSQL

import _ "github.com/gogf/gf/contrib/drivers/pgsql/v2"

SQL Server

import _ "github.com/gogf/gf/contrib/drivers/mssql/v2"

Note:

InsertIgnore returns error if there is no primary key or unique index submitted with record.
It supports server version >= SQL Server2005
It ONLY supports datetime2 and datetimeoffset types for auto handling created_at/updated_at/deleted_at columns, because datetime type does not support microseconds precision when column value is passed as string.

Oracle

import _ "github.com/gogf/gf/contrib/drivers/oracle/v2"

Note:

It does not support LastInsertId.
InsertIgnore returns error if there is no primary key or unique index submitted with record.

ClickHouse

import _ "github.com/gogf/gf/contrib/drivers/clickhouse/v2"

Note:

It does not support InsertIgnore/InsertAndGetId features.
It does not support Save/Replace features.
It does not support Transaction feature.
It does not support RowsAffected feature.

DM

import _ "github.com/gogf/gf/contrib/drivers/dm/v2"

Note:

InsertIgnore returns error if there is no primary key or unique index submitted with record.

Custom Drivers

It's quick and easy, please refer to current driver source. It's quite appreciated if any PR for new drivers support into current repo.