CREATE SEARCH PROPERTY LIST (Transact-SQL)

Artigo
06/18/2013

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.

Importante
Há suporte a CREATE SEARCH PROPERTY LIST, ALTER SEARCH PROPERTY LIST e DROP SEARCH PROPERTY LIST apenas sob o nível de compatibilidade 110. Em níveis de compatibilidade inferiores, não há suporte para essas instruções.

Ícone de vínculo de tópico Convenções da sintaxe 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 dos identificadores. O new_list_name será usado quando o índice de texto completo for criado.
database_name
É o nome do banco de dados onde a lista de propriedades especificada por source_list_name está localizada. Se não estiver especificado, o database_name assumirá como padrão o banco de dados atual.

O database_name deve 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 necessá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 deve ser o nome de uma função da qual o usuário atual é membro ou o usuário atual deve ter a permissão IMPERSONATE em 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 AUTHORIZATION Transact-SQL.

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

Comentários

Observação
Para obter informações sobre listas de propriedades em geral, consulte Pesquisar propriedades de 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 existir.
Se a lista especificada por source_list_name não existir.
Se você não tiver as permissões corretas.

Para adicionar ou remover propriedades de uma lista

ALTER SEARCH PROPERTY LIST (Transact-SQL)
Para cancelar uma lista de propriedades
DROP SEARCH PROPERTY LIST (Transact-SQL)

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, esse 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 famosas predefinidas a essa lista de propriedades de pesquisa, consulte 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 AdventureWorks;
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 AdventureWorks. 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 AdventureWorks. 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 AdventureWorks.DocumentPropertyList;
GO
ALTER FULLTEXT INDEX ON HumanResources.JobCandidate 
   SET SEARCH PROPERTY LIST JobCandidateProperties;
GO