CREATE SEARCH PROPERTY LIST (Transact-SQL)

  • Article

Crée une liste de propriétés de recherche. Une liste de propriétés de recherche permet de spécifier une ou plusieurs propriétés de recherche que vous souhaitez inclure dans un index de recherche en texte intégral.

Important

CREATE SEARCH PROPERTY LIST, ALTER SEARCH PROPERTY LIST et DROP SEARCH PROPERTY LIST sont uniquement pris en charge avec le niveau de compatibilité 110. Ces instructions ne sont pas prises en charge avec un niveau de compatibilité inférieur.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

CREATE SEARCH PROPERTY LIST new_list_name
   [ FROM [ database_name. ] source_list_name ]
   [ AUTHORIZATION owner_name ]
;

Arguments

  • new_list_name
    Nom de la nouvelle liste des propriétés de recherche. new_list_name est un identificateur avec un maximum de 128 caractères. new_list_name doit être unique parmi toutes les listes de propriétés dans la base de données actuelle et se conformer aux règles pour les identificateurs. new_list_name sera utilisé une fois que l'index de texte intégral aura été créé.

  • database_name
    Nom de la base de données dans laquelle se trouve la liste de propriétés spécifiée par source_list_name. Si aucun nom n'est spécifié, database_name correspond par défaut à la base de données actuelle.

    database_name doit spécifier le nom d'une base de données existante. Le compte de la connexion actuelle doit être associé à un ID d'utilisateur existant dans la base de données spécifiée par database_name. Vous devez également disposer des autorisations requises sur la base de données.

  • source_list_name
    Spécifie que la nouvelle liste de propriétés est créée en copiant une liste de propriétés existante à partir de database_name. Si source_list_name n'existe pas, CREATE SEARCH PROPERTY LIST se solde par une erreur. Les propriétés de recherche dans source_list_name sont héritées par new_list_name.

  • AUTHORIZATION owner_name
    Spécifie le nom d'un utilisateur ou d'un rôle pour détenir la liste de propriétés. owner_name doit être le nom d'un rôle dont l'utilisateur actuel est membre ou l'utilisateur actuel doit avoir l'autorisation IMPERSONATE sur owner_name. En l'absence de spécification, la propriété revient à l'utilisateur actuel.

    [!REMARQUE]

    Il est possible de modifier le propriétaire en utilisant l'instruction ALTER AUTHORIZATION Transact-SQL.

Notes

[!REMARQUE]

Pour obtenir des informations générales sur les listes de propriétés, consultez Rechercher les propriétés du document à l'aide des listes de propriétés de recherche.

Par défaut, une nouvelle liste des propriétés de recherche est vide et vous devez la modifier pour ajouter une ou plusieurs propriétés de recherche manuellement. Vous pouvez également copier une liste de propriétés de recherche existante. Dans ce cas, la nouvelle liste hérite des propriétés de recherche de sa source, mais vous pouvez modifier la nouvelle liste pour ajouter ou supprimer des propriétés de recherche. Toutes les propriétés figurant dans la liste des propriétés de recherche au moment du remplissage complet suivant sont incluses dans l'index de recherche en texte intégral.

Une instruction CREATE SEARCH PROPERTY LIST échoue si l'une des conditions suivantes se présente :

  • Si la base de données spécifiée par database_name n'existe pas.

  • Si la liste spécifiée par source_list_name n'existe pas.

  • Si vous ne possédez pas les autorisations appropriées.

Pour ajouter ou supprimer des propriétés dans une liste

Autorisations

Requiert des autorisations CREATE FULLTEXT CATALOG dans la base de données actuelle et des autorisations REFERENCES sur toute base de données depuis laquelle vous copiez une liste de propriétés source.

[!REMARQUE]

L'autorisation REFERENCES est obligatoire pour associer la liste à un index de recherche en texte intégral. L'autorisation CONTROL est obligatoire pour ajouter et supprimer des propriétés ou supprimer la liste. Le propriétaire d'une liste de propriétés peut accorder des autorisations REFERENCES ou CONTROL sur la liste. Les utilisateurs disposant de l'autorisation CONTROL peuvent également accorder l'autorisation REFERENCES à d'autres utilisateurs.

Exemples

A.Création d'une liste de propriétés vide et association à un index

L'exemple suivant crée une nouvelle liste de propriétés de recherche nommée DocumentPropertyList. L'exemple utilise ensuite une instruction ALTER FULLTEXT INDEX pour associer la nouvelle liste de propriétés à l'index de recherche en texte intégral de la table Production.Document dans la base de données AdventureWorks, sans démarrer un remplissage.

[!REMARQUE]

Pour obtenir un exemple qui ajoute plusieurs propriétés de recherche prédéfinies et bien connues à cette liste de propriétés de recherche, consultez ALTER SEARCH PROPERTY LIST (Transact-SQL). Après avoir ajouté des propriétés de recherche à la liste, l'administrateur de base de données devra utiliser une autre instruction ALTER FULLTEXT INDEX avec la clause START FULL POPULATION.

CREATE SEARCH PROPERTY LIST DocumentPropertyList;
GO
USE AdventureWorks;
ALTER FULLTEXT INDEX ON Production.Document 
   SET SEARCH PROPERTY LIST DocumentPropertyList
   WITH NO POPULATION; 
GO

B.Création d'une liste de propriétés à partir d'une liste existante

L'exemple suivant crée une nouvelle liste de propriétés de recherche, JobCandidateProperties, à partir de la liste créée par l'exemple A, DocumentPropertyList, associée à un index de recherche en texte intégral dans la base de données AdventureWorks. L'exemple utilise ensuite une instruction ALTER FULLTEXT INDEX pour associer la nouvelle liste de propriétés à l'index de recherche en texte intégral de la table HumanResources.JobCandidate dans la base de données AdventureWorks. Cette instruction ALTER FULLTEXT INDEX entraîne un remplissage complet, ce qui correspond au comportement par défaut de la clause SET SEARCH PROPERTY LIST.

CREATE SEARCH PROPERTY LIST JobCandidateProperties FROM AdventureWorks.DocumentPropertyList;
GO
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate 
   SET SEARCH PROPERTY LIST JobCandidateProperties;
GO

Voir aussi

Référence

ALTER SEARCH PROPERTY LIST (Transact-SQL)

DROP SEARCH PROPERTY LIST (Transact-SQL)

sys.registered_search_properties (Transact-SQL)

sys.registered_search_property_lists (Transact-SQL)

sys.dm_fts_index_keywords_by_property (Transact-SQL)

Concepts

Rechercher les propriétés du document à l'aide des listes de propriétés de recherche

Recherche des GUID du jeu de propriétés et des ID d'entier de propriétés pour les propriétés de recherche