Tous les produits
Search
Centre de documentation

Object Storage Service:Récupérer des informations sur les vecteurs (SDK Go V2)

Dernière mise à jour :Sep 22, 2026

Utilisez l'opération GetVectors du SDK Go V2 pour récupérer les données vectorielles et leurs métadonnées à partir de clés spécifiées.

Autorisations

Les comptes Alibaba Cloud disposent de toutes les autorisations par défaut. Les utilisateurs RAM et les rôles RAM n'en ont aucune. Un compte Alibaba Cloud ou un administrateur doit accorder les autorisations nécessaires via une politique RAM ou une politique de bucket.

API

Action

Description

GetVectors

oss:GetVectors

Récupère les données vectorielles.

Définition de la méthode

func (c *VectorsClient) GetVectors(ctx context.Context, request *GetVectorsRequest, optFns ...func(*oss.Options)) (*GetVectorsResult, error)

Paramètres de requête

Paramètre

Type

Description

ctx

context.Context

Contexte de la requête.

request

*GetVectorsRequest

Paramètres de la requête, tels que le nom du bucket, le nom de l'index et la liste des clés de vecteur. Pour plus d'informations, consultez GetVectorsRequest.

optFns

...func(*Options)

(Facultatif) Paramètres de configuration au niveau de l'API.

Pour plus d'informations, consultez Options.

Valeurs de retour

Paramètre

Type

Description

result

*GetVectorsResult

Valeur de retour. Ce paramètre est valide uniquement si err est nul. Pour plus d'informations, consultez GetVectorsResult.

err

error

Message d'erreur. Si l'opération réussit, cette valeur est nulle.

Exemple de code

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", "", "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 vector account.")
}

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

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

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

	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).WithAccountId(accountId).
		// To access over the public network, set this to false or remove this line.
		WithUseInternalEndpoint(true)

	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("failed to get vectors %v", err)
	}
	log.Printf("get vectors result:%#v\n", result)
}

Références

Pour l'exemple de code complet, consultez get_vectors.go.