golang sql.DB

数据库

sql.DB连接池需知：

• sql.DB内置连接池，连接不足时会自动创建新连接，新创建的连接使用sql.Open()时传入的dsn来构造。
• sql.DBClose时只会关闭连接池中的连接，未归还的连接将会在归还时直接关闭。
• 归还连接时，不会将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()。