Go语言库系列之dotsql详解

更新时间：2020年04月03日 09:19:38 作者：平也

这篇文章主要介绍了Go语言库系列之dotsql的相关知识，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下

导读：能单独拎出SQL文件的某一行或几行执行，是不是非常有趣？今天我们来介绍一下这个有意思的库--dotsql。

背景介绍

dotsql不是ORM，也不是SQL查询语句的构建器，而是可以在一个SQL文件中拎出某几行来执行的工具，非常类似于ini配置文件的读取。如果还不理解，我们来看如下内容。

-- name: create-users-table
CREATE TABLE users (
 id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,
 name VARCHAR(255),
 email VARCHAR(255)
);

-- name: create-user
INSERT INTO users (name, email) VALUES(?, ?)

-- name: find-users-by-email
SELECT id,name,email FROM users WHERE email = ?

-- name: find-one-user-by-email
SELECT id,name,email FROM users WHERE email = ? LIMIT 1

-- name: drop-users-table
DROP TABLE users

上面是SQL文件中定义的语句，我们可以很清晰地看出，每条语句上方都以 -- name 的方式打上了“注解”，而作为开发人员，可以根据打了标记的名称挑选语句执行。

快速上手
准备工作

目录结构概览

├── data.sql
├── go.mod
├── go.sum
└── main.go

初始化项目

go mod init dotsql

创建data.sql文件，键入如下SQL，只是示例，内容可以自定义。

-- name: create-users-table
DROP TABLE IF EXISTS users;
CREATE TABLE users (
 id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,
 name VARCHAR(255),
 email VARCHAR(255)
);

-- name: create-user
INSERT INTO users (name, email) VALUES(?, ?)

-- name: find-users-by-email
SELECT id,name,email FROM users WHERE email = ?

-- name: find-one-user-by-email
SELECT id,name,email FROM users WHERE email = ? LIMIT 1

--name: drop-users-table
DROP TABLE users

为了方便，我们用sqlite来演示，并存储在内存当中，所以要先安装sqlite驱动

go get github.com/mattn/go-sqlite3

代码演示

现在来写代码，导入go-sqlite3库

import _ "github.com/mattn/go-sqlite3"

获取sqlite3的数据库句柄

db, _ := sql.Open("sqlite3", ":memory:")

加载data.sql文件

dot, _ := dotsql.LoadFromFile("data.sql")

挑选文件中的一个标签来执行，Exec方法的第一个参数需要传入句柄

dot.Exec(db, "create-users-table")

从注释可以找到对应的语句，是一个创建表的操作

-- name: create-users-table
DROP TABLE IF EXISTS users;
CREATE TABLE users (
 id INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL,
 name VARCHAR(255),
 email VARCHAR(255)
);

再来执行第二条语句，插入表数据

dot.Exec(db, "create-user", "User Name", "main@example.com")

我们再来尝试查询表数据，这里要注意，目前所有的操作都是基于定义的标签来选择执行的

rows, _ := dot.Query(db, "find-users-by-email", "main@example.com")
 var (
  id int
  name string
  email string
 )
 for rows.Next() {
  rows.Scan(&id, &name, &email)
  fmt.Println(id, name, email)
 }

Query方法返回的是*sql.Rows类型，同学们可以自行遍历取值测试，大功告成！

其他玩法

我们可以先预准备SQL语句，再在合适的时机执行

stmt, err := dot.Prepare(db, "drop-users-table")
result, err := stmt.Exec()

同样，我们也可以将多个SQL文件合并再进行取值操作

dot1, err := dotsql.LoadFromFile("queries1.sql")
dot2, err := dotsql.LoadFromFile("queries2.sql")
dot := dotsql.Merge(dot1, dot2)

总结

到此这篇关于Go语言库系列之dotsql的文章就介绍到这了,更多相关go语言库 dotsql内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Go语言库系列之flag的具体使用

golang代码中调用Linux命令
本文主要介绍了golang代码中调用Linux命令，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-02-02
基于golang中container/list包的用法说明
这篇文章主要介绍了基于golang中container/list包的用法说明，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-04-04
一文教你打造一个简易的Golang日志库
这篇文章主要为大家详细介绍了如何使用不超过130行的代码，通过一系列golang的特性，来打造一个简易的golang日志库，感兴趣的小伙伴可以了解一下
2023-06-06
一文详解Go Http Server原理
这篇文章主要为大家介绍了Go Http Server原理示例详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-01-01
go中的unsafe包及使用详解
Unsafe code是一种绕过go类型安全和内存安全检查的Go代码。这篇文章主要介绍了go中的unsafe包,需要的朋友可以参考下
2019-07-07
Golang 中 omitempty的作用
这篇文章主要介绍了Golang 中 omitempty的作用，文章围绕主题展开详细的内容介绍，具有一定的参考一下，需要的小伙伴可以参考一下
2022-07-07
Golang中 Slice的分析与使用源码解析
这篇文章主要介绍了Golang 中 Slice的分析与使用(含源码),本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-03-03
Go中字符串处理 fmt.Sprintf与string.Builder的区别对比分析
在Go语言中,我们通常会遇到两种主要的方式来处理和操作字符串：使用fmt.Sprintf函数和string.Builder类型,本文给大家介绍它们在性能和用法上有一些关键区别,感兴趣的朋友跟随小编一起看看吧
2023-11-11
Go语言nil标识符(空值/零值)
本文主要介绍了Go语言nil标识符(空值/零值)，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-03-03
浅析Go语言中内存泄漏的原因与解决方法
这篇文章主要来和大家聊一聊Go语言中内存泄漏的那些事,例如内存泄漏的原因与解决方法,文中的示例代码讲解详细,需要的小伙伴可以参考下
2024-02-02