gf/contrib/drivers/README.zh_CN.MD

数据库驱动程序

用于gdb包的数据库驱动程序。

安装

以 mysql 为例。

go get -u github.com/gogf/gf/contrib/drivers/mysql/v2
# 方便复制
go get -u github.com/gogf/gf/contrib/drivers/clickhouse/v2
go get -u github.com/gogf/gf/contrib/drivers/dm/v2
go get -u github.com/gogf/gf/contrib/drivers/mssql/v2
go get -u github.com/gogf/gf/contrib/drivers/oracle/v2
go get -u github.com/gogf/gf/contrib/drivers/pgsql/v2
go get -u github.com/gogf/gf/contrib/drivers/sqlite/v2
go get -u github.com/gogf/gf/contrib/drivers/sqlitecgo/v2

选择并将驱动程序导入到您的项目中：

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

通常在 main.go 的顶部导入：

package main

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

	// 其他导入的包。
)

func main() {
	// 主要逻辑。
}

支持的驱动程序

MySQL/MariaDB/TiDB

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

SQLite

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

cgo 版本

32位Windows请使用cgo版本

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

PostgreSQL

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

注意：

• 不支持 Replace 功能。

SQL Server

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

注意：

• 不支持 Replace 功能。
• 不支持 LastInsertId。
• 仅支持服务器版本 >= SQL Server2005
• 仅支持 datetime2 和 datetimeoffset 类型来自动处理 created_at/updated_at/deleted_at 列，因为 datetime 类型在将列值作为字符串传递时不支持微秒精度。

Oracle

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

注意：

• 不支持 Replace 功能。
• 不支持 LastInsertId。

ClickHouse

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

注意：

• 不支持 InsertIgnore/InsertGetId 功能。
• 不支持 Save/Replace 功能。
• 不支持 Transaction 功能。
• 不支持 RowsAffected 功能。

DM

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

注意：

• 不支持 Replace 功能。

自定义驱动程序

自定义驱动程序非常快速和简单，您可以参考当前驱动程序的源代码来进行开发。 如果您有关于支持新驱动程序的PR（Pull Request），我们将非常感激地接受您的提交到当前仓库。