Tous les produits
Search
Centre de documentation

Object Storage Service:Charger des vecteurs (SDK Python V2)

Dernière mise à jour :Sep 22, 2026

Appelez l'opération PutVectors avec le SDK Python V2 pour charger des données vectorielles dans un index vectoriel spécifié.

Autorisations

Un compte Alibaba Cloud dispose de toutes les autorisations par défaut. En revanche, les utilisateurs et rôles RAM n'en ont aucune. Le propriétaire du compte ou un administrateur doit accorder les autorisations nécessaires via une politique RAM ou une politique de bucket.

API

Action

Description

PutVectors

oss:PutVectors

Écrit des données vectorielles.

Définition de la méthode

put_vectors(request: PutVectorsRequest, **kwargs) → PutVectorsResult

Paramètres de requête

Paramètre

Type

Description

request

PutVectorsRequest

Paramètres de la requête, incluant le nom du bucket, le nom de l'index et les données vectorielles. Pour plus d'informations, consultez PutVectorsRequest.

Valeur de retour

Type

Description

PutVectorsResult

Valeur de retour. Pour plus d'informations, consultez PutVectorsResult.

Pour la définition complète de la méthode put_vectors, consultez put_vectors.

Exemples

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors

parser = argparse.ArgumentParser(description="vector put vectors sample")
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--index_name', help='The name of the vector index.', required=True)
parser.add_argument('--account_id', help='The account id.', required=True)

def main():
    args = parser.parse_args()

    # Loading credentials values 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

    vector_client = oss_vectors.Client(cfg)

    vectors = [
        {
            "data": {"float32":  [0.1] * 128},
            "key": "key1",
            "metadata": {"metadata1": "value1", "metadata2": "value2"}
        },
        {
            "data": {"float32": [0.2] * 128},
            "key": "key2",
            "metadata": {"metadata3": "value3", "metadata4": "value4"}
        }
    ]

    result = vector_client.put_vectors(oss_vectors.models.PutVectorsRequest(
        bucket=args.bucket,
        index_name=args.index_name,
        vectors=vectors,
    ))

    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
    )

if __name__ == "__main__":
    main()

Références

Pour l'exemple de code complet relatif au chargement de données vectorielles, consultez put_vectors.py.