Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
O LIKE '%keyword%' do MySQL funciona para tabelas pequenas, mas não consegue usar índices — todas as linhas são varridas. A busca de texto completo oferece uma alternativa indexada e classificada por relevância para pesquisar colunas de texto.

Criando um Índice FULLTEXT

Índices FULLTEXT funcionam em colunas CHAR, VARCHAR e TEXT em tabelas InnoDB (o mecanismo de armazenamento padrão) e MyISAM.
Adicione um índice FULLTEXT a uma tabela existente:
Um único índice FULLTEXT pode abranger várias colunas. As consultas contra esse índice pesquisam todas as colunas indexadas ao mesmo tempo.

Consultando com MATCH…AGAINST

As consultas de texto completo usam a sintaxe MATCH(columns) AGAINST(expression). A lista de colunas do MATCH deve corresponder exatamente às colunas do índice FULLTEXT.
O MySQL retorna as linhas em ordem decrescente de relevância quando MATCH...AGAINST aparece na cláusula WHERE. A expressão AGAINST retorna uma pontuação de relevância — 0 significa nenhuma correspondência.

Modos de Busca

O MySQL suporta três modos de busca:

Modo de Linguagem Natural

O padrão. O MySQL usa um esquema de ponderação que efetivamente ignora palavras extremamente comuns — termos que aparecem em quase todas as linhas contribuem pouco para as pontuações de relevância. Stopwords comuns do inglês (the, is, at) são filtradas por completo. Os resultados são retornados em ordem decrescente de relevância quando não há um ORDER BY explícito.

Modo Booleano

O modo booleano suporta operadores para controle preciso:
Operadores booleanos comuns: Tabelas InnoDB exigem um índice FULLTEXT em todas as colunas da expressão MATCH() — sem ele, consultas em modo booleano no InnoDB retornam um erro. (O MyISAM permite o modo booleano sem um índice FULLTEXT, mas varre todas as linhas.)

Expansão de Consulta

Busca em duas passagens. O MySQL executa a consulta inicial, pega as melhores correspondências, extrai termos adicionais delas e então executa a busca novamente com esses termos adicionados.
Útil quando os usuários pesquisam com um único termo ou com termos vagos. Pode retornar resultados surpreendentes se as melhores correspondências da primeira passagem estiverem fora do assunto.

Busca de Texto Completo vs LIKE

Use LIKE para correspondência de padrões simples em tabelas pequenas, buscas por prefixo (LIKE 'prefix%' com um índice) ou quando você precisa de correspondência de padrões arbitrários. Use texto completo quando estiver pesquisando palavras ou frases em colunas de texto e precisar de classificação por relevância ou melhor desempenho em escala.

Comprimento Mínimo de Palavra

O tamanho mínimo de token padrão do InnoDB é 3 caracteres (innodb_ft_min_token_size). Palavras com menos de 3 caracteres não são indexadas. Para palavras de dois caracteres, reduza o mínimo:
innodb_ft_min_token_size não é uma variável dinâmica — é preciso reiniciar o servidor para que tenha efeito. Após reiniciar, reconstrua todos os índices FULLTEXT:

Perguntas Frequentes

Por que meu MATCH…AGAINST não retorna nenhuma linha, mesmo com a palavra na tabela?

Três motivos comuns: (1) A palavra é mais curta do que innodb_ft_min_token_size (padrão 3). (2) A palavra está na lista de stopwords. (3) Em uma tabela MyISAM, a palavra aparece em 50% ou mais das linhas — o modo de linguagem natural no MyISAM trata essas palavras como comuns demais para serem úteis. O InnoDB não tem esse corte. Use o modo booleano para contornar o limite de 50% do MyISAM.

Posso usar busca de texto completo com condições WHERE?

Sim. Combine MATCH...AGAINST com outras condições WHERE normalmente:
O MySQL pode usar o índice FULLTEXT para a parte de texto completo e filtrar separadamente por outras colunas indexadas.

A busca de texto completo do MySQL suporta vários idiomas?

O MySQL tem listas de stopwords nativas para vários idiomas. Para busca multilíngue em produção, normalmente você precisará configurar innodb_ft_enable_stopword = OFF e fornecer a sua própria tabela de stopwords via innodb_ft_server_stopword_table, ou usar um mecanismo de busca externo (Elasticsearch, MeiliSearch).

Solução de Problemas

Veja também