Go SDK V2 を使用して ListVectors 操作を呼び出すことで、指定されたベクターインデックス内のすべてのベクターをリスト表示できます。この操作はページングをサポートしており、大量のベクトルデータを走査できます。
権限
デフォルトでは、Alibaba Cloud アカウントにはすべての権限が付与されていますが、関連付けられた RAM ユーザーおよび RAM ロールには権限がありません。Alibaba Cloud アカウントまたは管理者が、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。
|
API |
アクション |
説明 |
|
ListVectors |
|
ベクトルデータをリスト表示します。 |
メソッド定義
func (c *VectorsClient) ListVectors(ctx context.Context, request *ListVectorsRequest, optFns ...func(*oss.Options)) (*ListVectorsResult, error)
リクエストパラメーター
|
パラメーター |
型 |
説明 |
|
params |
*ListVectorsRequest |
バケット名およびインデックス名を含むリクエストパラメーターを指定します。詳細については、「ListVectorsRequest」をご参照ください。 |
|
optFns |
...func(*Options) |
(オプション)操作レベルの構成パラメーターです。 詳細については、「Options」をご参照ください。 |
戻り値
|
型 |
説明 |
|
|
result |
*ListVectorsPaginator |
ベクターリストを走査するために使用されるペジネーターです。詳細については、「ListVectorsPaginator」をご参照ください。 |
サンプルコード
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", "", "ベクターバケットが配置されているリージョン。")
flag.StringVar(&bucketName, "bucket", "", "ベクターバケットの名前。")
flag.StringVar(&accountId, "account-id", "", "Alibaba Cloud アカウントの ID。")
flag.StringVar(&indexName, "index", "", "ベクターインデックスの名前。")
}
func main() {
flag.Parse()
if len(region) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーターです。リージョンは必須です。")
}
if len(bucketName) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーターです。バケット名は必須です。")
}
if len(accountId) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーターです。アカウント ID は必須です。")
}
if len(indexName) == 0 {
flag.PrintDefaults()
log.Fatalf("無効なパラメーターです。インデックス名は必須です。")
}
cfg := oss.LoadDefaultConfig().
WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
WithRegion(region).WithAccountId(accountId).
// パブリックエンドポイントを使用する場合は、false に設定するか、この行を削除してください。
WithUseInternalEndpoint(true)
client := vectors.NewVectorsClient(cfg)
request := &vectors.ListVectorsRequest{
Bucket: oss.Ptr(bucketName),
IndexName: oss.Ptr(indexName),
ReturnMetadata: oss.Ptr(true),
ReturnData: oss.Ptr(false),
}
p := client.NewListVectorsPaginator(request)
var i int
log.Println("Vectors:")
for p.HasNext() {
i++
page, err := p.NextPage(context.TODO())
if err != nil {
log.Fatalf("ページ %v の取得に失敗しました。%v", i, err)
}
for _, v := range page.Vectors {
log.Printf("vector:%v\n", v)
}
}
}
関連ドキュメント
ベクターをリスト表示するための完全なサンプルコードについては、「list_vectors.go」をご参照ください。