put-vector-index - Object Storage Service - Centro de documentación de Alibaba Cloud

El comando put-vector-index crea un índice vectorial en un bucket de vectores.

Notas

Un bucket de vectores puede contener un máximo de 100 índices vectoriales.
Se admiten hasta 5 solicitudes PutVectorIndex por segundo.

Permisos

De forma predeterminada, las cuentas de Alibaba Cloud tienen todos los permisos, mientras que los usuarios y roles de Resource Access Management (RAM) no cuentan con ninguno. La cuenta de Alibaba Cloud o un administrador debe otorgar los permisos mediante una RAM policy o un bucket policy.

API	Acción	Descripción
PutVectorIndex	`oss:PutVectorIndex`	Crea un índice vectorial.

Formato del comando

ossutil vectors-api put-vector-index --bucket value --index-name value [flags]

Parámetros

Parámetro	Tipo	Descripción
--bucket	string	El nombre del bucket de vectores.
--data-type	string	El tipo de datos del vector. No se admiten tipos de datos personalizados. Valor predeterminado: float32.
--dimension	int	Las dimensiones del vector. El valor puede ser un número entero del 1 al 4096. El valor predeterminado es 512.
--distance-metric	string	La función de medida de distancia. Valores válidos: euclidean: distancia euclidiana (predeterminado) cosine: distancia coseno
--index-name	string	El nombre del índice. Especifique un nombre personalizado. El valor predeterminado está vacío. El nombre debe ser único en todo el bucket de vectores y tener entre 1 y 63 caracteres. El nombre solo puede contener letras y dígitos, y debe comenzar con una letra.
--metadata	string	El contenedor para la configuración de metadatos. Solo se admiten metadatos no filtrables. A continuación se muestran los límites aplicables a la configuración de metadatos no filtrables: La cantidad de entradas de metadatos debe estar entre 1 y 100. La longitud del nombre de cada clave principal de metadatos debe estar entre 1 y 63 bytes.

Nota

El comando put-vector-index corresponde a la operación de API PutVectorIndex.
Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Supported global command-line options.

Ejemplos de uso

Cree un índice llamado index para el bucket examplebucket. Este índice tiene 512 dimensiones de vector, utiliza el tipo de datos float32 y la medida de distancia euclidiana.
```
ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean
```

Cree un índice llamado index para el bucket examplebucket y configure metadatos no filtrables. Dicho índice tiene 512 dimensiones de vector, utiliza el tipo de datos float32 y la medida de distancia euclidiana.

ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean --metadata '{"nonFilterableMetadataKeys":["owner","createdBy"]}'