Go的dotsql是什么

這篇文章主要介紹“Go的dotsql是什么”，在日常操作中，相信很多人在Go的dotsql是什么問題上存在疑惑，小編查閱了各式資料，整理出簡單好用的操作方法，希望對大家解答”Go的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是什么”的學習就結束了，希望能夠解決大家的疑惑。理論與實踐的搭配能更好的幫助大家學習，快去試試吧！若想繼續學習更多相關知識，請繼續關注億速云網站，小編會繼續努力為大家帶來更多實用的文章！