Erstellen eines Vektorindex in einem Vektor-Bucket

Vektor-Index erstellen

Um einen Vektorindex in einem Vektor-Bucket zu erstellen, verwenden Sie die folgenden Beispielbefehle und ersetzen Sie die user input placeholders durch eigene Daten.

Beispiel 1: Einen Vektorindex mit nicht filterbaren Metadatenschlüsseln erstellen

aws s3vectors create-index \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --data-type "float32" \
  --dimension 1 \
  --distance-metric "cosine" \
  --metadata-configuration '{"nonFilterableMetadataKeys":["nonFilterableKey1"]}'
      

Beispiel 2: Einen Vektorindex ohne nicht filterbare Metadatenschlüssel erstellen

aws s3vectors create-index \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx2" \
  --data-type "float32" \
  --dimension 4096 \
  --distance-metric "euclidean"
      

Darüber hinaus werden alle Metadaten (sowohl filterbare als auch nicht filterbare) auf dieselbe Weise mithilfe der GetVectors-, ListVectors- oder QueryVectors-API-Operationen abgerufen. Der folgende CLI-Befehl zeigt, wie Vektoren mit Metadaten (einschließlich nicht filterbarer Metadaten) abgerufen werden.

Beispielanforderung:

aws s3vectors get-vectors \
  --vector-bucket-name "amzn-s3-demo-vector-bucket" \
  --index-name "idx" \
  --keys '["vec1", "vec3"]' \
  --return-data \
  --return-metadata \

Beispielantwort:

{
    "vectors": [
        {
            "key": "vec1",
            "data": {
                "float32": [
                    0.10000000149011612,
                    0.20000000298023224,
                    0.30000001192092896,
                    0.4000000059604645,
                    0.5
                ]
            },
            "metadata": {
                "category": "test",
                "text": "First vector"
            }
        },
        {
            "key": "vec3",
            "data": {
                "float32": [
                    0.6000000238418579,
                    0.699999988079071,
                    0.800000011920929,
                    0.8999999761581421,
                    1.0
                ]
            },
            "metadata": {
                "text": "Third vector",
                "category": "test"
            }
        }
    ]
}

Die Antwort enthält alle mit dem Vektor verknüpften Metadaten, unabhängig davon, ob sie bei der Indexerstellung als filterbar oder nicht filterbar angegeben wurden.