Go SDK V2 を使用して GetVectors 操作を呼び出し、指定されたキーに基づいてベクトルデータとそのメタデータを取得します。
権限
Alibaba Cloud アカウントは、デフォルトですべての権限を持っています。ただし、Resource Access Management (RAM) ユーザーと RAM ロールには、デフォルトでは権限がありません。Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。
API | アクション | 説明 |
GetVectors |
| ベクトルデータを取得します。 |
メソッド定義
func (c *VectorsClient) GetVectors(ctx context.Context, request *GetVectorsRequest, optFns ...func(*oss.Options)) (*GetVectorsResult, error)リクエストパラメーター
パラメーター | 型 | 説明 |
ctx | context.Context | リクエストコンテキスト。 |
request | *GetVectorsRequest | バケット名、インデックス名、ベクトルキーのリストなどのリクエストパラメーター。詳細については、「GetVectorsRequest」をご参照ください。 |
optFns | ...func(*Options) | (オプション) API レベルの構成パラメーター。 詳細については、「Options」をご参照ください。 |
戻り値
パラメーター | 型 | 説明 |
result | *GetVectorsResult | 戻り値。このパラメーターは、err が nil の場合にのみ有効です。詳細については、「GetVectorsResult」をご参照ください。 |
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", "", "ベクトルアカウントの ID。")
}
func main() {
flag.Parse()
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーター、バケット名が必要です")
}
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーター、リージョンが必要です")
}
if len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーター、accountId が必要です")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId)
client := vectors.NewVectorsClient(cfg)
request := &vectors.GetVectorsRequest{
Bucket: oss.Ptr(bucketName),
IndexName: oss.Ptr("index"),
Keys: []string{"key1", "key2", "key3"},
ReturnData: oss.Ptr(true),
ReturnMetadata: oss.Ptr(false),
}
result, err := client.GetVectors(context.TODO(), request)
if err != nil {
log.Fatalf("ベクトルの取得に失敗しました %v", err)
}
log.Printf("ベクトル取得結果:%#v\n", result)
}関連ドキュメント
完全なサンプルコードについては、「get_vectors.go」をご参照ください。