Referencia de la sintaxis del lenguaje de consulta FAST (FQL)FAST Query Language (FQL) syntax reference

Aprenda a construir consultas de búsqueda complejas para Buscar en SharePoint usando el lenguaje de consulta FAST (FQL). Esta referencia describe los elementos de una consulta FQL y enseña a usar las especificaciones de propiedades, las expresiones de token y los operadores en las consultas FQL.Learn about constructing complex search queries for Search in SharePoint using the FAST Query Language (FQL). This reference describes the elements of an FQL query and how to use property specifications, token expressions, and operators in your FQL queries.

Introducción a las subexpresiones y expresiones del lenguaje de consulta FQL en SharePointIntroduction to FQL and query language subexpressions and expressions in SharePoint

El lenguaje de consulta FAST (FQL) es un lenguaje potente que permite a los desarrolladores realizar búsquedas exactas y reducir el ámbito de la búsqueda a valores que pertenezcan a una propiedad administrada concreta o un índice de texto completo.The FAST Query Language (FQL) is a powerful query language that enables developers to perform exact searches and to narrow the scope of your search to values that belong to a specific managed property or a full-text index.

Una expresión de lenguaje de consulta puede contener subexpresiones anidadas que incluyan términos de consulta, especificaciones de propiedades y operadores, como se ve en la tabla 1.A query language expression can contain nested subexpressions that include query terms, property specifications, and operators, as described in Table 1.

Tabla 1. Subexpresiones en expresiones de lenguaje de consultaTable 1. Subexpressions in query language expressions

ElementoItem DescripciónDescription
Expresiones de tokenToken expressions
Uno o varios términos de consulta, frases o valores numéricos que se van a buscar en una consulta.One or more query terms, phrases, or numeric values to search for in a query.
Especificación de propiedadProperty specification
Una propiedad o índice de texto completo que coincide con la expresión afectada.A property or full-text index to match with the affected expression.
OperadoresOperators
Palabras clave que especifican operaciones booleanas (como AND, OR) u otras restricciones a los operandos (como FILTER).Keywords that specify Boolean operations (such as AND, OR) or other constraints to operands (such as FILTER.)

Ejemplo de consulta FQLFQL query example

En el siguiente ejemplo de consulta FQL se buscan los términos "hello" y "world" en la propiedad administrada body de un elemento indizado:The following FQL query example searches for the terms "hello" and "world" in the body managed property of an indexed item:

body:string("hello world", mode="and")

En el ejemplo:In the example:

  • body: limita el ámbito de la consulta en la propiedad administrada de cuerpo del elemento.body: limits the scope of the query to the body managed property within the item.

  • "hello world" es el operando del operador STRING, que indica los términos que se buscan."hello world" is the operand to the STRING operator, which indicates the terms to search for.

  • mode="and" indica que el operador lógico de consulta AND se aplicará a "hello world".mode="and" indicates that the logical query operator AND will be applied to "hello world".

La longitud de las consultas del lenguaje de consulta FAST está limitado a 2.048 caracteres.The length of FAST Query Language queries is limited to 2,048 characters.

Especificación de propiedades en FQLProperty specification in FQL

Una especificación de propiedad limita el ámbito de la expresión afectada a regiones determinadas del contenido indizado. Una región de este tipo se identifica por un índice de texto completo o una propiedad administrada.A property specification limits the scope of the affected expression to specific regions of the indexed content. Such a region can be identified by a full-text index or a managed property.

Las propiedades administradas de tipo Text y YesNo se evalúan como texto. Todos los otros tipos de propiedades administradas, incluido el tipo Datetime, se evalúan como valores numéricos.Managed properties of type Text and YesNo are evaluated as text. All other managed property types, including the Datetime type, are evaluated as numeric values.

Si no incluye una especificación de propiedad para una expresión, el motor de búsqueda trata de buscar coincidencias con el índice de texto completo definido en el esquema de índices.If you don't include a property specification for an expression, the search engine attempts to match the default full-text index defined in the index schema.

El nombre de la propiedad siempre debe ir antes de dos puntos (operador In) y los operadores numéricos deben incluir una especificación de propiedad.The property name must always precede a colon ( In operator), and numeric operators must always include a property specification.

Se puede aplicar una especificación de propiedad (el operador In) a las siguientes entidades de consulta:A property specification (the In Operator) may be applied to the following query entities:

  • Un término o una frase únicos, por ejemplo:A single term or phrase, as follows:

    author:shakespeare

    title:"to be or not to be"

  • Un operador, como el operador STRING en el ejemplo siguiente:An operator, for example, the STRING operator, as follows:

    title:string("to be or not to be")
In this case the property specification applies to the complete operator expression.

EjemplosExamples

Cada una de las expresiones siguientes coincide con elementos que tienen "much" y "nothing" en la propiedad administrada title.Each of the following expressions matches items that have both "much" and "nothing" in the title managed property.

title:and(much, nothing)

and(title:much, title:nothing)

title:string("much nothing", mode="and")

Expresiones de token en FQLToken expressions in FQL

Las expresiones de token son palabras, frases o valores numéricos que coinciden con el índice.Token expressions are words, phrases, or numeric values that are matched against the index.

Una nueva expresión de token puede ser una sola palabra o una frase entre comillas dobles.A text token expression can be a single word or a phrase enclosed in double quotation marks.

Una expresión de token numérica puede ser un valor único o una expresión de rango de valores.A numeric token expression can be a single value or a value range expression.

Expresiones de caracteres comodínWildcard expressions

Una expresión de carácter comodín indica un solo término o una frase que incluye el carácter del asterisco ("*"); el asterisco implica una coincidencia de cero o varios caracteres sin incluir los espacios en blanco.A wildcard expression indicates a single term or phrase that includes the Asterisk ("*") character; asterisk implies a match of zero or more characters, excluding whitespace. FQL admite la búsqueda de prefijos para las propiedades administradas de texto individuales y los índices de texto completo.FQL supports prefix search for individual text managed properties and full-text indexes.

Ejemplos de expresiones de caracteres comodínWildcard expression examples

La siguiente es una lista de usos válidos de expresiones de carácter comodín en FQL:The following is a list of valid uses of wildcard expressions in FQL:

  • text*

  • string("this examp*")

Expresiones de términos numéricosNumeric term expressions

Cada expresión de término numérico debe incluir una especificación de propiedad de un tipo de datos de esquema de índice compatible. En la tabla 2 se recogen los tipos de datos numéricos que se pueden usar en FQL.Each numeric term expression must include a property specification of a compatible index schema data type. Table 2 lists the numeric data types that can be used in FQL.

Tabla 2. Tipos de datos numéricos que se pueden usar en FQL.Table 2. Numeric data types that can be used in FQL

Tipo FQLFQL type Tipos de esquemas de índice compatiblesCompatible index schema types DescripciónDescription
IntInt
IntegerInteger
Entero de 64 bits.64 bit integer.
FloatFloat
DoubleDouble
Punto flotante de 64 bits (doble precisión).64-bit (double precision) floating point.
DecimalDecimal
DecimalDecimal
Decimal de 128 bits.128-bit decimal
DatetimeDatetime
DatetimeDatetime
Valor de fecha y hora.A date and time value.
La compatibilidad de fecha y hora en FQL permite las mismas operaciones numéricas en los valores de fecha y hora que en otros valores numéricos.The date/time support in FQL enables the same numeric operations on date/time values as on other numeric values.

Expresiones de consulta de fecha y horaDate and time query expressions

FQL dispone del tipo de dato datetime para la fecha y la hora.FQL provides the datetime data type for date and time.

En las consultas se admiten los siguientes formatos de datetime compatibles con la norma ISO 8601:The following ISO 8601-compatible datetime formats are supported in queries:

  • AAAA-MM-DDYYYY-MM-DD

  • AAAA-MM-DDThh:mm:ssYYYY-MM-DDThh:mm:ss

  • AAAA-MM-DDThh:mm:ssZYYYY-MM-DDThh:mm:ssZ

  • AAAA-MM-DDThh:mm:ssfrZYYYY-MM-DDThh:mm:ssfrZ

En estos formatos de datetime:In these datetime formats:

  • AAAA especifica un año de cuatro dígitos.YYYY specifies a four-digit year.

    Nota

    Solo se admiten años de cuatro dígitos.Only four-digit years are supported.

  • MM especifica un mes de dos dígitos. Por ejemplo, 01 = enero.MM specifies a two-digit month. For example, 01 = January.

  • DD especifica un día del mes de dos dígitos (de 01 a 31).DD specifies a two-digit day of the month (01 through 31).

  • T especifica la letra "T".T specifies the letter "T".

  • hh especifica una hora de dos dígitos (de 00 a 23). No se permite la indicación a.m./p.m.hh specifies a two-digits hour (00 through 23); A.M./P.M. indication is not allowed.

  • mm especifica un minuto de dos dígitos (de 00 a 59).mm specifies a two-digit minute (00 through 59).

  • ss especifica a un segundo de dos dígitos (de 00 a 59).ss specifies a two-digit second (00 through 59).

  • fr especifica una fracción de segundos opcional, ss, de 1 a 7 dígitos detrás del . después de los segundos. Por ejemplo, 2012-09-27T11:57:34.1234567.fr specifies an optional fraction of seconds, ss; between 1 to 7 digits that follows the . after the seconds. For example, 2012-09-27T11:57:34.1234567.

Todos los valores de fecha y hora deben especificarse según el formato UTC (hora universal coordinada), también conocido como zona horaria GMT (hora del meridiano de Greenwich). El identificador de zona horaria UTC (un carácter final "Z") es opcional.All date/time values must be specified according to the UTC (Coordinated Universal Time), also known as GMT (Greenwich Mean Time) time zone. The UTC time zone identifier (a trailing "Z" character) is optional.

Palabras reservadas, caracteres especiales y escapeReserved words, special characters, and escaping

Las siguientes son palabras reservadas en FQL.The following words are reserved within FQL.

and, or, any, andnot, count, decimal, rank, near, onear, int, in32, int64, float, double, datetime, max, min, range, phrase, scope, filter, not, string, starts-with, ends-with, equals, words, xrank.

Si quiere expresar una de estas palabras como término en una expresión de consulta, tiene que encerrarla entre comillas dobles, tal como se ve en los ejemplos siguientes:If you want to express any of these words as terms in a query expression, you must enclose them in double quotation marks as shown in the following examples:

  • or("any", "and", "xrank")

  • string("any and xrank", mode="OR")

  • phrase(this, is, a, "phrase")

Sugerencia: Las palabras y los caracteres reservados no distinguen mayúsculas de minúsculas, pero se recomienda usar caracteres en minúscula por cuestiones de compatibilidad futura.Tip: Reserved words and characters are not case-sensitive, but using lowercase characters are recommended for future compatibility.

FQL no siempre exige encerrar una cadena entre comillas dobles. Por ejemplo, and(cat, dog) es una expresión FQL válida aunque cat y dog no estén entre comillas dobles, pero recomendamos usarlas para evitar conflictos con las palabras reservadas.FQL does not always require a string to be enclosed in double quotation marks. For example, and(cat, dog) is valid FQL even though cat and dog are not in double quotation marks. However, we recommend that you use double quotation marks to avoid conflicts with reserved words.

Los términos de consulta se ajustan según el token de la configuración regional. El proceso de ajuste por token quita algunos caracteres especiales. Como se quitan estos caracteres, las siguientes expresiones FQL son equivalentes.The query terms are tokenized according to your locale setting. The tokenization process removes certain special characters. Because special characters are removed, the following FQL expressions are equivalent.

and("[king]", "<queen>")

and("king", "queen")

Cuando una consulta incluya términos de la entrada de usuario o de otra aplicación, use el operador string("<query terms>", mode="AND|OR|PHRASE") para evitar conflictos con las palabras reservadas en el lenguaje de consulta. También debe quitar las comillas dobles que pueda haber en la consulta introducida por el usuario.When a query includes terms from user input or another application, use the string("<query terms>", mode="AND|OR|PHRASE") operator to avoid conflict with reserved words in the query language. You must also remove possible double quotation marks from the user-provided query.

Operadores de FQLFQL Operators

Los operadores del lenguaje de consulta FAST (FQL) son palabras clave que especifican operaciones booleanas u otras restricciones a los operandos. La sintaxis de operador FQL es la siguiente:FAST Query Language (FQL) operators are keywords that specify Boolean operations or other constraints to operands. The FQL operator syntax is as follows:

[property-spec:]operator(operand [,operand]* [, parameter="value"]*)

En la sintaxis:In the syntax:

  • property-spec es una especificación de propiedad opcional seguida por el operador "in".property-spec is an optional property specification followed by the "in" operator.

  • operator es una palabra clave que especifica una operación que hay que realizar.operator is a keyword that specifies an operation to perform.

  • operand es una expresión de término u otro operador.operand is a term expression or another operator.

  • parameter es el nombre de un valor que cambia el comportamiento del operador.parameter is the name of a value that changes the behavior of the operator.

  • value es el valor que se usa para el nombre del parámetro.value is the value to use for the parameter name.

Los nombres de los operadores y de los parámetros, así como los valores de texto de los parámetros, distinguen mayúsculas y minúsculas. Los espacios en blanco se permiten en el cuerpo del operador, pero se omiten a menos que estén entre comillas dobles. La longitud de las consultas del lenguaje de consulta FAST está limitado a 2.048 caracteres.Operator names, parameter names, and parameter text values are case-insensitive. White space is allowed within the operator body, but is ignored unless it is enclosed in double quotation marks. The length of FAST Query Language queries is limited to 2,048 characters.

La tabla 3 recoge los tipos de operadores admitidos por FQL.Table 3 lists the types of operators supported by FQL.

Tabla 3. Tipos de operadores admitidos por FQLTable 3. FQL supported operator types

TipoType DescripciónDescription OperadoresOperators
StringString
Le permite especificar operaciones de consulta en una cadena de términos. Este es el operador que más se usa en los términos de texto.Enables you to specify query operations on a string of terms. This is the most common operator to use on text terms.
STRINGSTRING
BooleanoBoolean
Le permite combinar términos y subexpresiones en una consulta.Enables you to combine terms and sub-expressions in a query.
AND, O bien, ANY, ANDNOT, NOT, COUNT, COUNTAND, OR, ANY, ANDNOT, NOT, COUNT, COUNT
ProximidadProximity
Le permite especificar la proximidad de los términos de consulta en una secuencia coincidente de texto.Enables you to specify the proximity of the query terms in a matching sequence of text.
NEAR, ONEAR, PHRASE, STARTS-WITH, ENDS-WITH, EQUALSNEAR, ONEAR, PHRASE, STARTS-WITH, ENDS-WITH, EQUALS
NuméricoNumeric
Le permite especificar condiciones numéricas en la consulta.Enables you to specify numeric conditions in the query.
RANGE, INT, FLOAT, DATETIME, DECIMALRANGE , INT, FLOAT, DATETIME, DECIMAL
RelevanciaRelevance
Le permite ver el impacto de la evaluación de relevancia de una consulta.Enables you to impact the relevance evaluation of a query.
XRANK y FILTERXRANK and FILTER

La tabla 4 contiene una lista de los operadores admitidos.Table 4 provides a list of the supported operators.

Tabla 4. Operadores FQL compatiblesTable 4. FQL supported operators

OperadorOperator DescripciónDescription TipoType
ANDAND
Solo devuelve elementos que coinciden con todos los operandos AND.Returns only items that match all AND operands.
BooleanoBoolean
ANDNOTANDNOT
Solo devuelve elementos que coinciden con el primer operando y que no coinciden con los siguientes.Returns only items that match the first operand and that don't match the subsequent operands.
BooleanoBoolean
ANYANY
Se parece al operador OR, pero la clasificación dinámica (la puntuación de relevancia del conjunto de resultados) no se ve afectada ni por el número de operandos que coinciden ni por la distancia que hay entre los términos del elemento.Similar to the OR operator except that the dynamic rank (the relevance score in the result set.md) is affected by neither the number of operands that match nor the distance between the terms in the item.
BooleanoBoolean
COUNTCOUNT
Le permite especificar el número de repeticiones del término de consulta que un elemento debe incluir para que se devuelva como resultado. El operando puede ser un solo término de consulta, una frase o un término de consulta de carácter comodín.Enables you to specify the number of query term occurrences an item must include to be returned as a result. The operand may be a single query term, a phrase, or wildcard query term.
BooleanoBoolean
DATETIMEDATETIME
Ofrece una escritura explícita de valores numéricos.Provides explicit typing of numeric values.
La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.
NuméricoNumeric
DECIMALDECIMAL
Ofrece una escritura explícita de valores numéricos.Provides explicit typing of numeric values.
La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.
NuméricoNumeric
ENDS-WITHENDS-WITH
Especifica que una palabra o frase deben aparecer al final de una propiedad administrada.Specifies that a word or phrase must appear in the end of a managed property.
ProximidadProximity
EQUALSEQUALS
Especifica que una palabra, un término de frase o una frase deben proporcionar una coincidencia de token exacta con la propiedad administrada.Specifies that a word or phrase term or phrase must provide an exact token match with the managed property.
ProximidadProximity
FILTERFILTER
Se usa para consultar metadatos u otros datos estructurados.Used to query metadata or other structured data.
RelevanciaRelevance
FLOATFLOAT
Ofrece una escritura explícita de valores numéricos.Provides explicit typing of numeric values.
La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.
NuméricoNumeric
INTINT
Ofrece una escritura explícita de valores numéricos.Provides explicit typing of numeric values.
La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.
NuméricoNumeric
NEARNEAR
Restringe el conjunto de resultados a los elementos que tienen N términos a cierta distancia unos de otros.Restricts the result set to items that have N terms within a certain distance of one another.
ProximidadProximity
NOTNOT
Solo devuelve elementos que excluyen el operando.Returns only items that exclude the operand.
BooleanoBoolean
ONEARONEAR
La variante ordenada de NEAR; requiere un conjunto ordenado de términos. El operador ONEAR se puede usar para restringir el conjunto de resultados a los elementos que tienen N términos a cierta distancia unos de otros. Solo devuelve los elementos que no coinciden con el operando. El operando puede ser cualquier expresión FQL. The ordered variant of NEAR, and requires an ordered match of the terms. The ONEAR operator can be used to restrict the result set to items that have N terms within a certain distance of Returns only items that don't match the operand. The operand may be any valid FQL expression.one another.
ProximidadProximity
OROR
Solo devuelve los elementos que coinciden, al menos, con uno de los operandos OR.Returns only items that match at least one of the OR operands. Los elementos que coinciden tienen una clasificación dinámica más alta (puntuación de relevancia en el conjunto de resultados) si coinciden más operandos OR. Items that match will get a higher dynamic rank (relevance score in the result set.md) if more of the OR operands match.
BooleanoBoolean
PHRASEPHRASE
Solo devuelve elementos que coinciden con una cadena exacta de tokens.Returns only items that match an exact string of tokens.
ProximidadProximity
RANGERANGE
Permite expresiones coincidentes de rango. El operador RANGE se usa para propiedades administradas numéricas y de fecha y hora.Enables range matching expressions. The RANGE operator is used for numeric and date/time managed properties.
NuméricoNumeric
STARTS-WITHSTARTS-WITH
Especifica que una palabra o frase deben aparecer al principio de una propiedad administrada.Specifies that a word or phrase must appear in the start of a managed property.
ProximidadProximity
STRINGSTRING
Define una condición booleana coincidente para una cadena de texto.Define a Boolean matching condition to a text string.
StringString
XRANKXRANK
Le permite aumentar la clasificación dinámica de elementos basándose en las repeticiones de ciertos términos sin cambiar los elementos que coinciden con la consulta. Una expresión XRANK contiene un componente que se debe ofrecer como resultado y uno o varios componentes que contribuyen solo a la clasificación dinámica.Enables you to boost the dynamic rank of items based on certain term occurrences without changing which items match the query. A XRANK expression contains one component that must be matched, and one or more components that contribute only to dynamic ranking.
RelevanciaRelevance

Nota

En SharePoint, el operador RANK está en desuso y ya no tiene efecto.In SharePoint, the RANK operator is deprecated and will no longer have any effect. Ahora debe usar XRANK.Use XRANK instead.

ANDAND

Solo devuelve elementos que coinciden con todos los operandos AND. Los operandos pueden ser un solo término o cualquier subexpresión FQL válida.Returns only items that match all AND operands. The operands may be a single term or any valid FQL sub-expression.

SintaxisSyntax

and(operand, operand [, operand]*)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat", "dog" y "fox".The following expression matches items for which the default full-text index contains "cat", "dog", and "fox".

and(cat, dog, fox)

ANDNOTANDNOT

Solo devuelve elementos que coinciden con el primer operando y que no coinciden con los siguientes. Los operandos pueden ser un solo término o cualquier subexpresión FQL válida.Returns only items that match the first operand and that don't match the subsequent operands. The operands may be a single term or any valid FQL sub-expression.

SintaxisSyntax

andnot(operand, operand [,operand]*)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

Ejemplo 1. La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat" pero no "dog".Example 1. The following expression matches items for which the default full-text index contains "cat" but not "dog".

andnot(cat, dog)

Ejemplo 2. La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "dog" pero no contiene ni "beagle" ni "chihuahua".Example 2. The following expression matches items for which the default full-text index contains "dog" but neither "beagle" nor "chihuahua".

andnot(dog, beagle, chihuahua)

ANYANY

Nota

En SharePoint, el operador ANY está en desuso.In SharePoint, the ANY operator is deprecated. Use el operador OR.Use the OR operator instead.

Se parece al operador O bien, pero la clasificación dinámica (la puntuación de relevancia del conjunto de resultados) no se ve afectada ni por el número de operandos que coinciden ni por la distancia que hay entre los términos del elemento. Los operandos pueden ser un solo término o cualquier subexpresión FQL válida.Similar to the OR operator except that the dynamic rank (the relevance score in the result set) is affected by neither the number of operands that match nor the distance between the terms in the item. The operands may be a single term or any valid FQL sub-expression.

El componente de clasificación dinámica de esta parte de la consulta se basa en el mejor término coincidente de la expresión ANY.The dynamic ranking component for this part of the query is based on the best matching term within the ANY expression.

Nota

La diferencia de OR solo se relaciona con la clasificación dentro del conjunto de resultados.he difference from OR is related only to the ranking within the result set. El mismo conjunto total de elementos coincidirá con la consulta.The same total set of items will match the query.

SintaxisSyntax

any(operand, operand [,operand]*)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat" o "dog".The following expression matches items for which the default full-text index contains "cat" or "dog".

Si el índice contiene "cat" y "dog", pero "cat" se considera una coincidencia mejor, la clasificación dinámica del elemento se basará en "cat" sin tener en cuanto el término "dog".If the index contains both "cat" and "dog", but "cat" is considered a better match, the 'item's dynamic rank will be based on "cat" with no consideration given to "dog".

any(cat, dog)

COUNTCOUNT

Especifica el número de repeticiones del término de consulta que un elemento debe incluir para que el elemento se devuelva como resultado. El operando puede ser un solo término de consulta, una frase o un término de consulta de carácter comodín.Specifies the of number query term occurrences an item must include for the item to be returned as a result. The operand may be a single query term, a phrase, or a wildcard query term.

SintaxisSyntax

property-spec:count(operand [,from=<numeric value>, to=<numeric value>])

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
FromFrom
<numeric_value><numeric_value>
El valor del parámetro from debe ser un entero positivo que especifique el número mínimo de veces que el operando especificado se debe mostrar como resultado.The value of the from parameter must be a positive integer that specifies the minimum number of times that the specified operand must be matched.
Si el parámetro from no se especifica, no existirá límite inferior.If the from parameter is not specified, no lower limit will exist.
toto
<numeric_value><numeric_value>
El valor del parámetro to debe ser un entero positivo que especifique el número máximo y no inclusivo de veces que el operando especificado se debe mostrar como resultado. Por ejemplo, un valor to de 11 indica 10 veces o menos. The value of the to parameter must be a positive integer that specifies the non-inclusive maximum number of times that the specified operand must be matched. For example, a to value of 11 specifies 10 times or fewer.
Si el parámetro to no se especifica, no existirá límite superior.If the to parameter is not specified, no upper limit will exist.

EjemplosExamples

Ejemplo 1. La siguiente expresión ofrece como resultado al menos 5 repeticiones de la palabra "cat".Example 1. The following expression matches at least 5 occurrences of the word "cat".

count(cat, from=5)

Ejemplo 2. La siguiente expresión ofrece como resultado al menos 5 repeticiones de la palabra "cat", pero no 10 ni más de 10.Example 2. The following expression matches at least 5 but not 10 or more occurrences of the word "cat".

count(cat, from=5, to=10)

Ejemplo 3. Todas las expresiones siguientes ofrecen como resultado al menos 3 repeticiones de una palabra, que puede ser "cat" o "dog".Example 3. Each of the following expressions matches at least 3 occurrences of a certain word, and that word can be either "cat" or "dog".

count(or(cat, dog), from=3)count(string("cat dog", mode="or"), from=3)

La tabla siguiente contiene ejemplos de valores de cadena de propiedades administradas; se indica si coinciden con las dos expresiones del ejemplo 3.The following table contains examples of managed property string values and states whether they match the two expressions in Example 3.

¿Coincide?Match? TextoText
Yes
My cat likes my dog, but my dog hates my cat.My cat likes my dog, but my dog hates my cat.
NoNo
My bird likes my newt, but my dog hates my cat.My bird likes my newt, but my dog hates my cat.

DATETIMEDATETIME

Ofrece una escritura explícita de valores numéricos de fecha y hora. El operando es una cadena de fecha y hora cuyo formato se basa en la sintaxis especificada en las Expresiones de token en FQL.Provides explicit typing of date/time numeric values. The operand is a date/time string formatted according to the syntax specified in Token expressions in FQL.

La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.

SintaxisSyntax

datetime(<date/time string>)

ParámetrosParameters

No procede.Not applicable.

DECIMALDECIMAL

Ofrece una escritura explícita de valores decimales. El operando es un valor decimal según la sintaxis especificada en Expresiones de token en FQL.Provides explicit typing of decimal values. The operand is a decimal value according to the syntax specified in Token expressions in FQL.

La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.

SintaxisSyntax

decimal(<decimal point value>)

ParámetrosParameters

No procede.Not applicable.

ENDS-WITHENDS-WITH

Especifica que una palabra o frase deben aparecer al final de una propiedad administrada (coincidencia de límites).Specifies that a word or phrase must appear in the end of a managed property (boundary matching).

La coincidencia de límites no se admite en las propiedades administradas numéricas. Estas propiedades siempre estarán sujetas a una coincidencia exacta o de rango de valores.Boundary matching is not supported on numeric managed properties. Numeric managed properties will always be subject to exact or value range matching.

Algunas aplicaciones pueden necesitar que pueda realizar una coincidencia exacta de una propiedad administrada. Por ejemplo, puede tratarse de una propiedad administrada product name, donde el nombre completo de un producto es una subcadena de otro nombre de producto.Some applications may require that you are able to perform an exact match of a managed property. For example, this may be a product name managed property, where the full name of one product is a substring of another product name.

SintaxisSyntax

ends-with(<term or phrase>)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La expresión siguiente ofrece elementos con los valores "Mr Adam Jones" y "Adam Jones" en la propiedad administrada "author". No mostrará resultados con el valor "Adam Jones sr".The following expression matches items with the values "Mr Adam Jones" and "Adam Jones" in the "author" managed property. It will not match items with the value "Adam Jones sr".

author:ends-with("adam jones")

ComentariosRemarks

La coincidencia de límites se puede aplicar a todo el texto de la propiedad administrada o a cadenas individuales dentro de una propiedad administrada que contenga una lista de valores de cadena, por ejemplo, una lista de nombres. En este caso, convendría hacer coincidir el contenido exacto de cada cadena y evitar la coincidencia de consultas de un límite de cadena a otro.Boundary matching can be applied to all the text of the managed property, or to individual strings within a managed property that contains a list of string values, for example, a list of names. In this case, you may want to match the exact content of each string, and to avoid query matching across string boundaries.

Para aplicar las consultas de coincidencia de límites, hay que configurar la propiedad administrada correspondiente en el esquema de índice.To apply boundary match queries, you must configure the relevant managed property in the index schema.

Al habilitar la función Coincidencia de límite en la propiedad administrada, puede hacer lo siguiente:By enabling the Boundary Match feature for the managed property, you can do the following:

  • Usar consultas de coincidencia de límites explícitas.Use explicit boundary match queries.

  • Evitar que las frases coincidan de un límite de cadena a otro. Para las propiedades administradas que contienen varias cadenas, esta función asegura que una cadena no coincida con palabras antes o después de una indicación de límite.Prevent phrases from matching across string boundaries. For managed properties that contain multiple strings, this feature will ensure that a string does not match words before or after a boundary indication.

EQUALSEQUALS

Especifica que una palabra o frase debe ofrecer una coincidencia de token exacta con la propiedad administrada.Specifies that a word or phrase must provide an exact token match with the managed property.

SintaxisSyntax

equals(<term or phrase>)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

El ejemplo siguiente ofrece elementos con los valores "Adam Jones" en la propiedad administrada "author". No mostrará resultados con el valor "Adam Jones sr" ni "Mr Adam Jones".The following example will match items with the values "Adam Jones" in the "author" managed property. It will not match items with the values "Adam Jones sr" or "Mr Adam Jones".

author:equals("adam jones")

ComentariosRemarks

Vea también ENDS-WITH.See also ENDS-WITH.

FILTERFILTER

Se usa para consultar metadatos u otros datos estructurados.Used to query metadata or other structured data.

Usar el operador FILTER implica automáticamente lo siguiente para la consulta especificada:Using the FILTER operator automatically implies the following for the specified query:

  • La lingüística se establece en lingüística="OFF".Linguistics will be set to linguistics="OFF".

  • La clasificación de deshabilita.Ranking will be disabled.

  • No se usará ningún resaltado de consultas en el resumen de resultados resaltados del resultado de la consulta.No query highlighting will be used in the hit highlighted summary for the query result hit.

Sugerencia: Si usa el operador STRING dentro de una expresión FILTER, la lingüística estará deshabilitada de forma predeterminada.Tip: If you use the STRING operator inside a FILTER expression, by default, linguistics is disabled. Puede habilitar el procesamiento de lingüística en cada expresión STRING dentro de FILTER usando el operando linguistics="ON".You can enable linguistics processing within each STRING expression inside FILTER by using the operand linguistics="ON".

SintaxisSyntax

filter(<any valid FQL operator expression>)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La expresión siguiente ofrece como resultados los elementos que tienen una propiedad administrada Title que contiene "sonata" y una propiedad administrada Doctype que contiene solo el token "audio". No se realiza ninguna coincidencia lingüística en "audio". Como el token FILTER se usará para mostrar "audio", ese texto no se resaltará en el resumen de resultados resaltados.The following expression matches items that have a Title managed property that contains "sonata" and a Doctype managed property that contains only the token "audio". No linguistic matching will be performed on "audio". Because the FILTER token will be used to match "audio", that text will not be highlighted in the hit highlighted summary.

and(title:sonata, filter(doctype:equals("audio")))

ComentariosRemarks

Si tiene que restringir la consulta para que muestre al menos uno de un conjunto amplio de valores enteros en una propiedad numérica, puede expresar esto de dos formas equivalentes funcionalmente:If you must restrict your query to match at least one of a large set of integer values in a numeric property, you can express this in two functionally equivalent ways:

  • and(string("hello world"), filter(property-spec:or(1, 20, 453, ... , 3473)))

  • and(string("hello world"), filter(property-spec:int("1 20 453 ... 3473", mode="or")))

En el segundo ejemplo se emplea el operador INT usando una cadena con el conjunto de valores numéricos entre comillas. Esto ofrece un rendimiento de la consulta bastante mejor al filtrar con un amplio conjunto de valores numéricos.The second example uses the INT operator by using a string with the set of numeric values in double quotation marks. This provides a significantly better query performance when filtering with a large set of numeric values.

Si tiene que filtrar un conjunto grande de valores, puede usar valores numéricos en lugar de valores de cadena y expresar las consultas usando la sintaxis optimizada.If you must filter a large set of values, you should consider using numeric values instead of string values, and express your queries by using the optimized syntax.

FLOATFLOAT

Ofrece una escritura explícita de valores numéricos de punto flotante. El operando es un valor de punto flotante según la sintaxis especificada en las Expresiones de token en FQL.Provides explicit typing of floating point numeric values. The operand is a floating point value according to the syntax specified in Token expressions in FQL.

La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.

SintaxisSyntax

float(<floating point value>)

ParámetrosParameters

No procede.Not applicable.

INTINT

Ofrece una escritura explícita de valores enteros. El operando es un valor entero según la sintaxis especificada en las Expresiones de token en FQL.Provides explicit typing of integer values. The operand is an integer value according to the syntax specified in Token expressions in FQL.

La conversión de tipo explícito es opcional y no suele ser necesaria. El tipo del término de consulta se detecta según el tipo de la propiedad numérica administrada de destino.The explicit type conversion is optional and usually is not needed. The type of the query term is detected according to the type of the target numeric managed property.

El operador INT también se puede usar para expresar un conjunto de valores enteros como argumentos de los operadores booleanos FQL. Esto supone un modo muy eficiente de ofrecer un conjunto de valores enteros en una consulta, ya que los valores que se pasan usando el operador INT no los analiza el analizar de consultas FQL, sino que pasan directamente al componente de coincidencias de consulta.The INT operator can also be used to express a set of integer values as arguments to Boolean FQL operators. This provides a performance efficient way to provide a set of integer values in a query, as the values that are passed by using the INT operator are not parsed by the FQL query parser but passed directly to the query matching component.

SintaxisSyntax

int(<integer value>)

int("value, value, ??? , value")

La primera sintaxis especifica un solo entero. La segunda sintaxis especifica una lista de valores enteros separados por comas y encerrados entre comillas dobles.The first syntax specifies a single integer. The second syntax specifies a comma-separated list of integer values enclosed in double quotation marks.

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

Si tiene que restringir la consulta para que muestre al menos uno de un conjunto amplio de valores enteros en una propiedad numérica, puede expresar esto usando el operador INT:If you need to restrict your query to match at least one of a large set of integer values in a numeric property, you can express this by using the INT operator:

and(string("hello world"), filter(id:int("1 20 49 124 453 985 3473", mode="or")))

NEARNEAR

Restringe el conjunto de resultados a los elementos que tienen N términos a cierta distancia unos de otros.Restricts the result set to items that have N terms within a certain distance of one another.

El orden de los términos de consulta no es importante para la búsqueda de resultados, solo importa la distancia.The order of the query terms is not important for the matching, only the distance.

Puede combinar todos los términos que quiera con los operadores NEAR.Any number of terms can be combined with the NEAR operators.

Los operandos NEAR pueden ser términos únicos, frases o las expresiones de operador booleano OR o ANY. Se pueden usar caracteres comodín.NEAR operands may be single terms, phrases, or Boolean OR or ANY operator expressions. Wildcards are accepted.

Si hay varios operandos del operador NEAR que coinciden con el mismo token indizado, se considera que están cerca.If multiple operands of the NEAR operator match the same indexed token, they are considered near one another.

SintaxisSyntax

near(arg, arg [, arg]* [, N=<numeric value>])

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
NN
<numeric_value><numeric_value>
Especifica el número máximo de palabras que pueden aparecer entre los términos (proximidad explícita).Specifies the maximum number of words that is allowed to appear between the terms (explicit proximity).
Si NEAR incluye más de dos operandos, el número máximo de palabras permitidas entre los términos ( N) se cuenta dentro de la expresión completa.If NEAR includes more than two operands, the maximum number of words allowed between the terms ( N) is counted within the whole expression.
Valor predeterminado: 4Default: 4

EjemplosExamples

Ejemplo 1. La expresión siguiente muestra como resultados las cadenas que contienen "cat" y "dog" si no están separadas por más de cuatro tokens indizados (valor predeterminado).Example 1. The following expression matches strings that contain both "cat" and "dog" if no more than four indexed tokens (default) separate them.

near(cat, dog)

Ejemplo 2. La expresión siguiente muestra como resultados las cadenas que contienen "cat", "dog", "fox" y "wolf" si no están separadas por más de cuatro tokens indizados.Example 2. The following expression matches strings that contain "cat", "dog", "fox", and "wolf" if no more than four indexed tokens separate them.

near(cat, dog, fox, wolf)

La tabla siguiente contiene ejemplos de valores de cadena de propiedades administradas; se indica si coinciden con la expresión anterior del ejemplo 2.The following table contains examples of managed property string values and states whether they match the previous expression in Example 2.

¿Coincide?Match? TextoText
Yes
La imagen muestra un gato, un perro, un zorro y un lobo.The picture shows a cat, a dog, a fox, and a wolf.
Sí (con lematización)Yes (with stemming)
Los perros, los zorros y los lobos son cánidos, pero los gatos son felinos.Dogs, foxes, and wolves are canines, but cats are felines.
NoNo
La imagen muestra un gato con un perro, un zorro y un lobo.The picture shows a cat with a dog, a fox, and a wolf.

La expresión siguiente muestra como resultados todas las cadenas de la tabla anterior.The following expression matches all the strings in the previous table.

near(cat, dog, fox, wolf, N=5)

ComentariosRemarks

Consideraciones sobre la distancia entre términos de NEAR/ONEARNEAR/ONEAR term distance considerations

N indica el número máximo de palabras que pueden aparecer entre los términos de consulta dentro del segmento coincidente del elemento. Si NEAR u ONEAR incluyen más de dos operandos, el número máximo de palabras permitidas entre los términos de consulta ( N) se cuenta dentro del segmento del elemento que coincide con todos los términos de NEAR u ONEAR.N indicates the maximum number of words that are allowed to appear between the query terms within the matching segment of the item. If NEAR or ONEAR includes more than two operands, the maximum number of words allowed between the query terms ( N) is counted within the segment of the item matching all the NEAR or ONEAR terms.

NEAR y ONEAR funcionan en texto ajustado por token. Esto significa que los caracteres especiales, como la coma (" , "), el punto (" . "), los dos puntos (" : ") y el punto y coma (" ; "), se tratarán como espacios en blanco. El término "distancia" se refiere a los tokens que hay en el texto indizado.NEAR or ONEAR operates on tokenized text. This means that special characters such as comma (" , "), period (" . "), colon (" : "), or semicolon (" ; ") will be treated as white space. The term "distance" relates to tokens within the indexed text.

Si usa ONEAR o NEAR con operandos iguales, el operador funcionará así:If you use ONEAR or NEAR with equal operands, the operator will work as follows:

near(a, a, n=x)

Esta consulta siempre devolverá true si aparece al menos una instancia de " a" dentro del contexto. Esto también significa que NEAR no se puede usar como operador COUNT. Para más información sobre cómo contar repeticiones de términos, vea el operador COUNT.This query will always return true if at least one instance of '' a'' appears within the context. This also means that NEAR cannot be used as a COUNT operator. For more information about counting term occurrences, see the COUNT operator.

NEAR aplicado a frases también ofrecerá como resultado frases superpuestas en el texto.NEAR applied to phrases will also match overlapping phrases in the text.

Si un token del segmento coincidente coincide con más de un operando de la expresión NEAR u ONEAR, la consulta puede coincidir aunque el número de tokens no coincidentes que hay en el segmento coincidente supere el valor de ' N' en la expresión del operador NEAR u ONEAR. Por ejemplo, una superposición puede ser frases superpuestas. Si el número de coincidencias de superposición de token es ' O', la consulta coincidirá si no aparecen más de ' N+O' tokens no coincidentes dentro del segmento coincidente del elemento.If a token in the matching segment matches more than one operand to the NEAR or ONEAR expression, the query may match even if the number of nonmatching tokens within the matching segment exceeds the value of ' N' in the NEAR or ONEAR operator expression. For example, an overlap can be overlapping phrases. If the number of token overlap matches is ' O', the query will match if not more than ' N+O' non-matching tokens appear within the matching segment of the item.

NEAR u ONEAR con NOTNEAR or ONEAR with NOT

El operador NOT no se puede usar dentro del operador NEAR u ONEAR. A continuación se muestra una sintaxis de FQL incorrecta:The NOT operator cannot be used inside the NEAR or ONEAR operator. The following is incorrect FQL syntax:

near(audi,not(bmw),n=2)

NOTNOT

Solo devuelve los elementos que no coinciden con el operando. Este puede ser cualquier expresión FQL válida.Returns only items that don't match the operand. The operand may be any valid FQL expression.

SintaxisSyntax

not(operand)

ParámetrosParameters

No procede.Not applicable.

ONEARONEAR

La variante ordenada de NEAR; requiere una coincidencia ordenada de los términos. El operador ONEAR se puede usar para restringir el conjunto de resultados a los elementos que tienen N términos a cierta distancia unos de otros.The ordered variant of NEAR, and requires an ordered match of the terms. The ONEAR operator can be used to restrict the result set to items that have N terms within a certain distance of one another.

SintaxisSyntax

onear(arg, arg [, arg]* [, N=<numeric value>])

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
NN
<numeric_value><numeric_value>
Especifica el número máximo de palabras que pueden aparecer entre los términos (proximidad explícita).Specifies the maximum number of words that are allowed to appear between the terms (explicit proximity).
Si ONEAR incluye más de dos operandos, el número máximo de palabras permitidas entre los términos ( N) se cuenta dentro de la expresión completa.If ONEAR includes more than two operands, the maximum number of words allowed between the terms ( N) is counted within the whole expression.
Valor predeterminado: 4Default: 4

EjemplosExamples

Ejemplo 1. La expresión siguiente muestra como resultados todas las repeticiones de las palabras "cat", "dog", "fox" y "wolf" que aparecen en orden si no están separadas por más de cuatro tokens indizados.Example 1. The following expression matches all the occurrences of the words "cat", "dog", "fox", and "wolf" that appears in order, if no more than four indexed tokens separate them.

onear(cat, dog, fox, wolf)

La tabla siguiente contiene ejemplos de valores de cadena de propiedades administradas; se indica si coinciden con la expresión anterior.The following table contains examples of managed property string values, and states whether they match the previous expression.

¿Coincide?Match? TextoText
Yes
The picture shows a cat, a dog, a fox, and a wolf.The picture shows a cat, a dog, a fox, and a wolf.
NoNo
Dogs, foxes, and wolves are canines, but cats are felines.Dogs, foxes, and wolves are canines, but cats are felines.
NoNo
The picture shows a cat with a dog, a fox, and a wolf.The picture shows a cat with a dog, a fox, and a wolf.

Ejemplo 2. La expresión siguiente ofrece como resultados (con lematización) el texto de la segunda fila de la tabla anterior.Example 2. The following expression matches (with stemming) the text in the second row of the previous table.

onear(dog, fox, wolf, cat, N=5)

Ejemplo 3. La expresión siguiente ofrece como resultados el texto de la primera y la tercera fila de la tabla anterior.Example 3. The following expression matches the text in the first and third rows of the preceding table.

onear(cat, dog, fox, wolf, N=5)

ComentariosRemarks

Vea también NEAR.See also NEAR.

OOR

Solo devuelve los elementos que coinciden, al menos, con uno de los operandos OR. Los elementos que coinciden tienen una clasificación dinámica más alta (puntuación de relevancia en el conjunto de resultados) si coinciden más operandos OR. Los operandos pueden ser un solo término o cualquier subexpresión FQL válida.Returns only items that match at least one of the OR operands. Items that match will get a higher dynamic rank (relevance score in the result set) if more of the OR operands match. The operands may be a single term or any valid FQL sub-expression.

SintaxisSyntax

or(operand, operand [,operand]*)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La siguiente expresión ofrece como resultados todos los elementos cuyo índice de texto completo predeterminado contiene "cat" o "dog". Si el índice de texto completo predeterminado de un elemento contiene "cat" y "dog", la clasificación dinámica será mayor y ofrecerá más resultados que si solo tuviese uno de los tokens.The following expression matches all the items for which the default full-text index contains either "cat" or "dog". If an item's default full-text index contains both "cat" and "dog", it will match and have a higher dynamic rank than it would if it contained only one of the tokens.

or(cat, dog)

PHRASEPHRASE

Busca una cadena exacta de tokens.Searches for an exact string of tokens.

Los operandos PHRASE pueden ser términos únicos. Se pueden usar caracteres comodín.The PHRASE operands can be single terms. Wildcards are accepted.

SintaxisSyntax

phrase(term [, term]*)

ParámetrosParameters

No procede.Not applicable.

ComentariosRemarks

Vea también STRING.See also STRING.

RANGERANGE

Use el operador RANGE para propiedades administradas numéricas y de fecha y hora. El operador permite usar expresiones de coincidencia de rango.Use the RANGE operator for numeric and date/time managed properties. The operator enables range matching expressions.

SintaxisSyntax

range(start, stop [,from="GE"|"GT"] [,to="LE"|"LT"])

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
startstart
<numeric_value>|<date/time_value><numeric_value>|<date/time_value>
Valor de inicio del intervalo.Start value for the range.
Para especificar que el rango no tiene límite inferior, use la palabra reservada min.To specify that the range has no lower bound, use the reserved word min.
stopstop
<numeric_value>|<date/time_value><numeric_value>|<date/time_value>
Valor final del intervalo.End value for the range.
Para especificar que el rango no tiene límite superior, use la palabra reservada max.To specify that the range has no upper bound, use the reserved word max.
fromfrom
GE|GTGE|GT
Parámetro opcional que indica el intervalo de inicio de apertura o cierre.Optional parameter that indicates the open or close start interval.
Valores válidos:Valid values:
  • GE: superior o igual al valor de inicio (>= inicio del intervalo).GE Greater than or equal to the start value (>= start of interval).
  • GT: superior al valor de inicio (> inicio del intervalo).GT Greater than the start value (> start of interval).
Valor predeterminado: GEDefault: GE
toto
LE|LTLE|LT
Parámetro opcional que indica el intervalo de finalización de apertura o cierre.Optional parameter that indicates the open or close end interval.
Valores válidos:Valid values:
  • LE: inferior o igual al valor de finalización (>= fin del intervalo).LE Less than or equal to the end value (<= end of interval).
  • LT: inferior al valor de finalización (< fin del intervalo).LT Less than the end value (< end of interval).
Valor predeterminado: LTDefault: LT

EjemplosExamples

La expresión siguiente ofrece resultados que coinciden con una propiedad de descripción que empieza por la frase "big accomplishments" y que aparece en elementos que tienen 10.000 bytes como mínimo.The following expression matches a description property starting with the phrase "big accomplishments" appearing in items with a size of at least 10 000 bytes.

and(size:range(10000, max), description:starts-with("big accomplishments"))

STARTS-WITHSTARTS-WITH

Especifica una palabra o frase que deben aparecer al principio de una propiedad administrada.Specifies a word or phrase that must appear at the start of a managed property.

SintaxisSyntax

starts-with(<term or phrase>)

ParámetrosParameters

No procede.Not applicable.

EjemplosExamples

La expresión siguiente ofrece elementos con los valores "Adam Jones sr" y "Adam Jones" en la propiedad administrada author. No mostrará resultados con el valor "Mr Adam Jones".The following expression will match items with the values "Adam Jones sr" and "Adam Jones" in the author managed property. It will not match items with the value "Mr Adam Jones".

author:starts-with("adam jones")

ComentariosRemarks

Si quiere más información sobre la coincidencia de límites, vea ENDS-WITH.For additional remarks on boundary matching, see ENDS-WITH.

STRINGSTRING

Define una condición booleana coincidente para una cadena de texto.Defines a Boolean matching condition to a text string.

El operando es una cadena de texto (uno o varios términos) que hay que encontrar. La cadena está seguida por cero o más parámetros.The operand is a text string (one or more terms) that is to be matched. The string is followed by zero or more parameters.

El operador STRING también se puede usar como conversión de tipo. La consulta string("24.5"), por ejemplo, tratará el valor numérico "24.5" como cadena de texto.The STRING operator can also be used as a type conversion. The query string("24.5"), for example, will treat the numeric value "24.5" as a text string.

SintaxisSyntax

string("<text string>"

[, mode=<mode>]

[, n=<near>]

[, weight=<n>]

[, linguistics=<on|off>]

[, wildcard=<on|off>])

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
modemode
<mode><mode>
El parámetro mode especifica cómo evaluar el valor <text string>.The mode parameter specifies how to evaluate the <text string> value. En la siguiente lista se muestran los valores válidos.The following list shows valid values.
"PHRASE" - phrase(term [,term]*)"PHRASE" - phrase(term [,term]*)
ModeModeExpresión de operador equivalenteEquivalent operator expression
"PHRASE""PHRASE" phrase(term [,term]*)
"AND""AND" and(term, term [,term]*)
"OR""OR" or(term, term [,term]*)
"ANY""ANY" any(term, term [,term]*)
"NEAR""NEAR" near(term, term [,term]*, N)
"ONEAR""ONEAR" onear(term, term [,term]*, N)

Valor predeterminado: "PHRASE"Default: "PHRASE"
nn
<numeric_value><numeric_value>
Este parámetro indica la distancia máxima entre términos para mode= "NEAR" o mode= "ONEAR".This parameter indicates the maximum term distance for mode= "NEAR" or mode= "ONEAR".
Las expresiones siguientes son equivalentes:The following expressions are equivalent:
string("hello world", mode="NEAR", n=5)
near(hello, world, n=5)
Valor predeterminado: 4Default: 4
weightweight
<numeric_value><numeric_value>
Este parámetro es un valor numérico positivo que indica el peso del término para la clasificación dinámica.This parameter is a positive numeric value indicating term weight for dynamic ranking.
Un valor pequeño indica que un término debe contribuir menos a la clasificación. Un valor mayor indica que debe contribuir más a la clasificación. Un valor de cero en el parámetro del peso especifica que un término no debe afectar a la clasificación dinámica.A lower value indicates that a term should contribute less to the ranking. A higher value indicates that a term should contribute more to the ranking. A value of zero for the weight parameter specifies that a term should not affect dynamic rank.
El parámetro weight se aplica a todos los términos de la expresión STRING.The weight parameter applies to all the terms in the STRING expression.
SUGERENCIA: El parámetro del peso afecta solo a las consultas de índice de texto completo.TIP: The weight parameter will affect only full-text index queries. Valor predeterminado: 100.Default: 100.
linguisticslinguistics
on|offon|off
Habilita o deshabilita todas las características lingüísticas de la cadena (lematización, sinónimos, comprobación de la ortografía) si están habilitadas para la consulta.Disables/enables all linguistics features for the string (lemmatization, synonyms, spelling checking) if they are enabled for the query.
Puede usar este parámetro para desactivar el procesamiento lingüístico en un término o una cadena concretos y que estos sigan contribuyendo a la clasificación.You can use this parameter to switch off linguistic processing for a given term or string while you still want the term or string to contribute to ranking.
Valor predeterminado: "ON"Default: "ON"
wildcardwildcard
on|offon|off
Este parámetro controla la expansión de caracteres comodín de los términos dentro de <text string>.This parameter controls wildcard expansion of terms inside the <text string>. Esta opción invalida las opciones de caracteres comodín que hay en los parámetros de consulta y permite que se habiliten o deshabiliten los caracteres comodín en ciertas partes de la consulta.This setting overrides any wildcard settings in query parameters, and allows extended wildcard characters to be enabled or disabled on specific parts of the query.
Los valores válidos son los siguientes:The following are valid values:
  • "ON" Especifica que el carácter "*" se evalúa como carácter comodín."ON" Specifies that the character "*" is evaluated as wildcard. El carácter "*" coincide con cero o más caracteres.A "*" character matches zero or more characters.
  • "OFF" Especifica que el carácter "*" no se evalúa como carácter comodín."OFF" Specifies that the characters "*" is not evaluated as wildcard.
Valor predeterminado: "ON"Default: "ON"

Nota

En SharePoint, los parámetros minexpansion, maxexpansion y annotation_class del operador STRING están obsoletos.In SharePoint the minexpansion, maxexpansion and annotation_class parameters for the STRING operator are obsolete.

EjemplosExamples

Ejemplo 1. Como el modo de cadena predeterminado es " PHRASE ", todas las expresiones siguientes devuelven los mismos resultados.Example 1. Because the default string mode is " PHRASE ", each of the following expressions returns the same results.

"what light through yonder window breaks"string("what light through yonder window breaks")string("what light through yonder window breaks", mode="phrase")phrase(what, light, through, yonder, window, breaks)

Ejemplo 2. La siguiente expresión de token de cadena y la expresión del operador AND devuelven los mismos resultados.Example 2. The following string token expression and the AND operator expression return the same results.

string("cat dog fox", mode="and")and(cat, dog, fox)

Ejemplo 3. La siguiente expresión de token de cadena y la expresión del operador OR devuelven los mismos resultados.Example 3. The following string token expression and OR operator expression return the same results.

string("coyote saguaro", mode="or")or(coyote, saguaro)

Ejemplo 4. La siguiente expresión de token de cadena y la expresión del operador ANY devuelven los mismos resultados.Example 4. The following string token expression and ANY operator expression return the same results.

string("coyote saguaro", mode="any")any(coyote, saguaro)

Ejemplo 5. La siguiente expresión de token de cadena y la expresión del operador NEAR devuelven los mismos resultados.Example 5. The following string token expression and NEAR operator expression return the same results.

string("coyote saguaro", mode="near")near(coyote, saguaro)

Ejemplo 6. La siguiente expresión de token de cadena y la expresión del operador NEAR devuelven los mismos resultados.Example 6. The following string token expression and NEAR operator expression return the same results.

string("cat dog fox wolf", mode="near", N=4)near(cat, dog, fox, wolf, N=4)

Ejemplo 7. La siguiente expresión de token de cadena y la expresión del operador ONEAR devuelven los mismos resultados.Example 7. The following string token expression and ONEAR operator expression return the same results.

string("cat dog fox wolf", mode="onear")onear(cat, dog, fox, wolf)

Ejemplo 8. La siguiente expresión de token de cadena ofrece como resultado la palabra "nobler" con las funciones lingüísticas deshabilitadas para que no se muestren otras formas de la palabra (como "ennobling") por la lematización.Example 8. The following string token expression matches the word "nobler" with linguistic features disabled, so other forms of the word (such as "ennobling") are not matched by using stemming.

string("nobler", linguistics="off")

Ejemplo 9. La expresión siguiente ofrece como resultado elementos que contienen "cat" o "dog ", pero la expresión aumenta la clasificación dinámica de elementos que contiene "dog" más que los elementos que contienen "cat".Example 9. The following expression matches items that contain either "cat" or "dog ", but the expression increases the dynamic rank of items that contain "dog" more than items that contain "cat".

or(string("cat", weight="200"), string("dog", weight="500"))

ComentariosRemarks

Peso de relevancia en la clasificación dinámicaRelevance weight for dynamic ranking

El principal efecto del parámetro weight se ejerce en las consultas OR, aunque también puede tener algún efecto en las consultas AND. El algoritmo de clasificación dinámica puede implicar que términos distintos ofrezcan contribuciones de clasificación diferentes en función del lugar del elemento donde aparezca la coincidencia de término.The main effect of the weight parameter is for OR queries. It can also have some effect on AND queries. The dynamic rank algorithm can imply that different terms give different rank contribution depending on where in the item the term match occurs.

La diferencia en la contribución de clasificación también se puede basar en la frecuencia del término y en la frecuencia inversa del elemento. Lo siguiente es un ejemplo:The difference in rank contribution can also be based on term frequency and inverse item frequency. The following is an example:

  • Consulta: and(string("a"), string("b", weight=200))Query: and(string("a"), string("b", weight=200))

  • Esquema de índice: la propiedad administrada title tiene más peso que la propiedad administrada body.Index schema: The title managed property has more weight than the body managed property.

  • El elemento de índice 1 incluye el término "a" en el título y el término "b" en el cuerpo.Index item 1 includes term 'a' in the title and term 'b' in the body.

  • El elemento de índice 2 incluye el término "a" en el cuerpo y el término "b" en el título.Index item 2 includes term 'a' in the body and term 'b' in the title.

En este ejemplo, el elemento 2 tiene la clasificación total más alta, ya que los elementos con mayor contribución de clasificación dinámica se incrementarán todavía más.In this example, item 2 will get the highest total rank, as the items with higher dynamic rank contribution will get even more boost.

Sugerencia: El aumento del término relativo (positivo o negativo) se aplica al componente de clasificación dinámica de la clasificación total,Tip: The relative term boost (positive or negative) is applied to the dynamic rank component of the total rank. pero los cálculos de clasificación del aumento de proximidad (la distancia entre palabras) no se ven afectados por la ponderación de términos.However, proximity boost (distance between words) rank calculations are not affected by the term weighting. La ponderación relativa no siempre implica que se modifique la clasificación total del elemento según el porcentaje indicado.The relative weighting does not always imply that the total rank for the item is modified according to the percentage given. > Con la consulta siguiente buscamos los términos "peter", "paul" o "mary", donde "peter" tendrá el doble de contribución de clasificación que los otros dos términos.> The following query will search for the terms "peter", "paul", or "mary", where "peter" will have twice as much rank contribution as the two other terms. > or(peter, string("paul mary", mode="OR", weight=50))

Control de cadenas con caracteres especialesHandling strings with special characters

Los caracteres especiales como la coma (","), el punto y coma (";"), los dos puntos (":"), el punto ("."), el menos ("-"), el subrayado ("") o la barra diagonal ("/") se tratan como espacios en blanco dentro de una expresión de cadena encerrada entre comillas dobles. Esto se debe al proceso de ajuste por token. Estos caracteres también implican una formulación implícita de los tokens separados por estos caracteres.Special characters such as comma (","), semicolon (";"), colon (":"), period ("."), minus ("-"), underline (""), or forward slash ("/") are treated as white space inside a string expression enclosed in double quotation marks. This is related to the tokenization process. These characters also imply an implicit phrasing of the tokens separated by these characters.

Las expresiones de consulta siguientes son equivalentes:The following query expressions are equivalent.

title:string("animals birds", mode="phrase")title:"animals/birds"title:string("animals/birds", mode="and")title:string("animals/birds", mode="or")

Las expresiones de consulta siguientes son equivalentes:The following query expressions are equivalent.

title:or(string("animals birds", mode="phrase"), string("animals insects", mode="phrase"))title:string("animals/birds animals/insects", mode="or")

Las expresiones de consulta siguientes son equivalentes:The following query expressions are equivalent.

body:string("help contoso com", mode="phrase")body:string("help@contoso.com")

Coincidencia de frases con ajuste por tokenTokenized phrase matching

Puede buscar una cadena de tokens exacta usando el operador STRING con mode="phrase" o con el operador PHRASE.You can search for an exact string of tokens by using the STRING operator with mode="phrase" or the PHRASE operator.

Todas estas operaciones de frase implican una coincidencia de frase con tokens.All such phrase operations imply a tokenized phrase match. Esto quiere decir que los caracteres especiales como la coma (","), el punto y coma (";"), los dos puntos (":"), el carácter de subrayado ("_"), el signo menos ("-") o la barra diagonal ("/") se tratan como espacios en blanco.This means that special characters such as comma (" , "), semicolon (" ; "), colon (" : "), underscore (" _ "), minus (" - "), or forward slash (" / ") are treated as white space. Esto está relacionado con el proceso de tokenización.This is related to the tokenization process.

XRANKXRANK

Aumenta la clasificación dinámica de los elementos según las repeticiones de ciertas términos dentro de la match expression sin cambiar qué elementos coinciden con la consulta. Una expresión XRANK consta un componente que debe coincidir, la match expression y uno o varios componentes que contribuyen solo a la clasificación dinámica, la rank expression. Al menos uno de los parámetros, excepto n, debe especificarse para que una expresión XRANK sea válida.Boosts the dynamic rank of items based on certain term occurrences within the match expression, without changing which items match the query. An XRANK expression consists of one component that must be matched, the match expression, and one or more components that contribute only to dynamic ranking, the rank expression. At least one of the parameters, excluding n, must be specified for an XRANK expression to be valid.

Las Match expressions pueden ser cualquier expresión FQL válida, incluidas las expresiones XRANK anidadas. Las Rank expressions pueden ser cualquier expresión FQL válida sin expresiones XRANK. Si sus consultas FQL tienen varios operadores XRANK, el valor de la clasificación dinámica final se calcula como una suma de aumentos entre todos los operadores XRANK.Match expressions may be any valid FQL expression, including nested XRANK expressions. Rank expressions may be any valid FQL expression without XRANK expressions. If your FQL queries have multiple XRANK operators, the final dynamic rank value is calculated as a sum of boosts across all XRANK operators.

Nota

En SharePoint Server 2010, el operador XRANK tenía dos parámetros: boost y boostall, además de la siguiente sintaxis: xrank(operand, rank-operand [, rank-operand]* [,boost=n] [,boostall=yes]).In SharePoint Server 2010, the XRANK operator had two parameters: boost and boostall, as well as the following syntax: xrank(operand, rank-operand [, rank-operand]* [,boost=n] [,boostall=yes]). Esta sintaxis y sus parámetros están en desuso en SharePoint.This syntax along with its parameters is deprecated in SharePoint. Le recomendamos que use la sintaxis y los parámetros nuevos.We recommend the use of the new syntax and parameters instead.

SintaxisSyntax

xrank(<match expression> [, <rank-expression>]*, rank-parameter[, rank-parameter]*)

FórmulaFormula

Fórmula del operador XRANK

ParámetrosParameters

ParámetroParameter ValorValue DescripciónDescription
NN
<integer_value><integer_value>
Especifica el número de resultados de los que se deben calcular las estadísticas.Specifies the number of results to compute statistics from.
Este parámetro no afecta el número de resultados al que contribuye la clasificación dinámica; es solo un medio de excluir elementos irrelevantes de los cálculos de estadísticas.This parameter does not affect the number of results that the dynamic rank contributes to; it is just a means to exclude irrelevant items from the statistics calculations.
Valor predeterminado: *0*. Un valor cero significa *todos los documentos* . Default: 0. A zero value carries the sematic of all documents .
NbNb
<float_value><float_value>
El parámetro nb se refiere al aumento normalizado. Este parámetro especifica el factor que se multiplica con el producto de la puntuación promedio y de variación de los valores de clasificación del conjunto de resultados.The nb parameter refers to normalized boost. This parameter specifies the factor that is multiplied with the product of the variance and average score of the rank values of the results set.
f en la fórmula XRANK.f in the XRANK formula.

Normalmente, el aumento normalizado, nb, es el único parámetro que se modifica. Este parámetro proporciona el control necesario para promover o degradar un elemento determinado sin tener en cuenta la desviación estándar.Typically normalized boost, nb, is the only parameter that is modified. This parameter provides the necessary control to promote or demote a particular item, without taking standard deviation into account.

Parámetros avanzadosAdvanced parameters

Los siguientes parámetros avanzados también están disponibles, aunque no suelen usarse.The following advanced parameters are also available. However, typically they aren't used.

ParámetroParameter ValorValue DescripciónDescription
cbcb
<float_value><float_value>
El parámetro cb hace referencia a un aumento constante.The cb parameter refers to constant boost.
Valor predeterminado: 0.Default: 0.
a en la fórmula XRANK.a in the XRANK formula.
stdbstdb
<float_value><float_value>
El parámetro stdb hace referencia a un aumento de la desviación estándar.The stdb parameter refers to standard deviation boost.
Valor predeterminado: 0.Default: 0.
e en la fórmula XRANK.e in the XRANK formula.
avgbavgb
<float_value><float_value>
El parámetro avgb hace referencia a un aumento medio. Este factor se multiplica por el valor de clasificación media del conjunto de resultados.The avgb parameter refers to average boost. This factor is multiplied with the average rank value of the results set.
Valor predeterminado: 0.Default: 0.
d en la fórmula XRANK.d in the XRANK formula.
rbrb
<float_value><float_value>
El parámetro rb hace referencia a un aumento del rango. Este factor se multiplica por el rango de los valores de clasificación del conjunto de resultados.The rb parameter refers to range boost. This factor is multiplied with the range of rank values in the results set.
Valor predeterminado: 0.Default: 0.
b en la fórmula XRANK.b in the XRANK formula.
pbpb
<float_value><float_value>
El parámetro pb se refiere al aumento de porcentaje. Este factor se multiplica por la propia clasificación del elemento en comparación con el valor mínimo del corpus.The pb parameter refers to percentage boost. This factor is multiplied with the item's own rank compared to the minimum value in the corpus.
Valor predeterminado: 0.Default: 0.
c en la fórmula XRANK.c in the XRANK formula.

EjemplosExamples

Ejemplo 1. La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat" o "dog". La expresión incrementa la clasificación dinámica de aquellos elementos con un incremento constante de 100 para elementos que también contienen "thoroughbred".Example 1. The following expression matches items for which the default full-text index contains either "cat" or "dog". The expression increases dynamic rank of those items with a constant boost of 100 for items that also contain "thoroughbred".

xrank(or(cat, dog), thoroughbred, cb=100)

Ejemplo 2. La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat" o "dog". La expresión incrementa la clasificación dinámica de aquellos elementos con un incremento normalizado de 1,5 para elementos que también contienen "thoroughbred".Example 2. The following expression matches items for which the default full-text index contains either "cat" or "dog". The expression increases dynamic rank of those items with a normalized boost of 1.5 for items that also contain "thoroughbred".

xrank(or(cat, dog), thoroughbred, nb=1.5)

Ejemplo 3. La siguiente expresión ofrece como resultados los elementos cuyo índice de texto completo predeterminado contiene "cat" o "dog". La expresión incrementa la clasificación dinámica de aquellos elementos con un incremento constante de 100 y un incremento normalizado de 1,5 para elementos que también contienen "thoroughbred".Example 3. The following expression matches items for which the default full-text index contains either "cat" or "dog". The expression increases dynamic rank of those items with a constant boost of 100 and a normalized boost of 1.5, for items that also contain "thoroughbred".

xrank(or(cat, dog), thoroughbred, cb=100, nb=1.5)

Ejemplo 4. La siguiente expresión ofrece como resultados todos los elementos que contienen el término "animals" y aumenta la clasificación dinámica de la siguiente manera:Example 4. The following expression matches all items containing the term "animals", and boosts dynamic rank as follows:

  • La clasificación dinámica de los elementos que contienen el término "dogs" aumenta 100 puntos.Dynamic rank of items that contain the term "dogs" is boosted by 100 points.

  • La clasificación dinámica de los elementos que contienen el término "cats" aumenta 200 puntos.Dynamic rank of items that contain the term "cats" is boosted by 200 points.

  • La clasificación dinámica de los elementos que contienen tanto "dogs" como "cats" aumenta 300 puntos.Dynamic rank of items that contain both the terms "dogs" and "cats" is boosted by 300 points.

xrank(xrank(animals, dogs, cb=100), cats, cb=200)

Vea tambiénSee also