CREATE FULLTEXT STOPLIST (Transact-SQL)

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

No SQL Server 2008 e em versões posteriores, palavras irrelevantes (stop words) são gerenciadas em bancos de dados usando objetos chamados listas de palavras irrelevantes. 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, consulte Palavras irrelevantes e listas de palavras irrelevantes.

Observação importanteImportante

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 do sistema é associada automaticamente a novos índices de texto completo.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

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

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

  • database_name
    É o nome do banco de dados onde a lista de palavras irrelevantes especificada por source_stoplist_name está localizada. Se não estiver especificado, o database_name assumirá como padrão o banco de dados atual.

  • 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 do 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 da lista de palavras irrelevantes existente por padrão no Banco de dados de recursos.

  • AUTHORIZATION owner_name
    Especifica o nome de uma entidade do banco de dados que será a proprietária da lista de palavras irrelevantes. O owner_name deve ser o nome de uma entidade da qual o usuário atual seja membro, ou o usuário atual deve ter permissão IMPERSONATE no 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çãoObservação

O uso de uma lista de palavras irrelevantes com um índice de texto completo requer 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