Golang

Databend 提供了一个用 Golang 编写的驱动程序（databend-go），该驱动程序便于使用 Golang 编程语言开发应用程序并与 Databend 建立连接。

有关安装说明、示例和源代码，请参阅 GitHub 上的 databend-go 仓库。

数据类型映射

下表展示了 Databend 数据类型与其对应的 Go 数据类型的对应关系：

Databend	Go
TINYINT	int8
SMALLINT	int16
INT	int32
BIGINT	int64
TINYINT UNSIGNED	uint8
SMALLINT UNSIGNED	uint16
INT UNSIGNED	uint32
BIGINT UNSIGNED	uint64
Float32	float32
Float64	float64
Bitmap	string
Decimal	decimal.Decimal
String	string
Date	time.Time
DateTime	time.Time
Array(T)	string
Tuple(T1, T2, ...)	string
Variant	string

Databend Go 驱动程序行为总结

Databend Go 驱动程序兼容 "database/sql" 接口规范。以下是一些常见的基础行为，以及涉及的关键函数和原理。

基本行为	关键函数涉及	原理
创建连接	DB.Open	使用 DSN 字符串和 DB.Open 方法建立与 Databend 的连接。 DSN 字符串格式为 https://user:password@host/database?<query_option>=<value>。
执行语句	DB.Exec	DB.Exec 方法通过 v1/query 接口执行 SQL 语句，用于创建、删除表和插入数据。
批量插入	DB.Begin, Tx.Prepare, Stmt.Exec, Tx.Commit	批量插入/替换数据（INSERT INTO 和 REPLACE INTO）通过事务处理。 使用 Stmt.Exec 向预处理语句对象添加尽可能多的数据；数据将被追加到一个文件中。 执行 Tx.Commit() 最终将数据上传到内置 Stage 并执行插入/替换操作，使用 Stage 附件。
查询单行	DB.QueryRow, Row.Scan	使用 DB.QueryRow 方法查询单行数据并返回一个 *sql.Row，然后调用 Row.Scan 将列数据映射到变量。
遍历行	DB.Query, Rows.Next, Rows.Scan	使用 DB.Query 方法查询多行数据并返回一个 *sql.Rows 结构，使用 Rows.Next 方法遍历行，并使用 Rows.Scan 将数据映射到变量。
上传到内部 Stage	APIClient.UploadToStage	上传数据到 Stage。默认情况下，使用 PRESIGN UPLOAD 获取 URL，或者如果 PRESIGN 被禁用，使用 v1/upload_to_stage API。

教程 -1：使用 Golang 与 Databend 集成

在开始之前，请确保您已成功安装本地 Databend。有关详细说明，请参阅 本地和 Docker 部署。

步骤 1. 准备一个 SQL 用户账户

为了使您的程序能够连接到 Databend 并执行 SQL 操作，您必须在代码中提供一个具有适当权限的 SQL 用户账户。如果需要，请在 Databend 中创建一个，并确保该 SQL 用户仅具有必要的权限以确保安全。

本教程以名为 'user1' 且密码为 'abc123' 的 SQL 用户为例。由于程序将向 Databend 写入数据，该用户需要 ALL 权限。有关如何管理 SQL 用户及其权限的详细信息，请参阅 用户与角色。

CREATE USER user1 IDENTIFIED BY 'abc123';
GRANT ALL on *.* TO user1;

步骤 2. 编写一个 Golang 程序

在这一步中，您将创建一个简单的 Golang 程序，该程序与 Databend 通信。该程序将涉及创建表、插入数据和执行数据查询等任务。

1

将以下代码复制并粘贴到 main.go 文件中

备注

• 下面的代码以连接到本地 Databend 并使用名为 'user1' 且密码为 'abc123' 的 SQL 用户为例。您可以根据需要使用自己的值，同时保持相同的格式。
• 代码中 hostname 的值必须与您为 Databend 查询服务设置的 HTTP 处理程序一致。

main.go

package main

import (
	"database/sql"
	"fmt"
	"log"

	_ "github.com/datafuselabs/databend-go"
)

const (
	username = "user1"
	password = "abc123"
	hostname = "127.0.0.1:8000"
)

type Book struct {
	Title  string
	Author string
	Date   string
}

func dsn() string {
	return fmt.Sprintf("http://%s:%s@%s", username, password, hostname)
}

func main() {
	db, err := sql.Open("databend", dsn())

	if err != nil {
		log.Fatal(err)
	}
	defer db.Close()

	err = db.Ping()
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Connected")

	// 如果不存在则创建数据库
	dbSql := "CREATE DATABASE IF NOT EXISTS book_db"
	_, err = db.Exec(dbSql)
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Create database book_db success")

	// 使用 book_db 数据库
	_, err = db.Exec("USE book_db")
	if err != nil {
		log.Fatal(err)
	}

	// 创建表。
	sql := "create table if not exists books(title VARCHAR, author VARCHAR, date VARCHAR)"
	_, err = db.Exec(sql)
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Create table: books")

	// 插入一行。
	_, err = db.Exec("INSERT INTO books VALUES(?, ?, ?)", "mybook", "author", "2022")
	if err != nil {
		log.Fatal(err)
	}
	log.Println("Insert 1 row")

```go
// 选择数据
res, err := db.Query("SELECT * FROM books")
if err != nil {
	log.Fatal(err)
}

for res.Next() {
	var book Book
	err := res.Scan(&book.Title, &book.Author, &book.Date)
	if err != nil {
		log.Fatal(err)
	}

	log.Printf("Select:%v", book)
}
db.Exec("drop table books")
db.Exec("drop database book_db")
}

2

安装依赖

go mod init databend-golang

go.mod

module databend-golang

go 1.20

require github.com/databendcloud/databend-go v0.3.10

require (
	github.com/BurntSushi/toml v1.2.1 // indirect
	github.com/avast/retry-go v3.0.0+incompatible // indirect
	github.com/google/uuid v1.3.0 // indirect
	github.com/pkg/errors v0.9.1 // indirect
	github.com/sirupsen/logrus v1.9.0 // indirect
	golang.org/x/sys v0.5.0 // indirect
)

3

运行程序

go run main.go

输出

2023/02/24 23:57:31 已连接
2023/02/24 23:57:31 创建数据库 book_db 成功
2023/02/24 23:57:31 创建表：books
2023/02/24 23:57:31 插入 1 行
2023/02/24 23:57:31 选择:{mybook author 2022}

教程-2: 使用 Golang 与 Databend Cloud 集成

在开始之前，请确保您已成功创建了一个计算集群并获取了连接信息。具体操作方法请参见 连接到计算集群。

步骤 1. 创建一个 Go 模块

$ mkdir sample
$ cd sample
$ go mod init cloud.databend.com/sample

步骤 2. 安装依赖

$ go get github.com/databendcloud/databend-go

步骤 3. 使用 databend-go 连接

创建一个名为 main.go 的文件，包含以下代码：

package main

import (
	"database/sql"
	"fmt"

	_ "github.com/databendcloud/databend-go"
)

func main() {
	dsn := "databend://{USER}:{PASSWORD}@${HOST}:443/{DATABASE}?&warehouse={WAREHOUSE_NAME}";
	conn, err := sql.Open("databend", dsn)
	if err != nil {
		fmt.Println(err)
	}
	conn.Exec(`DROP TABLE IF EXISTS data`)
	createTable := `CREATE TABLE  IF NOT EXISTS data (
		i64 Int64,
		u64 UInt64,
		f64 Float64,
		s   String,
		s2  String,
		a16 Array(Int16),
		a8  Array(UInt8),
		d   Date,
		t   DateTime)`
	_, err = conn.Exec(createTable)
	if err != nil {
		fmt.Println(err)
	}
	scope, err := conn.Begin()
	batch, err := scope.Prepare(fmt.Sprintf("INSERT INTO %s VALUES", "data"))
	if err != nil {
		fmt.Println(err)
    }
	for i := 0; i < 10; i++ {
		_, err = batch.Exec(
			"1234",
			"2345",
			"3.1415",
			"test",
			"test2",
			"[4, 5, 6]",
			"[1, 2, 3]",
			"2021-01-01",
			"2021-01-01 00:00:00",
		)
	}
	err = scope.Commit()
	if err != nil {
		fmt.Println(err)
	}
}

提示

在代码中替换 {USER}, {PASSWORD}, {HOST}, {WAREHOUSE_NAME} 和 {DATABASE} 为您的连接信息。获取连接信息的方法请参见 连接到计算集群。

步骤 4. 运行 main.go

$ go run main.go