使用Go SDK V2调用PutVectorIndexFusion接口在向量Bucket中创建Fusion模式的向量索引。
说明
Fusion Mode 目前处于邀测阶段,仅在印度尼西亚(雅加达)地域提供。Standard 模式向量索引的创建请参见 创建向量Index(Go SDK V2)。
权限说明
阿里云账号默认拥有全部权限。阿里云账号下的 RAM 用户或 RAM 角色默认没有任何权限,需要阿里云账号或账号管理员通过 RAM Policy 或 Bucket Policy 授予操作权限。
|
API |
Action |
说明 |
|
PutVectorIndexFusion |
oss:PutVectorIndex |
创建Fusion模式的向量索引(Index)。 |
方法定义
Fusion模式索引通过 PutVectorIndexFusion 方法创建,使用类型化的请求和响应结构体。
func (c *VectorsClient) PutVectorIndexFusion(ctx context.Context, request *vectors.PutVectorIndexFusionRequest, optFns ...func(*oss.Options)) (*vectors.PutVectorIndexFusionResult, error)
请求参数列表
|
参数名 |
类型 |
说明 |
|
ctx |
context.Context |
请求上下文 |
|
request |
*vectors.PutVectorIndexFusionRequest |
PutVectorIndexFusion 请求结构体,包含 Bucket、IndexName、Mode、SchemaConfiguration 等字段。各字段的含义请参见 |
|
optFns |
...func(*Options) |
(可选)接口级的配置参数 |
返回值列表
|
参数名 |
类型 |
说明 |
|
result |
*vectors.PutVectorIndexFusionResult |
PutVectorIndexFusion 返回值,包含 StatusCode、RequestId 等字段。当 err 为 nil 时有效。 |
|
err |
error |
请求的状态,当请求失败时,err 不为 nil |
示例代码
package main
import (
"context"
"flag"
"log"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/vectors"
)
var (
region string
bucketName string
accountId string
indexName string
)
func init() {
flag.StringVar(®ion, "region", "", "The region in which the vector bucket is located.")
flag.StringVar(&bucketName, "bucket", "", "The name of the vector bucket.")
flag.StringVar(&accountId, "account-id", "", "The id of vector account.")
flag.StringVar(&indexName, "index", "", "The name of vector index.")
}
func main() {
flag.Parse()
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, bucket name required")
}
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, region required")
}
if len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, accountId required")
}
if len(indexName) == 0 {
flag.PrintDefaults()
log.Fatalf("invalid parameters, index required")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId)
client := vectors.NewVectorsClient(cfg)
// 使用 FieldSchema 结构体构建 Schema 字段列表
request := &vectors.PutVectorIndexFusionRequest{
Bucket: oss.Ptr(bucketName),
IndexName: oss.Ptr(indexName),
Mode: oss.Ptr("fusion"),
SchemaConfiguration: &vectors.SchemaConfiguration{
Fields: []map[string]any{
vectors.FieldSchema{
Name: oss.Ptr("vector_1"),
Type: oss.Ptr("vector"),
DataType: oss.Ptr("float32"),
Dimension: oss.Ptr(1024),
DistanceMetric: oss.Ptr("cosine"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("vector_2"),
Type: oss.Ptr("vector"),
DataType: oss.Ptr("float32"),
Dimension: oss.Ptr(512),
DistanceMetric: oss.Ptr("cosine"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("timestamps"),
Type: oss.Ptr("long"),
IsArray: oss.Ptr(true),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("price"),
Type: oss.Ptr("double"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("ip"),
Type: oss.Ptr("ip"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("location"),
Type: oss.Ptr("geoPoint"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("tag"),
Type: oss.Ptr("string"),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("user_id"),
Type: oss.Ptr("string"),
IsPartitionKey: oss.Ptr(true),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("tags"),
Type: oss.Ptr("string"),
IsArray: oss.Ptr(true),
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("title_1"),
Type: oss.Ptr("string"),
ExactMatch: oss.Ptr(true),
Text: &vectors.TextSchema{
Enabled: oss.Ptr(true),
Analyzer: oss.Ptr("standard"),
AnalyzerParameters: &vectors.AnalyzerParameters{
CaseSensitive: oss.Ptr(true),
DelimitWord: oss.Ptr(false),
},
},
}.ToMap(),
vectors.FieldSchema{
Name: oss.Ptr("title_2"),
Type: oss.Ptr("string"),
ExactMatch: oss.Ptr(false),
Text: &vectors.TextSchema{
Enabled: oss.Ptr(true),
Analyzer: oss.Ptr("split"),
AnalyzerParameters: &vectors.AnalyzerParameters{
CaseSensitive: oss.Ptr(true),
Delimiter: oss.Ptr(" "),
},
},
}.ToMap(),
},
},
}
result, err := client.PutVectorIndexFusion(context.TODO(), request)
if err != nil {
log.Fatalf("failed to put vector index fusion: %v", err)
}
log.Printf("put vector index fusion result: %#v\n", result)
}
该文章对您有帮助吗?