Vektoren auflisten - Amazon Simple Storage Service

Vektoren auflisten

Anmerkung

Amazon S3 Vectors befindet sich in der Vorabversion für Amazon Simple Storage Service und unterliegt noch Änderungen.

Mit der ListVectors-API-Operation können Sie Vektoren in einem Vektorindex auflisten. Weitere Informationen zur maximalen Anzahl von Vektoren, die pro Seite zurückgegeben werden können, finden Sie unter Begrenzungen und Einschränkungen. Die Antwort enthält ein Paginierungstoken, wenn Ergebnisse gekürzt werden. Weitere Informationen zu den Antwortelementen von ListVectors finden Sie unter ListVectors in der Amazon-S3-API-Referenz. Sie können ListVectors auch verwenden, um Vektordaten aus einem bestimmten Vektorindex zu exportieren. ListVectors ist stark konsistent. Nach einem WRITE-Vorgang können Sie Vektoren sofort auflisten, wobei alle Änderungen übernommen werden.

Um Vektoren aufzulisten, verwenden Sie die folgenden Beispielbefehle. Ersetzen Sie die Platzhalter für Benutzereingaben durch Ihre eigenen Informationen.

Mit den Parametern segment-count und segment-index können Sie Ihre Listing-Vorgänge auf mehrere parallele Anfragen aufteilen. Wenn Sie einen Wert von segment-count (z. B. 2) angeben, teilen Sie den Index in entsprechend viele Segmente auf. Der Parameter segment-index (beginnend bei 0) bestimmt, welches Segment aufgelistet werden soll. Dieser Ansatz trägt dazu bei, die Leistung beim Auflisten großer Vektorindizes zu verbessern, indem die Parallelverarbeitung aktiviert wird. Weitere Informationen zu segment-count und segment-index finden Sie unter ListVectors in der Amazon-S3-API-Referenz.

Um alle Vektoren in einem Index aufzulisten

Beispielanforderung:

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

Beispielantwort:

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

Um Vektoren mit Paginierung aufzulisten

Beispielanforderung:

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"

Beispielantwort:

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