CONTAINS, prédicat dans la syntaxe SQL de recherche SharePoint

Article
09/18/2014

Dernière modification : mercredi 21 avril 2010

S’applique à : SharePoint Server 2010

Partie de la clause WHERE qui prend en charge la recherche de mots et d'expressions dans des colonnes de texte.

…CONTAINS([<full-text_column>,]'<contains_condition>'[,<LCID>])…

Remarques

Le prédicat CONTAINS comporte des fonctionnalités pour trouver des mots ou différentes inflexions des mots, ou effectuer des recherches à l'aide de caractères génériques ou en utilisant la notion de proximité. Le prédicat CONTAINS convient mieux pour les correspondances exactes, contrairement au prédicat FREETEXT, qui est mieux adapté à la recherche de documents contenant des combinaisons des mots recherchés qui sont répartis dans toute la colonne.

La référence de colonne de texte intégral est facultative. Elle permet de spécifier une seule colonne ou un groupe de colonnes pour tester le prédicat CONTAINS. Lorsque la colonne de texte intégral est spécifiée avec « ALL » ou avec « * », la recherche porte sur toutes les propriétés du texte indexé. Bien que la colonne ne soit pas obligatoirement une propriété de texte, les résultats risquent de ne pas avoir de sens si la colonne contient un autre type de données. Le nom de la colonne peut être un identificateur normal ou délimité et vous devez le séparer de la condition à l'aide d'une virgule. Si vous ne spécifiez pas de colonne de texte intégral, c'est la colonne Contenu, représentant le corps du document, qui est utilisée.

Vous pouvez également spécifier la référence de colonne de texte intégral avec un astérisque (*) afin d'indiquer toutes les colonnes.

Vous pouvez spécifier les paramètres régionaux de la recherche pour le prédicat CONTAINS, afin que le moteur de recherche utilise le séparateur de mots, la liste de mots parasites, les formes d'inflexion et l'ordre de tri appropriés pour la requête de recherche. Pour spécifier les paramètres régionaux, indiquez l'identificateur LCID Microsoft Windows standard. Par exemple, 1036 est le LCID du français de France. Le LCID doit être le dernier élément placé dans les parenthèses de la clause CONTAINS. Vous trouverez des informations importantes sur la recherche et les langues dans la rubrique Utilisation de recherches localisées dans Informations sur le langage de requête SQL de la recherche SharePoint.

Notes

Les paramètres régionaux par défaut pour la recherche sont ceux du système.

Vous devez placer la partie CONTAINS de la condition entre des guillemets simples pour des mots uniques ou entre des guillemets doubles pour des expressions ; elle doit en outre comporter un ou plusieurs termes de recherche qui sont combinés à l'aide des opérateurs logiques AND ou OR. Vous pouvez utiliser l'opérateur unaire facultatif NOT pour inverser la valeur logique d'un terme de recherche de contenu.

NOT ne peut être placé qu'après AND. Vous ne pouvez pas utiliser l'opérateur NOT s'il n'y a qu'une seule condition de correspondance, ni le placer après l'opérateur OR.

Vous pouvez utiliser des parenthèses pour regrouper et imbriquer des termes de recherche de contenu. Le tableau suivant indique l'ordre de priorité des opérateurs logiques.

Ordre de priorité	Opérateur logique
Premier (niveau le plus élevé)	NOT
Deuxième	AND
Troisième (niveau le plus bas)	OR

Les opérateurs logiques du même type sont associatifs et il n'y a pas d'ordre de calcul spécifique. Par exemple, (A AND B) AND (C AND D) peut être calculé ainsi : (B AND C) AND (A AND D), sans que cela change le résultat logique.

Le tableau suivant décrit les types de termes de recherche de contenu.

Type	Description	Exemples
Mot	Un seul mot, sans espaces ni autres signes de ponctuation. Les guillemets doubles ne sont pas nécessaires.	…WHERE CONTAINS ('computer')
Expression	Plusieurs mots ou espaces inclus.	…WHERE CONTAINS ('computer software') Ou, pour inclure des guillemets doubles : … WHERE CONTAINS('computer ""science""')
Caractère générique	Mots ou expressions avec l'astérisque (*) ajouté à la fin. Pour plus d'informations, voir Utilisation de caractères génériques dans le prédicat CONTAINS dans la syntaxe SQL de recherche SharePoint.	…WHERE CONTAINS ('"compu*"') Trouve « computer », « computers », « computation » et « compulsory ».
Booléen	Chaînes de mots, expressions et caractères génériques combinés à l'aide des opérateurs booléens AND, OR ou NOT. Placez les termes booléens dans des guillemets doubles.	…WHERE CONTAINS ('computer monitor' AND 'software program' AND 'install component') … WHERE CONTAINS ('computer' AND 'software' AND 'install') …WHERE CONTAINS ('computer software install')
Near	Mots, expressions ou caractères génériques séparés par la fonction NEAR. Pour plus d'informations, voir Terme NEAR dans la syntaxe SQL de la recherche SharePoint.	…WHERE CONTAINS ('computer' NEAR 'software')
FormsOf	Trouve un mot et les autres inflexions de ce mot. Pour plus d'informations, voir FORMSOF, terme dans la syntaxe SQL de recherche SharePoint.	…WHERE CONTAINS ('FORMSOF (INFLECTIONAL, "happy")) Trouve « happy », « happier », « happiest », « happily », etc.
IsAbout	Combine les résultats trouvés pour plusieurs termes de recherche de mots, d'expressions ou de caractères génériques. Pour plus d'informations, voir ISABOUT, terme dans la syntaxe SQL de recherche SharePoint.	…WHERE CONTAINS ('ISABOUT ( "computer","software","development") ')