query-vectors - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

As contas da Alibaba Cloud possuem todas as permissões por padrão. Os usuários e as funções do Resource Access Management (RAM) não possuem nenhuma permissão por padrão. Uma conta da Alibaba Cloud ou um administrador deve conceder permissões a eles usando uma política do RAM ou uma política de bucket.

API	Ação	Descrição
QueryVectors	`oss:QueryVectors`	Consulta dados de vetores.

Formato do comando

ossutil vectors-api query-vectors --bucket value --index-name value --query-vector value --top-k value  [flags]

Parâmetros

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket de vetores.
--index-name	string	O nome do índice.
--query-vector	string	O vetor de consulta no formato JSON. A dimensão deve ser igual à do índice de vetores.
--top-k	int	O número de vetores mais semelhantes a retornar. Valores válidos: 1 a 30.
--filter	string	Filtra os dados de consulta com base nos metadados. O tamanho máximo é de 64 KB. Há suporte para no máximo 1.024 instruções de filtro.
--return-distance	/	Indica se o resultado inclui a distância de similaridade. Quando esse parâmetro está vazio ou definido como `true`, o resultado inclui a distância de similaridade.
--return-metadata	/	Indica se o resultado inclui os metadados. Quando esse parâmetro está vazio ou definido como `true`, o resultado inclui os metadados.

null

O comando query-vectors corresponde à operação de API QueryVectors.
Para informações sobre as opções de linha de comando globais compatíveis, consulte Opções de linha de comando globais.

Operadores de filtro

Operador	Tipo compatível	Descrição
`$eq`	String	Correspondência exata de um único valor. Quando comparado com metadados do tipo array, esse operador retorna true se o valor de entrada corresponder a qualquer elemento no array.
`$ne`	String	Diferente de
`$in`	Array de strings	Corresponde a qualquer valor em um array. Semelhante à operação `IN` no SQL.
`$nin`	Array de strings	Não corresponde a nenhum valor em um array. Semelhante à operação `NOT IN` no SQL.
`$exists`	Boolean	Verifica se a chave de metadados existe.
`$and`	Array de filtros não vazio	AND lógico para múltiplas condições.
`$or`	Array de filtros não vazio	OR lógico para múltiplas condições.

Exemplo

Encontre os 10 vetores mais semelhantes a um vetor de consulta. A pesquisa usa o índice de vetores `index` no bucket de vetores `examplebucket` e filtra os vetores cujo `type` é `comedy` ou `documentary`.

ossutil vectors-api query-vectors --bucket examplebucket --index-name index --filter "{\"$and\":[{\"type\":{\"$in\":[\"comedy\",\"documentary\"]}}]}" --query-vector "{\"float32\":[32]}" --top-k 10