• Golang操作数据库简单示例


    准备工作

    在开始之前,你需要确保自己安装了Golang的编程环境,安装MySQL数据库,有一个可以用于编写代码的编辑器或IDE工具。我在这里使用的编辑器是Fleet

    准备数据

    将下面的SQL语句在MySQL中执行,创建数据库并插入数据.。

    drop table if exists album;
    create table album (
        id int auto_increment not null,
        title varchar(128) not null,
        artist varchar(255) not null,
        price decimal(5,2) not null,
        primary key (`id`)
    );
    insert into album
        (title, artist, price)
    values
        ('Blue Train', 'John Coltrane', 56.99),
        ('Giant Steps', 'Greey Mulligan', 63.99),
        ('Jeru', 'Gerry Mulligan', 17.99),
        ('Sarah Vaughan', 'Sarah Vaughan', 34.98);
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15

    创建项目

    进入终端,输入以下命令。(当然,你也可以手动创建)

    mkdir data-access
    cd ./data-access
    go mod init example/data-access
    
    • 1
    • 2
    • 3

    在上面创建的目录下创建文件main.go,将以下代码粘贴到文件中。

    package main
    
    import (
    	"database/sql"
    	"errors"
    	"fmt"
    	"github.com/go-sql-driver/mysql"
    	"log"
    )
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9

    终端输入以下命令下载上面代码中引入的MySQL的驱动包

    go mod tidy
    
    • 1

    连接数据库

    在main.go中输入以下代码,连接数据库。

    var db *sql.DB
    
    func main() {
    	// 设置连接属性
    	cfg := mysql.Config{
    		User:   "root",
    		Passwd: "123456",
    		Net:    "tcp",
    		Addr:   "127.0.0.1:3306",
    		DBName: "recordings",
    	}
    
    	// 获取数据库句柄
    	var err error
    	db, err = sql.Open("mysql", cfg.FormatDSN())
    	if err != nil {
    		log.Fatal(err)
    	}
    
    	// 测试是否连接成功
    	pingErr := db.Ping()
    	if pingErr != nil {
    		log.Fatal(pingErr)
    	}
    	log.Println("Connected!")
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26

    查询数据

    对于数据库中的数据,我们需要定义一个结构体去接收。在main.go中输入以下代码。

    // Album 记录实体结构体
    type Album struct {
    	ID     int64
    	Title  string
    	Artist string
    	Price  float32
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7

    接着我们实现String函数让输出稍微美观一些。

    func (album Album) String() string {
    	return fmt.Sprintf(`{ "id": %d, "title": %q, "artist": %q, "price": %.2f }`, album.ID, album.Title, album.Artist, album.Price)
    }
    
    • 1
    • 2
    • 3

    接下来,让我们编写一个函数,这个函数的功能是通过人名去查询数据库中的记录。

    // 通过人名查询记录
    func albumsByArtist(name string) ([]Album, error) {
    	var albums []Album
    
    	rows, err := db.Query("select * from album where artist = ?", name)
    	if err != nil {
    		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    	}
    	// 资源释放,defer关键字修饰的语句在其下方语句未执行完成前不会执行
    	defer rows.Close()
    
    	// 循环获取相关值
    	for rows.Next() {
    		var alb Album
    		if err := rows.Scan(&alb.ID, &alb.Title, &alb.Artist, &alb.Price); err != nil {
    			return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    		}
    		albums = append(albums, alb)
    	}
    	if err := rows.Err(); err != nil {
    		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    	}
    	return albums, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24

    接着定义一个函数,通过id去查询记录。

    // 通过ID查询记录
    func albumsById(id int64) (Album, error) {
    	var alb Album
    
    	row := db.QueryRow("select * from album where id = ?", id)
    	if err := row.Scan(&alb.ID, &alb.Title, &alb.Artist, &alb.Price); err != nil {
    		if errors.Is(err, sql.ErrNoRows) {
    			return alb, fmt.Errorf("albumsById %d: no such album", id)
    		}
    		return alb, fmt.Errorf("albumsById %d: %v", id, err)
    	}
    	return alb, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    然后,我们在main函数中调用。

    // 查询数据
    albums, err := albumsByArtist("John Coltrane")
    if err != nil {
    	log.Fatal(err)
    }
    log.Printf("Albums found: %v\n", albums)
    
    alb, err := albumsById(2)
    if err != nil {
    	log.Fatal(err)
    }
    log.Printf("Album found: %v\n", alb)
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12

    修改数据

    我们来定义一个函数用来修改数据,用id做为删选条件。

    // 修改数据
    func updateAlbumById(alb Album) (int64, error) {
    	result, err := db.Exec("update album set title = ?, artist = ?, price = ? where id = ?", alb.Title, alb.Artist, alb.Price, alb.ID)
    	if err != nil {
    		return 0, fmt.Errorf("updateAlbumById: %v", err)
    	}
    
    	rows, err := result.RowsAffected()
    	if err != nil {
    		return 0, fmt.Errorf("updateAlbumById: %v", err)
    	}
    	return rows, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    在main函数中调用它。

    // 修改数据
    updateRows, err := updateAlbumById(Album{
    	ID: 1,
    	Title: "White teddy bear",
    	Artist: "John Thompson's",
    	Price: 20.99,
    })
    if err != nil {
    	log.Fatal(err)
    }
    log.Printf("Number of rows updated: %v\n", updateRows)
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11

    插入数据

    定义一个函数用来插入数据并且返回插入数据在数据库中的id。

    // 插入记录
    func addAlbum(alb Album) (int64, error) {
    	result, err := db.Exec("insert into album (title, artist, price) values (?, ?, ?)", alb.Title, alb.Artist, alb.Price)
    	if err != nil {
    		return 0, fmt.Errorf("addAlbum: %v", err)
    	}
    	
    	id, err := result.LastInsertId()
    	if err != nil {
    		return 0, fmt.Errorf("addAlbum: %v", err)
    	}
    	return id, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    在main函数中调用

    // 插入数据
    albId, err := addAlbum(Album{
    	Title: "The Modern Sound of Betty Carter",
    	Artist: "Betty Carter",
    	Price: 49.99,
    })
    if err != nil {
    	log.Fatal(err)
    }
    log.Printf("id of added alnum: %v\n", albId)
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10

    删除数据

    定义一个函数用来删除数据。

    // 删除记录,返回删除的行数
    func deleteAlbum(id int64) (int64, error) {
    	result, err := db.Exec("delete from album where id = ?", id)
    	if err != nil {
    		return 0, fmt.Errorf("deleteAlbum: %v", err)
    	}
    	
    	rows, err := result.RowsAffected()
    	if err != nil {
    		return 0, fmt.Errorf("deleteAlbum: %v", err)
    	}
    	return rows, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13

    在main函数中调用

    // 删除数据
    deleteRows, err := deleteAlbum(albId)
    if err != nil {
    	log.Fatal(err)
    }
    log.Printf("Number of rows deleted: %v\n", deleteRows)
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6

    释放资源

    对于数据库的操作完成后,需要释放数据库连接,在main函数中输入以下代码释放资源。

    // 释放资源
    err = db.Close()
    if err != nil {
    	log.Fatal(err)
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5

    完整代码

    完整代码如下。

    package main
    
    import (
    	"database/sql"
    	"errors"
    	"fmt"
    	"github.com/go-sql-driver/mysql"
    	"log"
    )
    
    var db *sql.DB
    
    // Album 记录实体结构体
    type Album struct {
    	ID     int64
    	Title  string
    	Artist string
    	Price  float32
    }
    
    func (album Album) String() string {
    	return fmt.Sprintf(`{ "id": %d, "title": %q, "artist": %q, "price": %.2f }`, album.ID, album.Title, album.Artist, album.Price)
    }
    
    func main() {
    	// 设置连接属性
    	cfg := mysql.Config{
    		User:   "root",
    		Passwd: "123456",
    		Net:    "tcp",
    		Addr:   "127.0.0.1:3306",
    		DBName: "recordings",
    	}
    
    	// 获取数据库句柄
    	var err error
    	db, err = sql.Open("mysql", cfg.FormatDSN())
    	if err != nil {
    		log.Fatal(err)
    	}
    
    	// 测试是否连接成功
    	pingErr := db.Ping()
    	if pingErr != nil {
    		log.Fatal(pingErr)
    	}
    	log.Println("Connected!")
    
    	// 查询数据
    	albums, err := albumsByArtist("John Coltrane")
    	if err != nil {
    		log.Fatal(err)
    	}
    	log.Printf("Albums found: %v\n", albums)
    
    	alb, err := albumsById(2)
    	if err != nil {
    		log.Fatal(err)
    	}
    	log.Printf("Album found: %v\n", alb)
    	
    	// 修改数据
    	updateRows, err := updateAlbumById(Album{
    		ID: 1,
    		Title: "White teddy bear",
    		Artist: "John Thompson's",
    		Price: 20.99,
    	})
    	if err != nil {
    		log.Fatal(err)
    	}
    	log.Printf("Number of rows updated: %v\n", updateRows)
    	
    	// 插入数据
    	albId, err := addAlbum(Album{
    		Title: "The Modern Sound of Betty Carter",
    		Artist: "Betty Carter",
    		Price: 49.99,
    	})
    	if err != nil {
    		log.Fatal(err)
    	}
    	log.Printf("id of added alnum: %v\n", albId)
    	
    	// 删除数据
    	deleteRows, err := deleteAlbum(albId)
    	if err != nil {
    		log.Fatal(err)
    	}
    	log.Printf("Number of rows deleted: %v\n", deleteRows)
    	
    	// 释放资源
    	err = db.Close()
    	if err != nil {
    		log.Fatal(err)
    	}
    }
    
    // 通过人名查询记录
    func albumsByArtist(name string) ([]Album, error) {
    	var albums []Album
    
    	rows, err := db.Query("select * from album where artist = ?", name)
    	if err != nil {
    		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    	}
    	// 资源释放,defer关键字修饰的语句在其下方语句未执行完成前不会执行
    	defer rows.Close()
    
    	// 循环获取相关值
    	for rows.Next() {
    		var alb Album
    		if err := rows.Scan(&alb.ID, &alb.Title, &alb.Artist, &alb.Price); err != nil {
    			return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    		}
    		
    		albums = append(albums, alb)
    	}
    	if err := rows.Err(); err != nil {
    		return nil, fmt.Errorf("albumsByArtist %q: %v", name, err)
    	}
    	return albums, nil
    }
    
    // 通过ID查询记录
    func albumsById(id int64) (Album, error) {
    	var alb Album
    
    	row := db.QueryRow("select * from album where id = ?", id)
    	if err := row.Scan(&alb.ID, &alb.Title, &alb.Artist, &alb.Price); err != nil {
    		if errors.Is(err, sql.ErrNoRows) {
    			return alb, fmt.Errorf("albumsById %d: no such album", id)
    		}
    		return alb, fmt.Errorf("albumsById %d: %v", id, err)
    	}
    	return alb, nil
    }
    
    // 修改数据
    func updateAlbumById(alb Album) (int64, error) {
    	result, err := db.Exec("update album set title = ?, artist = ?, price = ? where id = ?", alb.Title, alb.Artist, alb.Price, alb.ID)
    	if err != nil {
    		return 0, fmt.Errorf("updateAlbumById: %v", err)
    	}
    
    	rows, err := result.RowsAffected()
    	if err != nil {
    		return 0, fmt.Errorf("updateAlbumById: %v", err)
    	}
    	return rows, nil
    }
    
    // 插入记录
    func addAlbum(alb Album) (int64, error) {
    	result, err := db.Exec("insert into album (title, artist, price) values (?, ?, ?)", alb.Title, alb.Artist, alb.Price)
    	if err != nil {
    		return 0, fmt.Errorf("addAlbum: %v", err)
    	}
    	
    	id, err := result.LastInsertId()
    	if err != nil {
    		return 0, fmt.Errorf("addAlbum: %v", err)
    	}
    	return id, nil
    }
    
    // 删除记录,返回删除的行数
    func deleteAlbum(id int64) (int64, error) {
    	result, err := db.Exec("delete from album where id = ?", id)
    	if err != nil {
    		return 0, fmt.Errorf("deleteAlbum: %v", err)
    	}
    	
    	rows, err := result.RowsAffected()
    	if err != nil {
    		return 0, fmt.Errorf("deleteAlbum: %v", err)
    	}
    	return rows, nil
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56
    • 57
    • 58
    • 59
    • 60
    • 61
    • 62
    • 63
    • 64
    • 65
    • 66
    • 67
    • 68
    • 69
    • 70
    • 71
    • 72
    • 73
    • 74
    • 75
    • 76
    • 77
    • 78
    • 79
    • 80
    • 81
    • 82
    • 83
    • 84
    • 85
    • 86
    • 87
    • 88
    • 89
    • 90
    • 91
    • 92
    • 93
    • 94
    • 95
    • 96
    • 97
    • 98
    • 99
    • 100
    • 101
    • 102
    • 103
    • 104
    • 105
    • 106
    • 107
    • 108
    • 109
    • 110
    • 111
    • 112
    • 113
    • 114
    • 115
    • 116
    • 117
    • 118
    • 119
    • 120
    • 121
    • 122
    • 123
    • 124
    • 125
    • 126
    • 127
    • 128
    • 129
    • 130
    • 131
    • 132
    • 133
    • 134
    • 135
    • 136
    • 137
    • 138
    • 139
    • 140
    • 141
    • 142
    • 143
    • 144
    • 145
    • 146
    • 147
    • 148
    • 149
    • 150
    • 151
    • 152
    • 153
    • 154
    • 155
    • 156
    • 157
    • 158
    • 159
    • 160
    • 161
    • 162
    • 163
    • 164
    • 165
    • 166
    • 167
    • 168
    • 169
    • 170
    • 171
    • 172
    • 173
    • 174
    • 175
    • 176
    • 177
    • 178
    • 179

    最终执行结果

    在这里插入图片描述

  • 相关阅读:
    数据结构每日亿题(四)
    SpringMVC 程序开发
    京东腰带怎么设置,分享详细教程
    oracle 更新和删除数据
    前端Canvas入门——怎么用Canvas画一些简单的图案
    加密原生消费产品的未来:Web3 数字身份如何发挥实际作用
    ARM TrustZone白皮书部分阅读
    内存函数 memcpy,memmove ,memcmp
    Swift之深入解析子数组提取的性能优化
    SpringBoot+Vue开发记录(四)
  • 原文地址:https://blog.csdn.net/weixin_45014413/article/details/133882392