Partilhar via


CRIAR LISTA DE PROPRIEDADES DE PESQUISA (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azure

Cria uma nova lista de propriedades de pesquisa. Uma lista de propriedades de pesquisa é usada para especificar uma ou mais propriedades de pesquisa que pretende incluir num índice de texto completo.

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

new_list_name
É o nome da nova lista de propriedades de pesquisa. new_list_name é um identificador com um máximo de 128 caracteres. new_list_name devem ser únicas entre todas as listas de propriedades na base de dados atual e cumprir as regras para identificadores. new_list_name serão usados quando o índice do texto completo for criado.

database_name
É o nome da base de dados onde está localizada a lista de propriedades especificada por source_list_name . Se não for especificado, database_name assume como padrão o banco de dados atual.

database_name deve especificar o nome de um banco de dados existente. O login para a ligação atual deve estar associado a um ID de utilizador existente na base de dados especificada por database_name. Também deve ter as permissões necessárias na base de dados.

source_list_name
Especifica que a nova lista de propriedades é criada copiando uma lista de propriedades existente de database_name. Se source_list_name não existir, CRIAR LISTA DE PROPRIEDADES DE PESQUISA falha com um erro. As propriedades de pesquisa em source_list_name são herdadas por new_list_name.

AUTORIZAÇÃO owner_name
Especifica o nome de um utilizador ou papel a ser proprietário da lista de propriedades. owner_name deve ser o nome de um papel do qual o utilizador atual é membro, ou o utilizador atual deve ter permissão de IMPERSONAR owner_name. Se não for especificado, a propriedade será dada ao usuário atual.

Observação

O proprietário pode ser alterado usando a instrução ALTER AUTHORIZATIONTransact-SQL.

Observações

Observação

Para informações sobre listas de propriedades em geral, consulte Pesquisar Propriedades de Documentos com Pesquisar Listas de Propriedades.

Por defeito, uma nova lista de propriedades de pesquisa está vazia e deve alterá-la manualmente para adicionar uma ou mais propriedades de pesquisa. Em alternativa, pode copiar uma lista de propriedades de pesquisa existente. Neste caso, a nova lista herda as propriedades de pesquisa da sua fonte, mas pode alterar a nova lista para adicionar ou remover propriedades de pesquisa. Quaisquer propriedades na lista de propriedades de pesquisa na altura da próxima população completa são incluídas no índice de texto completo.

Uma instrução CRIAR LISTA DE PROPRIEDADES DE PESQUISA falha em qualquer uma das seguintes condições:

  • Se a base de dados especificada por database_name não existir.

  • Se a lista especificada por source_list_name não existir.

  • Se não tiver as permissões corretas.

Para adicionar ou remover propriedades de uma lista

Permissions

Requer permissões CRIAR CATÁLOGO DE TEXTO COMPLETO na base de dados atual e permissões REFERÊNCIAS em qualquer base de dados da qual copie uma lista de propriedades de origem.

Observação

É necessária permissão para REFERENCES para associar a lista a um índice em texto completo. É necessária permissão CONTROL para adicionar e remover propriedades ou eliminar a lista. O proprietário da lista de propriedades pode conceder permissões de REFERÊNCIAS ou CONTROLO na lista. Utilizadores com permissão CONTROL também podem conceder permissão REFERENCES a outros utilizadores.

Examples

A. Criar uma lista de propriedades vazia e associá-la a um índice

O exemplo seguinte cria uma nova lista de propriedades de pesquisa chamada DocumentPropertyList. O exemplo utiliza então uma instrução ALTER FULLTEXT INDEX para associar a nova lista de propriedades ao índice de texto completo da Production.Document tabela na AdventureWorks base de dados, sem iniciar uma população.

Observação

Para um exemplo que adiciona várias propriedades de pesquisa pré-definidas e bem conhecidas a esta lista de propriedades de pesquisa, veja ALTERAR LISTA DE PROPRIEDADES DE PESQUISA (Transact-SQL). Após adicionar propriedades de pesquisa à lista, o administrador da base de dados teria de usar outra instrução ALTER FULLTEXT INDEX com a cláusula 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. Criação de uma lista de propriedades a partir de uma lista existente

O exemplo seguinte cria uma nova lista de propriedades de pesquisa, JobCandidateProperties, a partir da lista criada pelo Exemplo A, DocumentPropertyList, que está associada a um índice de texto completo na AdventureWorks2025 base de dados. O exemplo utiliza então uma instrução ALTER FULLTEXT INDEX para associar a nova lista de propriedades ao índice de texto completo da HumanResources.JobCandidate tabela na AdventureWorks2025 base de dados. Esta instrução ALTER FULLTEXT INDEX inicia uma população completa, que é o comportamento padrão da cláusula SET SEARCH PROPERTY LISTE.

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

Ver também

ALTERAR LISTA DE PROPRIEDADES DE PESQUISA (Transact-SQL)
ELIMINAR PESQUISAR LISTA DE PROPRIEDADES (Transact-SQL)
sys.registered_search_properties (Transact-SQL)
sys.registered_search_property_lists (Transact-SQL)
sys.dm_fts_index_keywords_by_property (Transact-SQL)
Pesquisar propriedades do documento com listas de propriedades de pesquisa
Encontre GUIDs do Conjunto de Propriedades e IDs de Inteiros de Propriedades para Propriedades de Pesquisa