Listado de vectores (Python SDK V2) - Object Storage Service - Centro de documentación de Alibaba Cloud

Llame a la operación ListVectors mediante el Python SDK V2 para listar todos los vectores de un índice vectorial específico. Se admite la paginación para recorrer grandes volúmenes de datos vectoriales.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos para acceder a todos los recursos. Los usuarios y roles de RAM no cuentan con ningún permiso de manera predeterminada. El propietario de la cuenta de Alibaba Cloud o un administrador debe otorgarles permisos mediante una RAM policy o una bucket policy.

API	Acción	Descripción
ListVectors	`oss:ListVectors`	Lista los datos vectoriales.

Definición del método

El Python SDK V2 ofrece dos métodos para listar datos vectoriales:

list_vectors(): llama directamente a la operación. Gestione la paginación de forma manual.
list_vectors_paginator(): utiliza un paginador. El SDK gestiona automáticamente la lógica de paginación. Se recomienda este método.

list_vectors(request: ListVectorsRequest, **kwargs) → ListVectorsResult[source]

Parámetros de solicitud

Parámetro	Tipo	Descripción
request	ListVectorsRequest	Establezca los parámetros de la solicitud. Para obtener más información, consulte ListVectorsRequest.

Valores de retorno

Tipo	Descripción
ListVectorsResult	Valor de retorno. Para obtener más información, consulte ListVectorsResult.

Para ver la definición completa del método que lista vectores, consulte list_vectors.

# Use a paginator
list_vectors_paginator(**kwargs) → ListVectorsPaginator[source]

Valores de retorno

Tipo	Descripción
ListVectorsPaginator	Valor de retorno. Para obtener más información, consulte ListVectorsPaginator.

Para ver la definición completa del método que lista vectores mediante un paginador, consulte list_vectors_paginator.

Código de ejemplo

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()

Referencias

Para ver el código de ejemplo completo sobre cómo listar vectores, consulte list_vectors.py.