Création d’une liste de vecteurs - Amazon Simple Storage Service

Création d’une liste de vecteurs

Note

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

Vous pouvez répertorier les vecteurs dans un index vectoriel à l’aide de l’opération d’API ListVectors. Pour plus d’informations sur le nombre maximal de vecteurs pouvant être renvoyés par page, consultez Limites 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 de ListVectors, consultez ListVectors dans la Référence des API Amazon S3. Vous pouvez également utiliser ListVectors pour exporter des données vectorielles à partir d’un index vectoriel spécifié. ListVectors est fortement cohérent. Après une opération WRITE, vous pouvez immédiatement répertorier les vecteurs avec toutes les modifications reflétées.

Pour répertorier les vecteurs, utilisez les exemples de commande suivante. Remplacez les espaces réservés à la saisie utilisateur par vos propres informations.

Les paramètres segment-count et segment-index vous permettent de partitionner vos opérations de liste sur plusieurs demandes parallèles. Lorsque vous spécifiez une valeur segment-count (telle que 2), vous divisez l’index en autant de segments. Le paramètre segment-index (à partir de 0) détermine le segment à répertorier. Cette approche permet d’améliorer les performances lors de la création d’une liste de grands index vectoriels en activant le traitement parallèle. Pour plus d’informations sur segment-count et segment-index, consultez ListVectors dans la 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"
            }
        }
    ]
}