Todos os produtos
Search
Central de documentação

Tablestore:MatchQuery

Última atualização: Jun 30, 2026

O MatchQuery define as configurações de uma consulta de correspondência. Use essa consulta para buscar dados em uma tabela com base em correspondências aproximadas.

Estrutura de dados

message MatchQuery {
    optional string field_name = 1;
    optional string text = 2;
    optional int32 minimum_should_match = 3;
    optional QueryOperator operator = 4;
    optional float weight = 5;
}

Parâmetro

Tipo

Obrigatório

Descrição

field_name

string

Sim

Nome da coluna a ser consultada.

A coluna pode ser do tipo TEXT.

text

string

Sim

Palavra-chave usada para corresponder ao valor da coluna na consulta de correspondência.

Se a coluna consultada for do tipo TEXT, a palavra-chave será tokenizada em vários tokens conforme o tipo de analisador especificado na criação do índice de busca. Se nenhum analisador for definido, o sistema aplicará a tokenização por palavra única como padrão.

Por exemplo, se a coluna for do tipo TEXT e o analisador usar tokenização por palavra única, ao utilizar "this is" como palavra-chave, os resultados incluirão entradas como "..., this is tablestore", "is this tablestore", "tablestore is cool", "this" e "is".

minimum_should_match

int32

Não

Número mínimo de tokens correspondentes que um valor de coluna deve conter. Use este parâmetro em conjunto com o operador lógico OR.

Uma linha só será retornada nos resultados se o valor da coluna field_name contiver pelo menos o número mínimo de tokens correspondentes definido.

operator

QueryOperator

Não

Operador da consulta. Especifique AND ou OR. O padrão é OR, o que indica que uma linha atende às condições quando o valor da coluna contém pelo menos o número mínimo de tokens.

weight

float

Não

Configurações de peso da condição de consulta.