Todos los productos
Search
Centro de documentos

Tablestore:MatchQuery

Última actualización: Sep 03, 2026

MatchQuery define la configuración de una consulta de coincidencia. Esta consulta permite buscar datos en una tabla mediante coincidencias aproximadas.

Estructura de datos

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

Obligatorio

Descripción

field_name

string

Sí

Nombre de la columna que se desea consultar.

La columna puede ser de tipo TEXT.

text

string

Sí

Palabra clave que se usa para coincidir con el valor de la columna al ejecutar una consulta de coincidencia.

Si la columna consultada es de tipo TEXT, la palabra clave se tokeniza en varios tokens según el tipo de analizador especificado durante la creación del índice de búsqueda. Si no se especifica un tipo de analizador al crear el índice de búsqueda, se aplica de forma predeterminada la tokenización por palabra individual.

Por ejemplo, si la columna consultada es de tipo TEXT y el analizador usa tokenización por palabra individual, al usar "this is" como palabra clave, se obtienen resultados como "..., this is tablestore", "is this tablestore", "tablestore is cool", "this" e "is".

minimum_should_match

int32

No

Número mínimo de tokens coincidentes que debe contener el valor de una columna. Este parámetro debe usarse junto con el operador lógico OR.

Una fila se devuelve únicamente cuando el valor de la columna field_name en dicha fila contiene como mínimo el número especificado de tokens coincidentes.

operator

QueryOperator

No

Operador de la consulta. Puede especificar el operador AND u OR. De forma predeterminada se usa OR como operador lógico, lo cual indica que una fila cumple las condiciones de consulta cuando el valor de la columna contiene como mínimo el número requerido de tokens.

weight

float

No

Configuración de peso de la condición de consulta.