Appelez l'opération ListVectors avec le SDK Python V2 pour répertorier tous les vecteurs d'un index vectoriel donné. La pagination permet de parcourir de grands volumes de données vectorielles.
Autorisations
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations nécessaires pour accéder à l'ensemble des ressources. Les utilisateurs RAM et les rôles RAM ne disposent d'aucune autorisation par défaut. Le propriétaire du compte Alibaba Cloud ou un administrateur doit leur accorder des autorisations via une politique RAM ou une politique de compartiment.
|
API |
Action |
Description |
|
ListVectors |
|
Répertorie les données vectorielles. |
Définition de la méthode
Le SDK Python V2 propose deux méthodes pour répertorier les données vectorielles :
list_vectors(): appelle directement l'opération. Vous devez gérer manuellement la pagination.list_vectors_paginator(): utilise un paginateur. Le SDK gère automatiquement la logique de pagination. Nous recommandons cette méthode.
list_vectors(request: ListVectorsRequest, **kwargs) → ListVectorsResult[source]Paramètres de requête
|
Paramètre |
Type |
Description |
|
request |
ListVectorsRequest |
Définit les paramètres de la requête. Pour plus d'informations, consultez ListVectorsRequest. |
Valeurs de retour
|
Type |
Description |
|
ListVectorsResult |
Valeur de retour. Pour plus d'informations, consultez ListVectorsResult. |
Pour consulter la définition complète de la méthode de listage des vecteurs, voir list_vectors.
# Use a paginator
list_vectors_paginator(**kwargs) → ListVectorsPaginator[source]Valeurs de retour
|
Type |
Description |
|
ListVectorsPaginator |
Valeur de retour. Pour plus d'informations, consultez ListVectorsPaginator. |
Pour consulter la définition complète de la méthode de listage des vecteurs avec un paginateur, voir list_vectors_paginator.
Exemple de code
import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors
parser = argparse.ArgumentParser(description="list vectors sample")
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--account_id', help='The account id.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--index_name', help='The name of the vector index.', required=True)
def main():
args = parser.parse_args()
# Loading credentials from the environment variables
credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
# Using the SDK's default configuration
cfg = oss.config.load_default()
cfg.credentials_provider = credentials_provider
cfg.region = args.region
cfg.account_id = args.account_id
cfg.use_internal_endpoint = True # Set this to False or remove this line to access the service over the public network.
if args.endpoint is not None:
cfg.endpoint = args.endpoint
client = oss_vectors.Client(cfg)
# Create a paginator for the ListVectors operation
paginator = client.list_vectors_paginator()
# Create a request with the bucket and index name
request = oss_vectors.models.ListVectorsRequest(
bucket=args.bucket,
index_name=args.index_name
)
# Iterate through the pages of vectors
for page in paginator.iter_page(request):
for o in page.vectors:
print(f'Vector: {o}')
if __name__ == "__main__":
main()Références
Pour consulter l'exemple de code complet relatif au listage des vecteurs, voir list_vectors.py.