CreateVikingIndex--向量数据库VikingDB-火山引擎

文档中心

向量数据库VikingDB

索引(Index)

CreateVikingIndex

CreateVikingIndex 用于为指定的数据集 Collection 创建索引 Index。
创建索引可以加速向量的相似度搜索，它根据指定的索引算法和数据结构将向量库中的原始数据进行分组排序，提高相似度搜索的效率和准确性，是驱动向量数据库在短时间内筛选出候选的核心所在。
对于索引的数据集只存在稠密向量（即 vector 类型字段）的情况，我们称这种索引为纯稠密索引；对于索引的数据集中存在稠密向量和稀疏向量（vector 和 sparse_vector 类型字段）的情况，我们称这种索引为混合索引。

方法定义

Go SDK 通过 vikingdb.New(sess) 创建的客户端实例调用 CreateVikingdbIndex(input) 方法发起索引创建请求，input 参数类型为 vikingdb.CreateVikingdbIndexInput ，包含索引创建所需的完整配置信息

请求参数

请求参数是 CreateIndexParam，CreateIndexParam 类包括的参数如下表所示。

参数	类型	是否必选	参数说明
ProjectName	string	否	项目名称
CollectionName	string	2选1	数据集名称
ResourceId	string	2选1	数据集资源ID。请求必须指定ResourceId和CollectionName其中之一。
IndexName	string	是	指定创建的索引 Index 名称。只能使用英文字母、数字、下划线_，并以英文字母开头，不能为空。长度要求：[1, 128]。索引名称不能重复。同账号下，index 数量不超过200个
Description	string	否	索引的自定义描述。
ScalarIndex	[]string	否	标量字段列表，用于设置需要构建到标量索引的字段。
ShardPolicy	ShardPolicyEnum	否	索引分片类型可选值为ShardType.Auto/ShardType.Custom，auto为自动分片、custom为自定义分片。
ShardCount	int	否	自定义分片数。
CpuQuota	int	否	索引检索消耗的 CPU 配额，格式为正整数。
VectorIndex	VectorIndexForCreateVikingdbIndexInput	是	见下

VectorIndexForCreateVikingdbIndexInput

参数	类型	是否必选	默认值	参数说明
IndexType	IndexTypeEnum 枚举	是	IndexType.HNSW	向量索引类型。取值如下： IndexType.HNSW：全称是 Hierarchical Navigable Small World，一种用于在高维空间中采用 ANN 搜索的数据结构和算法，是基于图的索引。HNSW通过构建多层网络减少搜索过程中需要访问的节点数量，实现快速高效地搜索最近邻，适合对搜索效率要求较高的场景。 IndexType.HNSW_HYBRID：支持混合索引的 hnsw 算法。混合索引算法可以同时对数据集中的稠密向量和稀疏向量进行索引，并在检索时返回兼顾两种类型相似性的结果。适用于对搜索效率要求较高，且需要同时检索稀疏和稠密向量的场景。 HNSW_HYBRID索引的数据集必须包含 sparse_vector类型数据，即定义了sparse_vector类型字段，或绑定了能产生sparse_vector 类型向量的 pipeline。 IndexType.FLAT：暴力索引，搜索时遍历整个向量数据库的所有向量与目标向量进行距离计算和比较，查询速度较慢，但是 flat 能提供100％的检索召回率，适用于向量候选集较少，且需要100％检索召回率的场景。 IndexType.IVF：倒排索引，利用倒排的思想保存每个聚类中心下的向量，每次查询向量的时候找到最近的几个中心，分别搜索这几个中心下的向量，速度较快，但是精度略低，适合中等规模数据量，对搜索效率要求高，精度次之的场景。 IndexType.DISKANN：基于 Vamana 图的磁盘索引算法，将 Vamana 图与 PQ 量化压缩方案结合，构建DiskANN索引。图索引和原始数据存在SSD中，压缩索引放在内存中。检索请求时会将query向量与聚簇中心比较，然后从磁盘读取对应的原始数据进行算分。适用于大规模数据量，性能不是特别敏感，内存成本更低，且召回率较高的场景。
Distance	DistanceEnum枚举	否	DistanceType.IP	距离类型，衡量向量之间距离的算法。取值如下： DistanceType.IP：全称是 Inner Product，内积，该算法基于向量的内积，即两个元素的对应元素相乘并求和的结果计算相似度，内积值越大相似度越高。 DistanceType.L2：欧几里得距离，它计算两个向量的欧几里得空间距离，欧式距离越小相似度越高。 DistanceType.COSINE：余弦相似度（Cosine Similarity），也称为余弦距离（Cosine Distance），用于计算两个高维向量的夹角余弦值从而衡量向量相似度，夹角余弦值越小表示两向量的夹角越大，则两个向量差异越大。当 distance=DistanceType.COSINE 时，默认对向量做归一化处理。对于hnsw_hybrid索引算法，距离类型选择只对稠密向量生效，稀疏向量仅支持内积。
Quant	QuantEnum枚举	否	QuantType.Int8	量化方式。量化方式是索引中对向量的压缩方式，可以降低向量间相似性计算的复杂度。基于向量的高维度和大规模特点，采用向量量化可以有效减少向量的存储和计算成本。取值如下： QuantType.Int8：将4字节的 float 压缩为单个字节，以获取内存和计算延迟的收益，会造成微小的损失精度，比如 cosine 距离会出现大于1的分值。 QuantType.Float：全精度，未做压缩量化。 QuantType.Fix16:将4字节的 float 压缩为两个字节，以获取内存和计算延迟的收益，会造成微小的损失精度。通过损失一定的检索精度，提升检索性能，节约资源成本。 QuantType.PQ：将高维向量转换为低维码本向量，以减少内存占用并提高搜索效率。
HnswM	int	否	20	hnsw 索引参数，表示邻居节点个数。当 indexType 配置为 IndexType.HNSW 时可选配置。
HnswCef	int	否	400	hnsw 索引参数，表示构建图时搜索邻居节点的广度。当 indexType 配置为 IndexType.HNSW 时可选配置。
HnswSef	int	否	800	hnsw 索引参数，表示线上检索的搜索广度。当 indexType 配置为 IndexType.HNSW 时可选配置。
DiskannM	int	否		diskann参数，标识邻居节点个数。当 index_type 配置为 diskann时可选配置。
DiskannCef	int	否		diskann参数，表示构建图时搜索邻居节点的广度。当 index_type 配置为 diskann时可选配置。
PqCodeRatio	float	否		diskann参数，向量维度编码的大小限制。值越大，召回率越高，但会增加内存使用量，范围 (0.0, 0.25]。当 index_type 配置为 diskann时可选配置。
CacheRatio	float	否		diskann参数，缓存节点数与原始数据的比率，较大的值会提高索引性能并增加内存使用量。范围 [0.0,0.3)。当 index_type 配置为 diskann时可选配置。

返回参数

参数	类型	示例值	描述
Message	String	success	操作结果信息

示例

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)

    input := &vikingdb.CreateVikingdbIndexInput{
       CollectionName: volcengine.String("Your Collection Name"),
       IndexName:      volcengine.String("Your Index Name"),
       Description:    volcengine.String("Your Index Description"),
       ProjectName:    volcengine.String("default"),
       VectorIndex: &vikingdb.VectorIndexForCreateVikingdbIndexInput{
          IndexType: volcengine.String(vikingdb.EnumOfIndexTypeForCreateVikingdbIndexInputHnsw),
          Distance:  volcengine.String(vikingdb.EnumOfDistanceForCreateVikingdbIndexInputL2),
          Quant:     volcengine.String(vikingdb.EnumOfQuantForCreateVikingdbIndexInputFloat),
          HnswM:     volcengine.Int32(16),
          HnswCef:   volcengine.Int32(200),
          HnswSef:   volcengine.Int32(200),
       },
       ScalarIndex: volcengine.StringSlice([]string{"title"}),
    }

    output, err := svc.CreateVikingdbIndex(input)
    if err != nil {
       panic(err)
    }
    fmt.Printf("Create index response: %+v\n", output)
}

最近更新时间：2026.01.19 21:22:55

这个页面对您有帮助吗？

有用

无用