Todos os produtos
Search
Central de documentação

Tablestore:KnnVectorQuery

Última atualização: Jun 30, 2026

O KnnVectorQuery realiza uma busca aproximada de vizinhos mais próximos para localizar os k vetores mais semelhantes em um conjunto de dados.

Estrutura de dados

message KnnVectorQuery {
    optional string field_name = 1;
    optional int32 top_k = 2;
    repeated float float32_query_vector = 4;
    optional Query filter = 5;
    optional float weight = 6;
    optional float min_score = 7;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Nome do campo vetorial de busca.

top_k

int32

Sim

Número de vizinhos mais próximos a retornar. Para o valor máximo, consulte Limites do índice de busca.

float32_query_vector

float

Sim

Vetor de consulta usado na busca por similaridade. A dimensão deste vetor deve corresponder à do campo vetorial de destino.

filter

Query

Não

Filtro que combina condições não vetoriais para refinar resultados antes da busca vetorial.

weight

float

Não

Peso atribuído a esta consulta em uma consulta composta. Valores maiores aumentam a influência desta consulta na pontuação final de relevância.

min_score

float

Não

Limiar mínimo de pontuação. O sistema retorna apenas linhas com pontuação superior a este valor. Valores válidos: maior ou igual a 0. Valor padrão: 0.