本文旨在为 Go 语言开发者提供一份关于 SQLite3 数据库连接与操作的实用指南。我们将介绍如何选择合适的 SQLite3 驱动库，并提供简单的 INSERT 和 SELECT 操作示例代码，帮助你快速上手在 Go 项目中使用 SQLite3。
选择合适的 SQLite3 驱动库
在 Go 语言中操作 SQLite3 数据库，你需要选择一个合适的驱动库。目前，github.com/mattn/go-sqlite3 是一个比较流行的选择。它具有以下优点：
- 维护活跃： 社区维护相对活跃，能够及时修复 bug 和更新。
- 易于使用： 提供了简洁易懂的 API，方便开发者进行数据库操作。
- 兼容性好： 兼容 SQLite3 数据库的各种版本。
安装 go-sqlite3 驱动
使用 go get 命令安装 github.com/mattn/go-sqlite3 驱动：
go get github.com/mattn/go-sqlite3
安装过程中可能会出现警告，例如：
sqlite3.go: In function ‘_cgo_7e09c699097a_Cfunc_sqlite3_prepare_v2’: sqlite3.go:198:2: warning: passing argument 5 of ‘sqlite3_prepare_v2’ from incompatible pointer type [enabled by default] /usr/local/include/sqlite3.h:2924:16: note: expected ‘const char **’ but argument is of type ‘char **’
这些警告通常可以忽略，不会影响驱动的正常使用。
示例代码：INSERT 和 SELECT 操作
以下示例代码演示了如何使用 github.com/mattn/go-sqlite3 驱动进行简单的 INSERT 和 SELECT 操作。
package main
import (
"database/sql"
"fmt"
"log"
_ "github.com/mattn/go-sqlite3" // 导入 SQLite3 驱动
)
func main() {
// 1. 连接数据库
db, err := sql.Open("sqlite3", "test.db") // test.db 是数据库文件名
if err != nil {
log.Fatal(err)
}
defer db.Close()
// 2. 创建表 (如果不存在)
_, err = db.Exec(`
CREATE TABLE IF NOT EXISTS users (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
age INTEGER
);
`)
if err != nil {
log.Fatal(err)
}
// 3. INSERT 操作
stmt, err := db.Prepare("INSERT INTO users(name, age) values(?,?)")
if err != nil {
log.Fatal(err)
}
defer stmt.Close()
_, err = stmt.Exec("Alice", 30)
if err != nil {
log.Fatal(err)
}
_, err = stmt.Exec("Bob", 25)
if err != nil {
log.Fatal(err)
}
fmt.Println("Insert data success!")
// 4. SELECT 操作
rows, err := db.Query("SELECT id, name, age FROM users")
if err != nil {
log.Fatal(err)
}
defer rows.Close()
fmt.Println("Users:")
for rows.Next() {
var id int
var name string
var age int
err = rows.Scan(&id, &name, &age)
if err != nil {
log.Fatal(err)
}
fmt.Printf("ID: %d, Name: %s, Age: %d\n", id, name, age)
}
err = rows.Err()
if err != nil {
log.Fatal(err)
}
}代码解释：
- 导入驱动： import _ "github.com/mattn/go-sqlite3" 这行代码导入了 SQLite3 驱动。注意，使用下划线 _ 表示只导入驱动，而不直接使用其中的任何函数或变量。这是 Go 语言中注册数据库驱动的常用方法。
- 连接数据库： sql.Open("sqlite3", "test.db") 函数用于连接 SQLite3 数据库。第一个参数是驱动名称（"sqlite3"），第二个参数是数据库文件名（"test.db"）。如果数据库文件不存在，则会自动创建。
- 创建表： db.Exec() 函数用于执行 SQL 语句。这里创建了一个名为 users 的表，包含 id、name 和 age 三个字段。IF NOT EXISTS 确保只有在表不存在时才创建。
-
INSERT 操作：
- db.Prepare() 函数用于预编译 SQL 语句，提高执行效率。
- stmt.Exec() 函数用于执行预编译的 SQL 语句，并传入参数。
-
SELECT 操作：
- db.Query() 函数用于执行 SELECT 语句，并返回结果集。
- rows.Next() 函数用于遍历结果集中的每一行。
- rows.Scan() 函数用于将当前行的数据扫描到变量中。
注意事项：
- 确保你的系统已经安装了 SQLite3 库。
- 在代码中使用 defer db.Close() 和 defer stmt.Close() 来确保数据库连接和预编译语句在使用完毕后被正确关闭，释放资源。
- 错误处理至关重要。示例代码中使用了 log.Fatal(err) 来处理错误，在实际项目中，你应该根据具体情况进行更细致的错误处理。
总结
通过本文的介绍，你应该能够使用 github.com/mattn/go-sqlite3 驱动在 Go 语言中连接和操作 SQLite3 数据库了。掌握了基本的 INSERT 和 SELECT 操作，你就可以在此基础上构建更复杂的应用程序。记住，选择合适的驱动、正确处理错误、及时释放资源是编写高质量数据库应用程序的关键。
