向量数据库 Viking DB 支持通过 Go SDK 操作数据库。在使用 Go SDK 之前，需要先完成安装 SDK 和 初始化 SDK 步骤。

1. 已通过 注册账号及开通服务 操作完成注册账号及开通服务。
2. 获取安全凭证。Access Key（访问密钥）是访问火山引擎服务的安全凭证，包含Access Key ID（简称为AK）和Secret Access Key（简称为SK）两部分。可登录火山引擎控制台并前往【密钥管理】查看当前账号的 AK / SK，更多详情请参考 Access Key（密钥）管理。

为优化权限系统，向量库 SDK分为控制面和数据面，其中控制面为管理数据集、索引、离线任务；数据面为数据、检索和向量化。控制面同时支持从页面操作，请您根据需要配置依赖。

1. 控制面和数据面依赖配置 #

# 数据面SDK
go get -u github.com/volcengine/vikingdb-go-sdk

# 控制面SDK
go get -u github.com/volcengine/volcengine-go-sdk

如需私网连接，参考私网连接方式进行配置并获取域名。目前私网连接请求域名仅支持http。

1. 数据面(Data / Search / Embedding)

package main

import (
    "fmt"
    "github.com/volcengine/vikingdb-go-sdk/vector"
    "os"
    "time"
)

func main() {
    var (
       accessKey = os.Getenv("VIKINGDB_AK")
       secretKey = os.Getenv("VIKINGDB_SK")
       //apiKey    = os.Getenv("VIKINGDB_APIKEY")
       endpoint  = "https://api-vikingdb.vikingdb.cn-beijing.volces.com"
       region    = "cn-beijing"
    )

    client, err := vector.New(
       vector.AuthIAM(accessKey, secretKey), // IAM auth
       // vector.AuthAPIKey(apiKey),            // APIKey auth
       vector.WithEndpoint(endpoint),
       vector.WithRegion(region),
       vector.WithTimeout(time.Second*30),
       vector.WithMaxRetries(3),
    )
    if err != nil {
       fmt.Println("New client failed, err: ", err)
       panic(err)
    }
}

2. 控制面(Collection / Index / Task)

package main

import (
    "fmt"
    "os"

    "github.com/volcengine/volcengine-go-sdk/service/vikingdb"
    "github.com/volcengine/volcengine-go-sdk/volcengine"
    "github.com/volcengine/volcengine-go-sdk/volcengine/credentials"
    "github.com/volcengine/volcengine-go-sdk/volcengine/session"
)

func main() {
    var (
       accessKey = os.Getenv("VIKINGDB_AK")
       secretKey = os.Getenv("VIKINGDB_SK")
       region    = "cn-beijing"
    )
    config := volcengine.NewConfig().
       WithRegion(region).
       WithCredentials(credentials.NewStaticCredentials(accessKey, secretKey, ""))

    sess, err := session.NewSession(config)
    if err != nil {
       panic(err)
    }
    svc := vikingdb.New(sess)

    fmt.Printf("APIVersion: %s\n", svc.APIVersion)
}