安装与client初始化--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

Go SDK

安装与client初始化

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

前提条件

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

安装 SDK

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

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

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

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

初始化 SDK

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

说明

示例代码默认从环境变量 VIKINGDB_AK、VIKINGDB_SK 读取 AK/SK；请将 endpoint、region 替换为您实际使用的域名与地域。
如使用私网连接，请将 endpoint 的协议设置为 http。

数据面(Data / Search / Embedding)

Region 中文名称	Region ID	互联网域名（外网）	私网连接终端节点服务（非域名，请参考私网连接文档）
华北2（北京）	cn-beijing	api-vikingdb.vikingdb.cn-beijing.volces.com	com.volces.privatelink.cn-beijing.vikingdb-ann
华南1（广州）	cn-guangzhou	api-vikingdb.vikingdb.cn-guangzhou.volces.com	com.volces.privatelink.cn-guangzhou.vikingdb-ann
华东2（上海）	cn-shanghai	api-vikingdb.vikingdb.cn-shanghai.volces.com	com.volces.privatelink.cn-shanghai.vikingdb-ann
亚太东南（柔佛）	ap-southeast-1	api-vikingdb.vikingdb.ap-southeast-1.volces.com	火山柔佛region不支持私网访问

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)
    }
}

控制面(Collection / Index / Task)

Region 中文名称	Region ID	互联网域名（外网）	私网连接终端节点服务（非域名，请参考私网连接文档）
华北2（北京）	cn-beijing	vikingdb.cn-beijing.volcengineapi.com	com.volces.privatelink.cn-beijing.api.vikingdb
华南1（广州）	cn-guangzhou	vikingdb.cn-guangzhou.volcengineapi.com	com.volces.privatelink.cn-guangzhou.api.vikingdb
华东2（上海）	cn-shanghai	vikingdb.cn-shanghai.volcengineapi.com	com.volces.privatelink.cn-shanghai.api.vikingdb
亚太东南（柔佛）	ap-southeast-1	vikingdb.ap-southeast-1.volcengineapi.com	com.volces.privatelink.ap-southeast-1.api.vikingdb

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)
}

最近更新时间：2026.04.14 15:03:26

这个页面对您有帮助吗？

有用

无用