Predicado FREETEXT de la sintaxis SQL de Windows SharePoint Services Search
Parte de la cláusula WHERE que admite la búsqueda de palabras y frases en columnas de texto.
FREETEXT
([<full-text_column>,]'<freetext_condition>'[,<LCID>])…
Comentarios
El predicado FREETEXT sirve para encontrar documentos que contengan combinaciones de las palabras de la búsqueda repartidas en toda la columna. Por el contrario, el predicado CONTAINS sirve para encontrar coincidencias "exactas". También puede realizar búsquedas de frase exacta con el predicado FREETEXT si la frase entre comillas dobles.
La referencia de columna de texto completo es opcional. Por motivos de relevancia, se recomienda especificar aquí DEFAULTPROPERTIES. Por ejemplo:
…WHERE FREETEXT(DEFAULTPROPERTIES, 'computer software')
Como alternativa, puede especificar una única columna o un alias de grupo de columnas con respecto a los cuales se probará el predicado FREETEXT. Se buscarán todas las propiedades de texto indizadas. Aunque no es obligatorio que la columna sea una propiedad de texto, los resultados podrían carecer de sentido si la columna es de algún otro tipo de datos. El nombre de la columna puede ser un identificador habitual o delimitado, y se debe separar de la condición mediante una coma. Si no se proporciona ninguna condición de texto completo, se usará la columna Contenido, que es el cuerpo del documento.
También puede especificar la referencia de columna de texto completo con un asterisco (*), que indica que se usarán todas las columnas.
Se puede especificar la configuración regional de la búsqueda para el predicado FREETEXT. Esto indica al motor de búsqueda que use el separador de palabras adecuado, la lista de palabras irrelevantes, las flexiones de las palabras y el criterio de ordenación para la consulta de búsqueda. Para especificar la configuración regional, se debe proporcionar el identificador de configuración regional estándar de Microsoft Windows, también conocido como LCID. Por ejemplo, 1033 es el LCID para Estados Unidos-Inglés. Coloque el LCID como el último elemento dentro de los paréntesis de la cláusula FREETEXT. Para obtener información importante sobre la búsqueda y los idiomas, consulte la sección sobre uso de búsquedas localizadas en Información acerca del lenguaje de consulta SQL de la búsqueda de Windows SharePoint Services.
Nota
La configuración regional predeterminada de la búsqueda es la configuración regional predeterminada del sistema.
Debe escribir la parte <condición_de_freetext> entre comillas sencillas y ésta debe estar compuesta de uno o más términos de búsqueda. El predicado FREETEXT no admite operaciones lógicas. Para buscar una frase como si fuera una única palabra, escriba la frase entre comillas dobles.
El comportamiento predeterminado del predicado FREETEXT es que la consulta devuelva documentos en los que se cumpla lo siguiente:
El documento contiene todos los términos de la búsqueda en al menos una de las columnas especificadas.
Uno de los términos de la búsqueda también debe encontrarse en la columna Contenido, que es la propiedad que contiene el cuerpo del documento.
No es necesario que los términos aparezcan en un determinado orden. Los documentos que contienen un mayor número de los términos de búsqueda podrían tener valores de columna de una clasificación superior.
Importante
Se recomienda usar solamente un predicado FREETEXT en una consulta de búsqueda. Si usa varias instancias, la consulta se ejecutará sin errores, pero la clasificación de los resultados no será óptima.
El predicado FREETEXT también admite los caracteres de inclusión "+" y de exclusión "-", y estos usan las mismas reglas de coincidencia que la sintaxis de palabras clave. Para obtener información sobre las reglas de coincidencia, consulte Inclusión y exclusión de sintaxis de palabra clave de Búsqueda de Windows SharePoint Services.
Ejemplos
El siguiente ejemplo busca documentos que contengan las palabras "equipo", "software" y "hardware".
…WHERE FREETEXT('computer software hardware')
Nota
El comportamiento es distinto del funcionamiento que tenía el predicado FREETEXT en SharePoint Portal Server 2003.
Se puede usar una coincidencia de una única palabra y una frase en el mismo predicado FREETEXT. El siguiente ejemplo busca documentos que contengan la palabra "software" y la frase "hardware de equipo".
…FREETEXT('software "computer hardware"')
Al realizar consultas con contracciones y usar el predicado FREETEXT, debe excluir las comillas en la contracción; esto no es necesario cuando se usa el predicado CONTAINS.
Por ejemplo, la siguiente sintaxis produce un error:
…WHERE FREETEXT(*,'"We'll always have Paris"')
La sintaxis correcta incluye dos comillas sencillas.
La siguiente sintaxis es correcta:
…WHERE FREETEXT(*,'"We''ll always have Paris"')
El siguiente ejemplo busca documentos que contengan los términos de búsqueda "hardware" y "store" (almacén) y que no contengan el término de búsqueda "computer" (equipo).
…WHERE FREETEXT(DEFAULTPROPERTIES, 'hardware store -computer')
Nota
Los filtros de propiedad no se admiten con el predicado FREETEXT.
El siguiente ejemplo no buscará documentos en los que la propiedad author contenga el término de búsqueda "John"; en lugar de ello, buscará documentos que contengan los términos de búsqueda "author" (autor), "John", "computer" (equipo), "hardware".
WHERE FREETEXT(DEFAULTPROPERTIES, 'author:John computer hardware')
El siguiente ejemplo buscará documentos en los que la propiedad author contenga el término de búsqueda "John" y que los términos de búsqueda "computer" (equipo) y "hardware" se encuentren en algún otro lugar del documento.
…WHERE CONTAINS(author, 'John') AND FREETEXT(DEFAULTPROPERTIES, 'computer hardware')
Nota
La clasificación de resultados de esta consulta se basa únicamente en el predicado FREETEXT.
En esta sección
Vea también
Otros recursos
Predicado CONTAINS en la sintaxis SQL de Windows SharePoint Services Search
Predicado de alias de grupo WITH -- AS de la sintaxis SQL de la búsqueda de Windows SharePoint Services