Delen via

MAAK ZOEKPROPERTY LIST AAN (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Maakt een nieuwe zoekproperty list aan. Een zoekeigenschapslijst wordt gebruikt om één of meer zoekeigenschappen aan te geven die je in een full-text index wilt opnemen.

Transact-SQL syntaxis-conventies

Syntaxis

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

Arguments

new_list_name
Is de naam van de nieuwe zoekproperty list. new_list_name is een identificatie met maximaal 128 tekens. new_list_name moet uniek zijn tussen alle eigenschappenlijsten in de huidige database en voldoen aan de regels voor identificaties. new_list_name wordt gebruikt wanneer de volledige tekstindex wordt aangemaakt.

database_name
Is de naam van de database waar de door source_list_name gespecificeerde property list zich bevindt. Als dit niet is opgegeven, wordt database_name standaard ingesteld op de huidige database.

database_name moet de naam van een bestaande database opgeven. De login voor de huidige verbinding moet gekoppeld zijn aan een bestaande gebruikers-ID in de database die door database_name is gespecificeerd. Je moet ook de vereiste rechten op de database hebben.

source_list_name
Geeft aan dat de nieuwe property list wordt aangemaakt door een bestaande property list uit database_name te kopiëren. Als source_list_name niet bestaat, faalt CREATE SEARCH PROPERTY LIST met een foutmelding. De zoekeigenschappen in source_list_name worden geërfd door new_list_name.

AUTORISATIE-owner_name
Specificeert de naam van een gebruiker of rol die eigendom moet zijn van de property list. owner_name moet ofwel de naam zijn van een rol waarvan de huidige gebruiker lid is, of de huidige gebruiker moet IMITATE-toestemming hebben op owner_name. Als dit niet is opgegeven, wordt het eigendom aan de huidige gebruiker gegeven.

Opmerking

De eigenaar kan worden gewijzigd door gebruik te maken van de ALTER AUTHORIZATIONTransact-SQL statement.

Opmerkingen

Opmerking

Voor informatie over eigendomslijsten in het algemeen, zie Zoek documenteigenschappen met zoek naar eigendomslijsten.

Standaard is een nieuwe zoekproperty lijst leeg en moet je deze handmatig aanpassen om één of meer zoekproperties toe te voegen. Je kunt ook een bestaande zoekproperty lijst kopiëren. In dit geval erft de nieuwe lijst de zoekeigenschappen van zijn bron, maar je kunt de nieuwe lijst aanpassen om zoekeigenschappen toe te voegen of te verwijderen. Alle eigenschappen in de zoek-eigenschappenlijst op het moment van de volgende volledige populatie worden opgenomen in de volledige tekstindex.

Een CREATE SEARCH PROPERTY LIST-instructie faalt onder een van de volgende voorwaarden:

  • Als de database die door database_name is gespecificeerd niet bestaat.

  • Als de door source_list_name gespecificeerde lijst niet bestaat.

  • Als je niet de juiste rechten hebt.

Om eigenschappen toe te voegen of te verwijderen van een lijst

Permissions

Vereist CREATE FULLTEXT CATALOG permissies in de huidige database en REFERENTIES-rechten op elke database waaruit je een bronproperty lijst kopieert.

Opmerking

REFERENTIES-toestemming is vereist om de lijst aan een full-text index te koppelen. CONTROL-toestemming is vereist om eigenschappen toe te voegen en te verwijderen of de lijst te verwijderen. De eigenaar van de eigendomslijst kan REFERENTIE- of CONTROLE-rechten verlenen aan de lijst. Gebruikers met CONTROL-rechten kunnen ook REFERENTIE-rechten aan andere gebruikers geven.

Voorbeelden

Eén. Een lege property list aanmaken en deze koppelen aan een index

Het volgende voorbeeld maakt een nieuwe zoekeigenschapslijst aan met de naam DocumentPropertyList. Het voorbeeld gebruikt vervolgens een ALTER FULLTEXT INDEX-instructie om de nieuwe property list te koppelen aan de full-text index van de Production.Document tabel in de AdventureWorks database, zonder een populatie te starten.

Opmerking

Voor een voorbeeld dat verschillende vooraf gedefinieerde, bekende zoekeigenschappen toevoegt aan deze zoekeigenschapslijst, zie ALTER SEARCH PROPERTY LIST (Transact-SQL). Na het toevoegen van zoekeigenschappen aan de lijst moet de databasebeheerder een andere ALTER FULLTEXT INDEX-instructie gebruiken met de clausule START FULL POPULATION.

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

B. Een property list maken uit een bestaande

Het volgende voorbeeld maakt een nieuwe zoek-eigenschapslijst, JobCandidateProperties, aan van de lijst gemaakt door Voorbeeld A, DocumentPropertyList, die is gekoppeld aan een full-text index in de AdventureWorks2025 database. Het voorbeeld gebruikt vervolgens een ALTER FULLTEXT INDEX-instructie om de nieuwe property list te koppelen aan de full-text index van de HumanResources.JobCandidate tabel in de AdventureWorks2025 database. Deze ALTER FULLTEXT INDEX-instructie start een volledige populatie, wat het standaardgedrag is van de SET SEARCH PROPERTY LIST-clausule.

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

Zie ook

ALTER SEARCH PROPERTY LIST (Transact-SQL)
ZOEK OP 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)
Documenteigenschappen zoeken met lijsten met zoekeigenschappen
Vind eigenschapssets GUID's en eigenschaps-integer ID's voor zoekeigenschappen

  • Last updated on