Vecteurs de listes

Note

Amazon S3 Vectors est en version préliminaire pour Amazon Simple Storage Service et est sujet à modification.

Vous pouvez répertorier les vecteurs dans un index vectoriel à l'aide de l'opération ListVectorsAPI. Pour plus d'informations sur le nombre maximal de vecteurs pouvant être renvoyés par page, consultezLimites et restrictions. La réponse inclut un jeton de pagination lorsque les résultats sont tronqués. Pour plus d'informations sur les éléments de réponse deListVectors, consultez ListVectorsle manuel Amazon S3 API Reference. Vous pouvez également l'utiliser ListVectors pour exporter des données vectorielles à partir d'un index vectoriel spécifié. ListVectorsest très cohérent. Après une opération WRITE, vous pouvez immédiatement répertorier les vecteurs avec toutes les modifications reflétées.

À l'aide du AWS CLI

Pour répertorier les vecteurs, utilisez les exemples de commandes suivants. Remplacez user input placeholders par vos propres informations.

Les segment-index paramètres segment-count et vous permettent de partitionner vos opérations de référencement sur plusieurs requêtes parallèles. Lorsque vous spécifiez une segment-count valeur (telle que2), vous divisez l'index en autant de segments. Le segment-index paramètre (à partir de 0) détermine le segment à répertorier. Cette approche permet d'améliorer les performances lors de la liste de grands index vectoriels en activant le traitement parallèle. Pour plus d'informations sur segment-count etsegment-index, consultez ListVectorsle manuel de référence des API Amazon S3.

Pour répertorier tous les vecteurs dans un index

Exemple de demande :

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata

Exemple de réponse :

{
    "vectors": [
        {
            "key": "vec3",
            "data": {
                "float32": [0.4000000059604645]
            },
            "metadata": {
                "nonFilterableKey": "val4",
                "filterableKey": "val2"
            }
        }
    ]
}

Pour répertorier les vecteurs avec pagination

Exemple de demande :

aws s3vectors list-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --segment-count 2 \
  --segment-index 0 \
  --return-data \
  --return-metadata \
  --next-token "zWfh7e57H2jBfBtRRmC7OfMwl209G9dg3j2qM6kM4t0rps6ClYzJykgMOil9eGqU5nhf_gTq53IfoUdTnsg"

Exemple de réponse :

{
    "vectors": [
        {
            "key": "vec1",
            "data": {
                "float32": [0.5]
            },
            "metadata": {
                "nonFilterableKey": "val2",
                "filterableKey": "val1"
            }
        }
    ]
}