Elenco dei vettori - Amazon Simple Storage Service

Elenco dei vettori

Nota

Amazon S3 Vectors è disponibile in versione di anteprima per Amazon Simple Storage Service ed è soggetto a modifiche.

Puoi elencare i vettori in un indice vettoriale con l’operazione API ListVectors. Per ulteriori informazioni sul numero massimo di vettori che possono essere restituiti per pagina, consulta Limitazioni e restrizioni. La risposta include un token di impaginazione quando i risultati vengono troncati. Per ulteriori informazioni sugli elementi di risposta di ListVectors, consulta ListVectors nella Documentazione di riferimento delle API di Amazon S3. Puoi anche utilizzare ListVectors per esportare dati vettoriali da un indice vettoriale specifico. ListVectors è molto coerente. Dopo un’operazione di scrittura, è possibile elencare immediatamente i vettori con tutte le modifiche implementate.

Per elencare i vettori, utilizza i seguenti comandi di esempio. Sostituisci i segnaposto per l’input dell’utente con le informazioni appropriate.

I parametri segment-index e segment-count consentono di partizionare le operazioni di elenco su più richieste parallele. Quando si specifica un valore segment-count (ad es. 2), si divide l’indice in altrettanti segmenti. Il parametro segment-index (a partire da 0) determina il segmento da elencare. Questo approccio aiuta a migliorare le prestazioni quando si elencano indici vettoriali di grandi dimensioni abilitando l’elaborazione parallela. Per ulteriori informazioni su segment-count e segment-index, consulta ListVectors nella Documentazione di riferimento delle API di Amazon S3.

Per elencare tutti i vettori in un indice

Richiesta di esempio:

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

Risposta di esempio:

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

Per elencare i vettori con impaginazione

Richiesta di esempio:

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"

Risposta di esempio:

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