golang sql.DB

数据库

sql.DB连接池需知：

• sql.DB内置连接池，连接不足时会自动创建新连接，新创建的连接使用 sql.Open() 时传入的dsn来构造。
• sql.DB Close 时只会关闭连接池中的连接，未归还的连接将会在归还时直接关闭。
• 归还连接时，不会将 bad connections 放回连接池，会直接关闭。
• sql.DB的 Query/Exec/Ping/Prepare/Begin 操作会从连接池取一条连接或者直接创建新的连接，然后在新连接上操作。
• sql.DB的 Query/Exec/Ping/Prepare/Begin 等操作取连接时遇到 bad connections 最多尝试2次，若依然报 bad connections 错则直接创建新连接。
• sql.DB即使使用 USE dbname 切换了库，但是Query和Exec等操作会从连接池取(不确定取出的连接连向哪个db)或创建连接(连哪个db或者不连db依据dsn)。
• Query 占有的连接，在 Rows.Next() 遍历完成或 Rows.Close() 调用后释放。
• QueryRow 占有的连接，在 Row.Scan() 调用后释放。
• Begin 开启事务后Tx占有的连接，在 Tx.Commit() 或 Tx.Rollback() 后释放。
• Exec/Ping/Prepare 都是执行完直接释放连接
• sql.Conn和sql.Tx的 Query/Exec/Ping/Prepare 都是在当前连接上执行操作，不会另获取新连接。
• 同一个sql.Conn/sql.Tx的 Query 和 Exec 不要一个操作未完成就执行另一个操作，否则容易报错(busy buffer)

SetMaxOpenConns()

默认无限制
设置最大打开的连接数，若到达则会阻塞操作，直到其他连接释放。

SetConnMaxLifetime()

默认为2
设置连接池最大闲置连接数，若到达则归还的连接会直接关闭。

SetConnMaxLifetime()

如果小于0，则永不过期
闲置连接的最大生命周期，应小于数据库连接的超时时间。
从连接创建时计时或连接池取连接时重新计时，连接只有在连接池中超时才会被清理掉。

Conn()

从连接池取出或者创建一个连接返回。在返回的sql.Conn上 Ping,Exec,Query,QueryRow,Begin 都是在当前连接上操作。

注意：
sql.Conn连接关闭，会阻塞等连接上的事务完成，直到Tx.Commit()或者Tx.Rollback()。