这是我参与「第三届青训营 -后端场」笔记创作活动的的第5篇笔记

一、理解database/sql

databse/sql 基本用法，设计原理，基础概念

1.0 基本概念

databse/sql包：golang标准库提供的和数据库交互的包，其理念是对不同的数据库实现提供一套一致的接口给用户使用

DSN：Data Source Name，数据库名称，用于描述与数据连接的关联数据结构

1.1 基本用法

import (
  "database/sql"
  
  _ "github.com/go-sql-driver/mysql"
)

func main() {
    // 使用 driver + DSN 初始化 DB 连接
    db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")
    
    // 执行一条 SQL，通过 rows 取回 返回数据
    rows, err := db.Query("select id, name from users wherer id = ?", 1)
    if err != nil {
        // xxx
    }
    // 处理完毕，释放
    defer rows.Close()
    // jinzhu：上面这句其实有问题, err直接close，可能丢失错误信息
    // jinzhu大佬 更好的写法
    // defer func() {
    //     err = rows.Close()
    // } 
  
    var users []User
    for rows.Next() {
        var userUser
        err := rows.Scan(&user.ID, &user.Name)
        
        if err != nil {
            // ...
        }
        
        users = append(users, user)
    }
    
    // 这个错误处理也很重要
    if rows.Err() != nil {
        // ...
    }
}

连接池

for i := 0 i < maxBadConRetries; i++ {
    dc, err := db.conn(ctx, strategy)
      // 有空闲连接 -> reuse - max life time
      // 新建连接 -> max open...
    
    defer dc.db.putConn(dc, err, true)
      // validateConnction 有无错误
      // max life time, max idle conn 检查
    
    // 连接实现 driver。Queryer, driver.Execer 等 interface
    if err == nil {
        err = dc.ci.Qiery(sql, args...)
    }
    
    isBadConn = errors.Is(err, driver.ErrBadConn)
    if !isBadConn {
        break
    }
}