Listar vetores (Go SDK V2) - Object Storage Service: Central de Documentação do Alibaba Cloud

Chame a operação ListVectors com o Go SDK V2 para listar todos os vetores em um índice de vetores específico. Essa operação oferece suporte à paginação para percorrer grandes volumes de dados vetoriais.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas para acessar todos os recursos. Usuários e funções do RAM não têm permissões por padrão. O proprietário da conta Alibaba Cloud ou um administrador deve conceder essas permissões por meio de uma política do RAM ou de uma política de bucket.

API	Ação	Descrição
ListVectors	`oss:ListVectors`	Lista dados vetoriais.

Definição do método

func (c *VectorsClient) ListVectors(ctx context.Context, request *ListVectorsRequest, optFns ...func(*oss.Options)) (*ListVectorsResult, error)

Parâmetros da solicitação

Parâmetro

Tipo

Descrição

params

*ListVectorsRequest

Especifica os parâmetros da solicitação, incluindo o nome do bucket e o nome do índice. Para obter mais informações, consulte ListVectorsRequest.

optFns

...func(*Options)

(Opcional) Parâmetros de configuração no nível da operação.

Para obter mais informações, consulte Options.

Valores de retorno

	Tipo	Descrição
result	*ListVectorsPaginator	Paginador usado para percorrer a lista de vetores. Para obter mais informações, consulte ListVectorsPaginator.

Código de exemplo

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", "", "The region in which the vector bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the vector bucket.")
	flag.StringVar(&accountId, "account-id", "", "The ID of the Alibaba Cloud account.")
	flag.StringVar(&indexName, "index", "", "The name of the vector index.")
}

func main() {
	flag.Parse()
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}

	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}

	if len(accountId) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, accounId required")
	}

	if len(indexName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, index required")
	}

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// To use a public endpoint, set this to false or remove this line.
		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("failed to get page %v, %v", i, err)
		}

		for _, v := range page.Vectors {
			log.Printf("vector:%v\n", v)
		}
	}
}

Referências

Para ver o código de exemplo completo sobre como listar vetores, consulte list_vectors.go.