bingyi/gf

mirror of https://gitee.com/johng/gf synced 2026-06-06 16:21:40 +08:00

Files

tiger1103 ea956189bf feat(contrib/drivers/dm): add WherePri support (#4157 )

The Dameng database supports the wherepri method.
eg: `dao.User.Ctx(ctx).WherePri(id)`

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: John Guo <claymore1986@gmail.com>
Co-authored-by: hailaz <739476267@qq.com>

2025-12-03 17:52:05 +08:00

clickhouse

refactor(contrib/clickhouse): optimization clickhouse (#4499 )

2025-11-19 16:03:07 +08:00

feat(contrib/drivers/dm): add WherePri support (#4157 )

2025-12-03 17:52:05 +08:00

mssql

fix: v2.9.5 (#4503 )

2025-11-10 21:40:35 +08:00

mysql

fix(database/gdb): Resolve column ambiguity in GROUP BY/ORDER BY with MySQL JOIN (#4521 )

2025-11-24 15:57:20 +08:00

oracle

fix: v2.9.5 (#4503 )

2025-11-10 21:40:35 +08:00

pgsql

fix(contrib/drivers/pgsql): Fixed the problem of overlapping fields in the same table name in pgsql multiple schema mode (#4375 )

2025-11-19 18:03:52 +08:00

sqlite

fix: v2.9.5 (#4503 )

2025-11-10 21:40:35 +08:00

sqlitecgo

fix: v2.9.5 (#4503 )

2025-11-10 21:40:35 +08:00

README.MD

docs: update Chinese documentation and add README.zh_CN.MD (#4534 )

2025-12-01 09:35:06 +08:00

README.zh_CN.MD

docs: update Chinese documentation and add README.zh_CN.MD (#4534 )

2025-12-01 09:35:06 +08:00

README.MD

English | 简体中文

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 to copy
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/mssql/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

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/MariaDB/TiDB

import _ "github.com/gogf/gf/contrib/drivers/mysql/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"

Note:

It does not support Replace features.

SQL Server

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

Note:

It does not support Replace features.
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 Replace features.
It does not support LastInsertId.

ClickHouse

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

Note:

It does not support InsertIgnore/InsertGetId 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:

It does not support Replace features.

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.