ALTER FULLTEXT STOPLIST (Transact-SQL)

Artigo
06/18/2013

Insere ou exclui uma palavra irrelevante na lista de palavras irrelevantes de texto completo padrão do banco de dados atual.

Importante
Só há suporte para CREATE FULLTEXT STOPLIST no nível de compatibilidade 100. Nos níveis de compatibilidade 80 e 90, a lista de palavras irrelevantes do sistema sempre é atribuída ao banco de dados.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

ALTER FULLTEXT STOPLIST stoplist_name
{ 
        ADD [N] 'stopword' LANGUAGE language_term  
  | DROP 
    {
        'stopword' LANGUAGE language_term 
      | ALL LANGUAGE language_term 
      | ALL
     }
;

Argumentos

stoplist_name
É o nome da lista de palavras irrelevantes que está sendo alterada. stoplist_name pode ter um máximo 128 caracteres.
' stopword '
É uma cadeia de caracteres que pode ser uma palavra com significado linguístico no idioma especificado ou um token sem significado linguístico. stopword é limitado ao comprimento máximo do token (64 caracteres). Uma palavra irrelevante pode ser especificada como uma cadeia de caracteres de Unicode.

LANGUAGE language_term
Especifica o idioma a ser associado à stopword a ser adicionada ou descartada.

language_term pode ser especificado como uma cadeia de caracteres, um valor inteiro ou hexadecimal que corresponda ao LCID (identificador de localidade) do idioma, conforme se segue:

Formato	Descrição
Cadeia de caracteres	language_term corresponde ao valor da coluna alias na exibição de compatibilidade sys.syslanguages (Transact-SQL). A cadeia de caracteres deve estar entre aspas simples, como em 'language_term'.
Integer	language_term é o LCID do idioma.
Hexadecimal	language_term é 0x seguido do valor hexadecimal do LCID. O valor hexadecimal não deve exceder oito dígitos, inclusive zeros à esquerda. Se o valor estiver no formato DBCS (conjunto de caracteres de dois bytes), o SQL Server o converterá em Unicode.

ADD 'stopword' LANGUAGE language_term
Adiciona uma palavra irrelevante à lista de palavras irrelevantes para o idioma especificado por LANGUAGE language_term.

Se a combinação especificada de palavra-chave e o valor LCID do idioma não forem exclusivos da STOPLIST, um erro será retornado. Se o valor LCID não corresponder a um idioma registrado, um erro será gerado.
DROP { 'stopword' LANGUAGE language_term | ALL LANGUAGE language_term | ALL }
Descarta uma palavra irrelevante da lista de palavras irrelevantes.
- ' stopword ' LANGUAGE language_term
  Descarta a palavra irrelevante especificada para o idioma especificado por language_term.
- ALL LANGUAGE language_term
  Descarta todas as palavras irrelevantes para o idioma especificado por language_term.
- ALL
  Descarta todas as palavras irrelevantes da lista de palavras irrelevantes.

Comentários

Nenhum.

Permissões

Para designar uma lista de palavras irrelevantes como a lista de palavras irrelevantes padrão do banco de dados é necessário ter a permissão ALTER DATABASE. Para alterar uma lista de palavras irrelevantes é necessário ser o proprietário da lista de palavras irrelevantes ou ser associado às funções de banco de dados fixas db_owner ou db_ddladmin.

Exemplos

O exemplo a seguir altera uma lista de palavras irrelevantes chamada CombinedFunctionWordList, adicionando a palavra 'en', primeiro para espanhol e depois para francês.

ALTER FULLTEXT STOPLIST CombinedFunctionWordList ADD 'en' LANGUAGE 'Spanish';
ALTER FULLTEXT STOPLIST CombinedFunctionWordList ADD 'en' LANGUAGE 'French';