推荐使用配置文件及单例对象来管理和使用数据库操作。
...
...
数据库配置管理功能使用的是配置管理模块实现，因此同样支持多种数据格式如：toml, yaml, json, xml。默认并且推荐的配置文件数据格式为toml。
完整配置
完整的config.toml数据库配置项的数据格式形如下：
...
...
...
...
...
...
...
...
...
...
...
...
...
完整的数据库配置项示例(TOML)：
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
篇幅有限，这里仅展示了推荐的
toml格式的文件示例格式，其他配置文件的数据格式请自行研究。
简化配置(推荐)
为兼容不同的数据库类型，gdb将数据库的各个字段拆分出来单独配置，这样对于各种数据库的对接来说兼容性会很好。但是对于开发者来说看起来配置比较多。针对于项目中使用的已确定的数据库类型的配置，我们可以使用linkinfo属性（名称也可以简化为link）进行配置。如：
...
...
...
...
...
...
...
...
...
...
也可以简化为：
...
...
...
...
...
...
...
...
注意以上每一项分组配置均可以是多个节点，支持负载均衡权重策略。如果不使用多节点负载均衡特性，仅使用配置分组特性，也可以简化为如下格式：
...
...
...
...
...
...
...
...
...
...
如果仅仅是单数据库节点，不使用配置分组特性，那么也可以简化为如下格式：
[database]
link = "mysql:root:12345678@tcp(127.0.0.1:3306)/test"
不同数据类型对应的linkinfo如下:
| 数据库类型 | Linkinfo配置 | 更多参数 |
|---|---|---|
| mysql | mysql: 账号:密码@tcp(地址:端口)/数据库名称 | mysql |
| pgsql | pgsql: user=账号 password=密码 host=地址 port=端口 dbname=数据库名称 | pq |
| mssql | mssql: user id=账号;password=密码;server=地址;port=端口;database=数据库名称;encrypt=disable | go-mssqldb |
| sqlite | sqlite: 文件绝对路径 (如: /var/lib/db.sqlite3) | go-sqlite3 |
| oracle | oracle: 账号/密码@地址:端口/数据库名称 | go-oci8 |
各数据库类型更详细的linkinfo参数信息请查看对应引擎官网，参考【ORM数据库类型】章节
日志输出配置
gdb支持日志输出，内部使用的是glog.Logger对象实现日志管理，并且可以通过配置文件对日志对象进行配置。默认情况下gdb关闭了DEBUG日志输出，如果需要打开DEBUG信息需要将数据库的debug参数设置为true。以下是为一个配置文件示例：
...
...
...
...
其中database.logger即为gdb的日志配置，当该配置不存在时，将会使用日志组件的默认配置，具体请参考【日志管理】章节。
原生配置(高阶，可选)
以下为数据库底层管理配置介绍，如果您对数据库的底层配置管理比较感兴趣，可继续阅读后续章节。
数据结构
gdb数据库管理模块的内部配置管理数据结构如下：
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
ConfigNode用于存储一个数据库节点信息；ConfigGroup用于管理多个数据库节点组成的配置分组(一般一个分组对应一个业务数据库集群)；Config用于管理多个ConfigGroup配置分组。
配置管理特点：
- 支持多节点数据库集群管理；
- 每个节点可以单独配置连接属性；
- 采用单例模式管理数据库实例化对象；
- 支持对数据库集群分组管理，按照分组名称获取实例化的数据库操作对象；
- 支持多种关系型数据库管理，可通过
ConfigNode.Type属性进行配置； - 支持
Master-Slave读写分离，可通过ConfigNode.Role属性进行配置； - 支持客户端的负载均衡管理，可通过
ConfigNode.Priority属性进行配置，值越大，优先级越高；
特别说明，gdb的配置管理最大的特点是，(同一进程中)所有的数据库集群信息都使用同一个配置管理模块进行统一维护，不同业务的数据库集群配置使用不同的分组名称进行配置和获取。
配置方法
这是原生调用gdb模块来配置管理数据库。如果开发者想要自行控制数据库配置管理可以参考以下方法。若无需要可忽略该章节。
接口文档： https://godoc.org/github.com/gogf/gf/database/gdb
// 添加一个数据库节点到指定的分组中
func AddConfigNode(group string, node ConfigNode)
// 添加一个配置分组到数据库配置管理中(同名覆盖)
func AddConfigGroup(group string, nodes ConfigGroup)
// 添加一个数据库节点到默认的分组中(默认为default，可修改)
func AddDefaultConfigNode(node ConfigNode)
// 添加一个配置分组到数据库配置管理中(默认分组为default，可修改)
func AddDefaultConfigGroup(nodes ConfigGroup)
// 设置默认的分组名称，获取默认数据库对象时将会自动读取该分组配置
func SetDefaultGroup(groupName string)
// 设置数据库配置为定义的配置信息，会将原有配置覆盖
func SetConfig(c Config)
默认分组表示，如果获取数据库对象时不指定配置分组名称，那么gdb默认读取的配置分组。例如：gdb.New()可获取一个默认分组的数据库对象。
简单的做法，我们可以通过gdb包的SetConfig配置管理方法进行自定义的数据库全局配置，例如：
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...