Go SDK 快速上手#

需求:

  • OpenMLDB 版本 >= 0.7.0

  • 需要运行 API server 组件

1. 安装 Go SDK 包#

go get github.com/4paradigm/OpenMLDB/go

2. 使用 Go SDK#

2.1 连接 OpenMLDB#

Go SDK 需要连接到 API server.

db, err := sql.Open("openmldb", "openmldb://127.0.0.1:8080/test_db")

数据源 (DSN) 的格式为:

openmldb://API_SERVER_HOST[:API_SERVER_PORT]/DB_NAME

必须要连接到一个已经存在的数据库.

2.2 创建表#

db.ExecContext(ctx, "CREATE TABLE demo(c1 int, c2 string);")

2.3 插入数据#

db.ExecContext(ctx, `INSERT INTO demo VALUES (1, "bb"), (2, "bb");`)

2.4 查询#

rows, err := db.QueryContext(ctx, `SELECT c1, c2 FROM demo;`)
if err != nil{
  panic(err)
}

var col1 int
var col2 string

for rows.Next() {
  if err := rows.Scan(&col1, &col2); err != nil {
    panic(err)
  }
  // process row ...
}

3. 完整示例#

package main

import (
	"context"
	"database/sql"

	// 加载 OpenMLDB SDK
	_ "github.com/4paradigm/OpenMLDB/go"
)

func main() {
	db, err := sql.Open("openmldb", "openmldb://127.0.0.1:8080/test_db")
  if err != nil {
    panic(err)
  }

  defer db.Close()

  ctx := context.Background()

  if _, err := db.ExecContext(ctx, `CREATE TABLE demo (c1 int, c2 string);`); err != nil {
    panic(err)
  }

  if _, err := db.ExecContext(ctx, `INSERT INTO demo VALUES (1, "bb"), (2, "bb");`); err != nil {
    panic(err)
  }

  rows, err := db.QueryContext(ctx, `SELECT c1, c2 FROM demo;`)
  if err != nil{
    panic(err)
  }

  var col1 int
  var col2 string

  for rows.Next() {
    if err := rows.Scan(&col1, &col2); err != nil {
      panic(err)
    }
    println(col1, col2)
  }
}