FREETEXT (Transact-SQL)

Sintaxe

FREETEXT ( { column_name | (column_list) | * } 
          , 'freetext_string' [ , LANGUAGE language_term ] )

Argumentos

• column_name
  É o nome de uma ou mais colunas indexadas de texto completo da tabela especificada na cláusula FROM. As colunas podem ser do tipo char, varchar, nchar, nvarchar, text, ntext, image, xml, varbinary ou varbinary(max).

• column_list
  Indica que várias colunas, separadas por uma vírgula, podem ser especificadas. column_list deve estar entre parênteses. A menos que language_term seja especificado, o idioma de todas as colunas de column_list deve ser o mesmo.

• *
  Especifica que todas as colunas que foram registradas para pesquisas de texto completo devem ser usadas para pesquisar um determinado freetext_string. Se mais de uma tabela estiver na cláusula FROM, * deverá ser qualificado pelo nome da tabela. A menos que language_term seja especificado, o idioma de todas as colunas da tabela deve ser o mesmo.

• freetext_string
  É texto a ser pesquisado na column_name. Qualquer texto, incluindo palavras, frases ou orações, pode ser inserido. Correspondências serão geradas se qualquer termo ou os formulários de qualquer termo forem localizados no índice de texto completo.

  Ao contrário da condição de pesquisa CONTAINS e CONTAINSTABLE, em que AND é uma palavra-chave, quando usada em freetext_string, a palavra 'and' é considerada uma palavra de ruído ou palavra irrelevante e será descartada.

  O uso de WEIGHT, FORMSOF, curingas, NEAR e outra sintaxe não é permitido. freetext_string é uma palavra quebrada, ramificada, e submetida ao dicionário de sinônimos. Se freetext_string estiver entre aspas duplas, uma correspondência de frase será executada no lugar. A lematização e o dicionário de sinônimos não serão executados.

  freetext_string é nvarchar. Uma conversão implícita ocorre quando outro tipo de dados de caractere é usado como entrada. No exemplo a seguir, a variável @SearchWord, que está definida como varchar(30), causa uma conversão implícita no predicado FREETEXT.

  USE AdventureWorks;
  GO
  DECLARE @SearchWord varchar(30)
  SET @SearchWord ='performance'
  SELECT Description 
  FROM Production.ProductDescription 
  WHERE FREETEXT(Description, @SearchWord);
  

  Como a "detecção de parâmetro" não funciona em conversão, use nvarchar para obter um melhor desempenho. No exemplo, declare @SearchWord como nvarchar(30).

  USE AdventureWorks;
  GO
  DECLARE @SearchWord nvarchar(30)
  SET @SearchWord = N'performance'
  SELECT Description 
  FROM Production.ProductDescription 
  WHERE FREETEXT(Description, @SearchWord);
  

  Você também pode usar a dica de consulta OPTIMIZE FOR para casos em que um plano não ideal é gerado.

• LANGUAGE language_term
  É o idioma cujos recursos serão usados para remoção de palavra irrelevante, quebra de palavras, lematização e dicionário de sinônimos e como parte da consulta. Esse parâmetro é opcional e pode ser especificado como uma cadeia de caracteres, um inteiro ou um valor hexadecimal que corresponda ao LCID (identificador de localidade) de um idioma. Se language_term for especificado, o idioma que ele representa será aplicado a todos os elementos do critério de pesquisa. Se nenhum valor for especificado, o idioma de texto completo da coluna será usado.

  Se documentos de idiomas diferentes forem armazenados em conjunto como BLOBs (objetos binários grandes) em uma única coluna, o LCID de um determinado documento determinará qual idioma será usado para indexar seu conteúdo. Ao consultar essa coluna, a especificação de LANGUAGElanguage_term pode aumentar a probabilidade de uma boa correspondência.

  Quando especificado como uma cadeia de caracteres, language_term corresponde ao valor da coluna alias na exibição de compatibilidade de sys.syslanguages (Transact-SQL). A cadeia de caracteres deve estar entre aspas simples, como em 'language_term'. Quando especificado como um inteiro, language_term é o LCID real que identifica o idioma. Quando especificado como um valor hexadecimal, language_term é 0x seguido pelo valor hexadecimal do LCID. O valor hexadecimal não deve exceder oito dígitos, incluindo zeros à esquerda.

  Se o valor estiver no formato DBCS (conjunto de caracteres de dois bytes), o MicrosoftSQL Server o converterá em Unicode.

  Se o idioma especificado não for válido ou se não houver nenhum recurso instalado que corresponda ao idioma, o MicrosoftSQL Server retornará um erro. Para usar os recursos de idioma neutros, especifique 0x0 como language_term.

Comentários

Predicados e funções de texto completo funcionam em uma única tabela que está implícita no predicado FROM. Para pesquisar em várias tabelas, use uma tabela unida na cláusula FROM para pesquisar em um conjunto de resultados que é o produto de duas ou mais tabelas.

Consultas de texto completo que usam FREETEXT são menos precisas que consultas de texto completo que usam CONTAINS. O mecanismo de pesquisa de texto completo do SQL Server identifica palavras e frases importantes. Nenhum significado especial é dado a quaisquer das palavras chave reservadas ou curingas que tipicamente têm significado, quando especificado no parâmetro < contains_search_condition > do predicado de CONTAINS.

FREETEXT não será reconhecido como uma palavra-chave se o nível de compatibilidade for menor que 70. Para obter mais informações, consulte sp_dbcmptlevel (Transact-SQL).

Predicados de texto completo não são permitidos na cláusula OUTPUT quando o nível de compatibilidade do banco de dados está definido como 100.

Exemplos

A. Usando FREETEXT para pesquisar palavras que contêm valores de caracteres especificados

USE AdventureWorks;
GO
SELECT Title
FROM Production.Document
WHERE FREETEXT (Document, 'vital safety components' );
GO

B. Usando FREETEXT com variáveis

USE AdventureWorks;
GO
DECLARE @SearchWord nvarchar(30);
SET @SearchWord = N'high-performance';
SELECT Description 
FROM Production.ProductDescription 
WHERE FREETEXT(Description, @SearchWord);
GO

Consulte também

Tarefas

Referência

Conceitos