VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
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
ÍndicesFULLTEXT funcionam em colunas CHAR, VARCHAR e TEXT em tabelas InnoDB (o mecanismo de armazenamento padrão) e MyISAM.
FULLTEXT a uma tabela existente:
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 sintaxeMATCH(columns) AGAINST(expression). A lista de colunas do MATCH deve corresponder exatamente às colunas do índice FULLTEXT.
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:
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.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 queinnodb_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. CombineMATCH...AGAINST com outras condições WHERE normalmente:
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á configurarinnodb_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
- Como Funcionam os Índices do MySQL — FULLTEXT é um tipo de índice especializado ao lado da B-tree
- JSON no MySQL — pesquisando campos de texto JSON ao lado de dados estruturados
- Consultas de intervalo multidimensionais — pesquisando em várias dimensões numéricas quando a busca de texto não é a opção certa
- MySQL LIKE — o operador de padrão que um índice de texto completo substitui em escala
- MySQL REGEXP — correspondência de padrões que lê todas as linhas