CREATE SEARCH PROPERTY LIST (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstâ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 falha 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 ALTER AUTHORIZATION declaraçãoTransact-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 CREATE SEARCH PROPERTY LIST afirmação falha sob qualquer uma das seguintes 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 CREATE FULLTEXT CATALOG permissões no banco de dados atual e permissões REFERENCES em qualquer banco de dados do qual você copie 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. O exemplo então usa uma ALTER FULLTEXT INDEX instrução para associar a nova lista de propriedades ao índice de texto completo da Production.Document tabela no AdventureWorks banco de dados, sem iniciar uma população.

Observação

Para um exemplo que adiciona várias propriedades de busca pré-definidas e bem conhecidas a essa lista de propriedades de busca, vejaALTER SEARCH PROPERTY LIST (Transact-SQL). Após adicionar propriedades de busca à lista, o administrador do banco de dados precisaria usar outra ALTER FULLTEXT INDEX instrução 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 AdventureWorks2025. O exemplo então usa uma ALTER FULLTEXT INDEX instrução para associar a nova lista de propriedades ao índice de texto completo da HumanResources.JobCandidate tabela no AdventureWorks2025 banco de dados. Essa ALTER FULLTEXT INDEX instrução inicia uma população completa, que é o comportamento padrão da SETSEARCH PROPERTY LIST cláusula.

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

  • Last updated on