Indici vettoriali

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.

Gli indici vettoriali sono risorse all'interno di bucket vettoriali che archiviano e organizzano i dati vettoriali per operazioni di ricerca di similarità efficienti. Quando si crea un indice vettoriale, si specifica la metrica della distanza (CosineoEuclidean), il numero di dimensioni che un vettore deve avere e, facoltativamente, un elenco di campi di metadati che si desidera escludere dal filtro durante le query di somiglianza.

Per ulteriori informazioni sui limiti degli indici vettoriali per bucket, sui limiti vettoriali per indice e sui limiti di dimensione per vettore, consulta. Limitazioni e restrizioni

Ogni indice vettoriale ha un Amazon Resource Name (ARN) univoco. Gli ARNs indici vettoriali seguono il seguente formato:

arn:aws:s3vectors:region:account-id:bucket/bucket-name/index/index-name

Requisiti per la denominazione degli indici vettoriali

• I nomi degli indici vettoriali devono essere univoci all'interno del bucket vettoriale.

• I nomi degli indici vettoriali devono avere una lunghezza compresa tra 3 e 63 caratteri.

• I caratteri validi sono lettere minuscole (a-z), numeri (0-9), trattini (-) e punti (.).

• I nomi degli indici vettoriali devono iniziare e terminare con una lettera o un numero.

Requisiti dimensionali

Una dimensione è il numero di valori in un vettore. Tutti i vettori aggiunti all'indice devono avere esattamente questo numero di valori.

• Una dimensione deve essere un numero intero compreso tra 1 e 4096.

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

Opzioni metriche della distanza

La metrica della distanza specifica come viene calcolata la somiglianza tra i vettori. Quando crei incorporamenti vettoriali, scegli la metrica di distanza consigliata dal modello di incorporamento per risultati più accurati.

• 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.

Chiavi di metadati non filtrabili

Le chiavi di metadati consentono di allegare informazioni aggiuntive ai vettori come coppie chiave-valore durante l'archiviazione e il recupero. Per impostazione predefinita, tutti i metadati sono filtrabili, quindi puoi utilizzarli per filtrare i risultati delle query. Tuttavia, è possibile designare chiavi di metadati specifiche come non filtrabili quando si desidera archiviare informazioni con vettori senza utilizzarle per il filtraggio.

A differenza delle chiavi di metadati predefinite, queste chiavi non possono essere utilizzate come filtri di interrogazione. Le chiavi di metadati non filtrabili possono essere recuperate ma non possono essere ricercate, interrogate o filtrate. Puoi accedervi solo dopo aver trovato l'indice.

Le chiavi di metadati non filtrabili consentono di arricchire i vettori con un contesto aggiuntivo che si desidera recuperare con i risultati di ricerca ma che non è necessario filtrare. Un esempio comune di chiave di metadati non filtrabile è quando si incorpora testo in vettori e si desidera includere il testo originale stesso come metadati non filtrabili. Ciò consente di restituire il testo sorgente insieme ai risultati della ricerca vettoriale senza aumentare i limiti di dimensione dei metadati filtrabili. Altri esempi includono la memorizzazione dei timestamp di creazione, della fonte o delle informazioni descrittive URLs puramente a scopo di riferimento. È possibile accedere alle chiavi di metadati non filtrabili durante il recupero dei vettori ma, a differenza delle chiavi di metadati predefinite, queste chiavi non possono essere utilizzate come filtri di interrogazione.

I requisiti per le chiavi di metadati non filtrabili sono i seguenti.

• Le chiavi di metadati non filtrabili devono essere univoche all'interno dell'indice vettoriale.

• Le chiavi di metadati non filtrabili devono avere una lunghezza compresa tra 1 e 63 caratteri.

• Le chiavi di metadati non filtrabili non possono essere modificate dopo la creazione dell'indice vettoriale.

• I vettori S3 supportano fino a 10 chiavi di metadati non filtrabili per indice.

Argomenti

• Creazione di un indice vettoriale in un bucket vettoriale

• Elenco degli indici vettoriali

• Eliminazione di un indice vettoriale