すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:ベクトルのアップロード (Go SDK V2)

最終更新日:Jun 04, 2026

Go SDK V2 を使用して PutVectors 操作を呼び出し、指定したベクターインデックスにベクトルデータをアップロードします。

権限

Alibaba Cloud アカウント (root ユーザー) はデフォルトでフルアクセス権限を持ちます。RAM ユーザーおよびロールは、RAM ポリシーまたはバケットポリシーによる明示的な権限付与が必要です。

API

アクション

説明

PutVectors

oss: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(&region, "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」をご参照ください。