CREATE FULLTEXT STOPLIST (Transact-SQL)

  • Artigo

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

Cria uma nova lista de palavras irrelevantes de texto completo no banco de dados atual.

As palavras irrelevantes são gerenciadas nos bancos de dados por meio de objetos chamados listas de palavras irrelevantes (stoplists). Uma lista de palavras irrelevantes é uma lista que, quando associada a um índice de texto completo, é aplicada às consultas de texto completo desse índice. Para obter mais informações, veja Configurar e gerenciar palavras irrelevantes e listas de palavras irrelevantes para pesquisa de texto completo.

Importante

Somente há suporte para CREATE FULLTEXT STOPLIST, ALTER FULLTEXT STOPLIST e DROP FULLTEXT STOPLIST no nível de compatibilidade 100. Nos níveis de compatibilidade 80 e 90, essas instruções não têm suporte. No entanto, em todos os níveis de compatibilidade, a lista de palavras irrelevantes (stoplist) do sistema é associada automaticamente a novos índices de texto completo.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
CREATE FULLTEXT STOPLIST stoplist_name  
[ FROM { [ database_name.]source_stoplist_name } | SYSTEM STOPLIST ]  
[ AUTHORIZATION owner_name ]  
;

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

stoplist_name
É o nome da lista de palavras irrelevantes. stoplist_name pode ter, no máximo, 128 caracteres. stoplist_name deve ser exclusivo entre todas as listas de palavras irrelevantes no banco de dados atual e estar em conformidade com as regras de identificadores.

stoplist_name será usado quando o índice de texto completo for criado.

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

source_stoplist_name
Especifica que a nova lista de palavras irrelevantes é criada por meio de cópia de uma lista de palavras irrelevantes existente. Se o source_stoplist_name não existir ou se o usuário de banco de dados não tiver as permissões corretas, CREATE FULLTEXT STOPLIST falhará com um erro. Se qualquer idioma especificado nas palavras irrelevantes da lista de palavras irrelevantes de origem não estiver registrado no banco de dados atual, CREATE FULLTEXT STOPLIST terá êxito, mas serão retornados avisos e as palavras irrelevantes correspondentes não serão adicionadas.

SYSTEM STOPLIST
Especifica que a nova lista de palavras irrelevantes é criada com base na lista de palavras irrelevantes existente por padrão no banco de dados Resource.

AUTHORIZATION owner_name
Especifica o nome de uma entidade do banco de dados que será a proprietária da lista de palavras irrelevantes. owner_name deve ser o nome de uma entidade da qual o usuário atual seja 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.

Comentários

O criador de uma lista de palavras irrelevantes é seu proprietário.

Permissões

Para criar uma STOPLIST é necessário ter permissões CREATE FULLTEXT CATALOG. O proprietário da lista de palavras irrelevantes pode conceder a permissão CONTROL explicitamente em uma lista de palavras irrelevantes para permitir que os usuários adicionem e removam palavras e descartem a lista de palavras irrelevantes.

Observação

O uso de uma lista de palavras irrelevantes com um índice de texto completo exige permissão REFERENCE.

Exemplos

a. Criando uma nova lista de palavras irrelevantes de texto completo

O exemplo a seguir cria uma nova lista de palavras irrelevantes de texto completo denominada myStoplist.

CREATE FULLTEXT STOPLIST myStoplist;  
GO

B. Copiando uma lista de palavras irrelevantes de texto completo de uma lista de palavras irrelevantes de texto completo existente

O exemplo a seguir cria uma nova lista de palavras irrelevantes de texto completo denominada myStoplist2 copiando uma lista de palavras irrelevantes do AdventureWorks existente denominada Customers.otherStoplist.

CREATE FULLTEXT STOPLIST myStoplist2 FROM AdventureWorks.otherStoplist;  
GO

C. Copiando uma lista de palavras irrelevantes de texto completo da lista de palavras irrelevantes de texto completo do sistema

O exemplo a seguir cria uma nova lista de palavras irrelevantes de texto completo denominada myStoplist3 copiando da lista de palavras irrelevantes do sistema.

CREATE FULLTEXT STOPLIST myStoplist3 FROM SYSTEM STOPLIST;  
GO

Consulte Também

ALTER FULLTEXT STOPLIST (Transact-SQL)
DROP FULLTEXT STOPLIST (Transact-SQL)
Configurar e gerenciar palavras irrelevantes e listas de palavras irrelevantes (stoplists) para pesquisa de texto completo
sys.fulltext_stoplists (Transact-SQL)
sys.fulltext_stopwords (Transact-SQL)
Configurar e gerenciar palavras irrelevantes e listas de palavras irrelevantes (stoplists) para pesquisa de texto completo