CREATE SEARCH PROPERTY LIST (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de 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 você queira incluir em um índice de texto completo.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

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 deve ser exclusivo entre todas as listas de propriedades no banco de dados atual e estar em conformidade com as regras de identificadores. new_list_name será usado quando o índice de texto completo for criado.

database_name
É o nome do banco de dados em que a lista de propriedades especificada por source_list_name está localizada. Caso não seja especificado, database_name usará o banco de dados atual como padrão.

database_name precisa especificar o nome de um banco de dados existente. O logon da conexão atual deve ser associado a uma ID de usuário existente no banco de dados especificado por database_name. Você também deve ter as permissões obrigatórias no banco de dados.

source_list_name
Especifica que a nova lista de propriedades é criada pela cópia de uma lista de propriedades existente do database_name. Se source_list_name não existir, CREATE SEARCH PROPERTY LIST falhará com um erro. As propriedades de pesquisa em source_list_name são herdadas por new_list_name.

AUTHORIZATION owner_name
Especifica o nome de um usuário ou uma função para ser o proprietário da lista de propriedades. owner_name precisa ser o nome de uma função da qual o usuário atual é membro ou o usuário atual precisa ter a permissão IMPERSONATE no owner_name. Se não estiver especificada, a propriedade será dada ao usuário atual.

Observação

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

Comentários

Observação

Para obter informações sobre listas de propriedades em geral, consulte Pesquisar propriedades do documento com listas de propriedades de pesquisa.

Por padrão, uma nova lista de propriedades de pesquisa está vazia e você deve alterá-la para adicionar manualmente uma ou mais propriedades de pesquisa. Alternativamente, você pode copiar uma lista de propriedades de pesquisa existente. Nesse caso, a nova lista herda as propriedades de pesquisa de sua origem, mas você pode alterar a nova lista para adicionar ou remover propriedades de pesquisa. Qualquer propriedade na lista de propriedades de pesquisa no momento da próxima população completa será incluída no índice de texto completo.

Uma instrução CREATE SEARCH PROPERTY LIST falha sob qualquer uma destas condições:

  • Se o banco de dados especificado por database_name não existe.

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

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

Para adicionar ou remover propriedades de uma lista

Permissões

Requer permissões CREATE FULLTEXT CATALOG no banco de dados atual e permissões REFERENCES em qualquer banco de dados do qual você copiar uma lista de propriedades de origem.

Observação

A permissão REFERENCES é necessária para associar a lista a um índice de texto completo. A permissão CONTROL é necessária para adicionar e remover propriedades ou remover a lista. O proprietário da lista de propriedades pode conceder as permissões REFERENCES ou CONTROL na lista. Usuários com permissão CONTROL também podem conceder a permissão REFERENCES a outros usuários.

Exemplos

a. Criando uma lista de propriedades vazia e associando-a a um índice

O exemplo a seguir cria uma nova lista de propriedades de pesquisa denominada DocumentPropertyList. Em seguida, o exemplo usa uma instrução ALTER FULLTEXT INDEX para associar a nova lista de propriedades ao índice de texto completo da tabela Production.Document no banco de dados AdventureWorks, sem iniciar uma população.

Observação

Para obter um exemplo que adiciona várias propriedades de pesquisa predefinidas conhecidas a essa lista de propriedades de pesquisa, confira ALTER SEARCH PROPERTY LIST (Transact-SQL). Depois de adicionar propriedades de pesquisa à lista, o administrador de banco de dados deverá 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. Criando uma lista de propriedades com base em uma lista existente

O exemplo a seguir cria uma nova lista de propriedades de pesquisa, JobCandidateProperties, com base na lista criada pelo Exemplo A, DocumentPropertyList, que é associado a um índice de texto completo no banco de dados AdventureWorks2022. Em seguida, o exemplo utiliza uma instrução ALTER FULLTEXT INDEX para associar a nova lista de propriedades com o índice de texto completo da tabela HumanResources.JobCandidate no banco de dados AdventureWorks2022. Essa instrução ALTER FULLTEXT INDEX inicia uma população completa, que é o comportamento padrão da cláusula SET SEARCH PROPERTY LIST.

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

Consulte Também

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)
Pesquisar propriedades de documento com listas de propriedades de pesquisa
Localizar GUIDs do conjunto de propriedades e IDs de inteiro de propriedade para propriedades de pesquisa