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

Object Storage Service:ベクターのリスト表示 (Go SDK V2)

最終更新日:Jun 04, 2026

Go SDK V2 を使用して ListVectors 操作を呼び出すことで、指定されたベクターインデックス内のすべてのベクターをリスト表示できます。この操作はページングをサポートしており、大量のベクトルデータを走査できます。

権限

デフォルトでは、Alibaba Cloud アカウントにはすべての権限が付与されていますが、関連付けられた RAM ユーザーおよび RAM ロールには権限がありません。Alibaba Cloud アカウントまたは管理者が、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

API

アクション

説明

ListVectors

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