Go SDK V2 を使用して PutVectors 操作を呼び出し、指定したベクターインデックスにベクトルデータをアップロードします。
権限
Alibaba Cloud アカウント (root ユーザー) はデフォルトでフルアクセス権限を持ちます。RAM ユーザーおよびロールは、RAM ポリシーまたはバケットポリシーによる明示的な権限付与が必要です。
|
API |
アクション |
説明 |
|
PutVectors |
|
ベクトルデータを書き込みます。 |
メソッド定義
func (c *VectorsClient) PutVectors(ctx context.Context, request *PutVectorsRequest, optFns ...func(*oss.Options)) (*PutVectorsResult, error)
リクエストパラメーター
|
パラメーター |
型 |
説明 |
|
ctx |
context.Context |
リクエストコンテキスト。 |
|
request |
*PutVectorsRequest |
リクエストパラメーター(ベクターバケット名を含む)。詳細については、「PutVectorsRequest」をご参照ください。 |
|
optFns |
...func(*Options) |
オプションの構成関数。 |
戻り値
|
パラメーター |
型 |
説明 |
|
result |
*PutVectorsResult |
戻り値。このパラメーターは err が nil の場合にのみ有効です。詳細については、「PutVectorsResult」をご参照ください。 |
|
err |
error |
エラーメッセージ。操作が成功した場合は 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
)
func init() {
flag.StringVar(®ion, "region", "", "ベクターバケットが配置されているリージョン。")
flag.StringVar(&bucketName, "bucket", "", "ベクターバケットの名前。")
flag.StringVar(&accountId, "account-id", "", "Alibaba Cloud アカウント ID。")
}
func main() {
flag.Parse()
if len(bucketName) == 0 || len(region) == 0 || len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーター")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId).
// パブリックアクセスを使用する場合は、このパラメーターを false に設定するか、この行を削除します。
WithUseInternalEndpoint(true)
client := vectors.NewVectorsClient(cfg)
request := &vectors.PutVectorsRequest{
Bucket: oss.Ptr(bucketName),
IndexName: oss.Ptr("exampleIndex"),
Vectors: [ ]map[string]any{
{
"key": "vector1",
"data": map[string]any{
"float32": [ ]float32{1.2, 2.5, 3},
},
"metadata": map[string]any{
"Key1": "value2",
"Key2": [ ]string{"1", "2", "3"},
},
},
},
}
result, err := client.PutVectors(context.TODO(), request)
if err != nil {
log.Fatalf("ベクトルのアップロードに失敗しました %v", err)
}
log.Printf("ベクトルのアップロード結果:%#v\n", result)
}
参照
ベクトルデータのアップロードに関する完全なサンプルコードについては、「put_vectors.go」をご参照ください。