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

文档中心

向量数据库VikingDB

请输入

Java SDK

安装与client初始化

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

前提条件

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

安装 SDK

推荐通过 Maven 依赖使用火山引擎 SDK for Java。

<dependency>
    <groupId>com.volcengine</groupId>
    <artifactId>volc-sdk-java</artifactId>
    <version>最新版本</version>
</dependency>

“最新版本”的版本号可以在GitHub 仓库的 README 文件的 “获取与安装” 部分找到，如右图所示。
将版本号代码，直接贴进最新版本即可，比如1.0.206

初始化 SDK

配置安全凭证，根据向量库名、token初始化 client。其中，请求域名（host）支持 http 和 https，根据实际情况配置。

华北域名：api-vikingdb.volces.com
华东域名：api-vikingdb.mlp.cn-shanghai.volces.com
柔佛域名：api-vikingdb.mlp.ap-mya.byteplus.com
如需私网连接，参考VikingDB 私网连接方式进行配置并获取域名。目前私网连接请求域名仅支持http。

地区（region）根据实际情况配置，华北：cn-beijing，华东：cn-shanghai，柔佛：ap-southeast-1。

说明

代码中 Your ak 及 Your sk 需要分别替换为您的 AK 及 SK，Your host、Your region、Your scheme 替换为您使用的域名、地区、请求协议（http / https）。

import com.volcengine.service.vikingDB.Collection;
import com.volcengine.service.vikingDB.Index;
import com.volcengine.service.vikingDB.VikingDBService;
import com.volcengine.service.vikingDB.common.*;

public class test {
 public static void main(String[] args) throws Exception {
 // host中不需要加http或者https等前缀
 // 当scheme字段为http时，host可以填写ip或域名，当scheme字段为https时, host只能填写域名
 //scheme 可选，可选值：http/https，默认http。
 VikingDBService vikingDBService = new VikingDBService("Your host", "Your region", "Your ak", "Your sk", "Your scheme");
 }
}

最近更新时间：2025.09.30 16:06:32

这个页面对您有帮助吗？

有用

无用