Creazione di un indice vettoriale in un bucket vettoriale

Nota

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

Nota

Scegli con attenzione i parametri di configurazione dell'indice vettoriale. Dopo aver creato un indice vettoriale, non puoi aggiornare il nome dell'indice vettoriale, la dimensione, la metrica della distanza o le chiavi di metadati non filtrabili. Per modificare uno di questi valori, devi creare un nuovo indice vettoriale.

Un indice vettoriale è una risorsa all'interno di un bucket vettoriale che archivia e organizza i dati vettoriali per una ricerca di similarità efficiente. Quando si crea un indice vettoriale, si definiscono le caratteristiche che tutti i vettori di quell'indice devono condividere, come la dimensione, la metrica della distanza utilizzata per i calcoli di somiglianza e, facoltativamente, le chiavi di metadati non filtrabili. Per ulteriori informazioni sui requisiti di denominazione degli indici vettoriali, sui requisiti delle dimensioni, sulle opzioni metriche della distanza e sulle chiavi di metadati non filtrabili, consulta. Limitazioni e restrizioni

Gli indici vettoriali devono essere creati all'interno di un bucket vettoriale esistente e richiedono parametri di configurazione specifici che non possono essere modificati dopo la creazione.

Utilizzo della console S3

Per creare un indice vettoriale

1. Apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

2. Nel pannello di navigazione, scegli Vector buckets.

3. Nell'elenco dei bucket vettoriali, scegli il nome del bucket in cui desideri creare un indice vettoriale.

4. Scegli Crea indice vettoriale.

5. Per il nome dell'indice vettoriale, inserisci un nome per il tuo indice vettoriale.

   I nomi degli indici vettoriali devono essere univoci all'interno del bucket vettoriale. Il nome dell'indice deve essere compreso tra 3 e 63 caratteri. I caratteri validi sono lettere minuscole (a-z), numeri (0-9), trattini (-) e punti (.). Per ulteriori informazioni sui requisiti di denominazione degli indici vettoriali, vedere. Limitazioni e restrizioni

6. Per Dimension, inserisci il numero di valori in ogni vettore.

   Nota

   • Il valore di Dimension determina quanti valori numerici conterrà ogni vettore.

   • Tutti i vettori aggiunti a questo indice devono avere esattamente questo numero di valori.

   • La dimensione deve essere compresa tra 1 e 4096.

   • Una dimensione più grande richiede più spazio di archiviazione.

   • Scegliete in base alle dimensioni di output del modello di incorporamento.

   Per ulteriori informazioni sui requisiti di dimensione, vedereLimitazioni e restrizioni.

7. Per la metrica della distanza, scegli una delle seguenti opzioni:

   • Coseno: misura il coseno dell'angolo tra i vettori. Ideale per vettori normalizzati e quando la direzione è più importante della grandezza

   • Euclideo: misura la distanza in linea retta tra i vettori. Ideale quando sia la direzione che la magnitudine sono importanti.

8. (Facoltativo) In Metadati non filtrabili, configura le chiavi dei metadati che verranno archiviate ma non utilizzate per il filtraggio:

   Per aggiungere chiavi di metadati non filtrabili:

   1. Scegliere Add key (Aggiungi chiave).

   2. Inserisci un nome di chiave (1-63 caratteri e univoco all'interno di questo indice vettoriale).

   3. Ripetere l'operazione per aggiungere altre chiavi (massimo 10 chiavi).

   Nota

   È possibile allegare metadati filtrabili come coppie chiave-valore a ciascun vettore quando si inseriscono dati vettoriali dopo aver creato un indice vettoriale. Per impostazione predefinita, tutte le chiavi di metadati allegate ai vettori sono filtrabili e possono essere utilizzate come filtri in una query di somiglianza. Solo le chiavi di metadati specificate come non filtrabili durante la creazione di indici vettoriali sono escluse dal filtraggio. Per ulteriori informazioni sui limiti di dimensione dei metadati per vettore, inclusi i vincoli totali e filtrabili dei metadati, consulta. Limitazioni e restrizioni

9. Esamina attentamente la configurazione.

   Nota

   Queste impostazioni non possono essere modificate dopo la creazione.

10. Scegli Crea indice vettoriale.

Usando il AWS CLI

Per creare un indice vettoriale in un bucket vettoriale, utilizzate i seguenti comandi di esempio e sostituiteli user input placeholders con le vostre informazioni.

Esempio 1: creazione di un indice vettoriale con chiavi di metadati non filtrabili

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"]}'
      

Esempio 2: creazione di un indice vettoriale senza chiavi di metadati non filtrabili

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

Inoltre, tutti i metadati (filtrabili e non filtrabili) vengono recuperati allo stesso modo utilizzando le operazioni, o API. GetVectors ListVectors QueryVectors Il seguente comando CLI mostra come recuperare i vettori con metadati (inclusi i metadati non filtrabili).

Richiesta di esempio:

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

Risposta di esempio:

{
    "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"
            }
        }
    ]
}

La risposta includerà tutti i metadati associati al vettore, indipendentemente dal fatto che sia stato specificato come filtrabile o non filtrabile durante la creazione dell'indice.