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 →
Uma comparação de strings no MySQL ignora a diferença entre maiúsculas e minúsculas, a menos que você peça o contrário. Isso surpreende as pessoas uma vez e depois as pega mais tarde, então vale a pena saber o que decide isso e como mudar para uma única consulta. Abra o cliente com mysql -u root -p sakila antes de começar.

Como a diferenciação de maiúsculas e minúsculas funciona

Nada na sua consulta decide isso. Uma collation decide, e toda coluna de texto carrega uma. Um conjunto de caracteres diz quais caracteres uma coluna pode conter, e sua collation diz como compará-los. Você sobrescreve a collation para uma única comparação com COLLATE:
Substitua COLLATION_NAME pela collation que você quer que a comparação use, e SEARCH_TEXT pelo valor a corresponder.

Exemplos

  1. 2 strings que diferem só em maiúsculas e minúsculas são iguais

  1. O mesmo vale contra uma coluna

Um termo de busca em minúsculas encontra um título em maiúsculas.

  1. Ler a collation da coluna

Leia o nome de uma collation a partir do final. ci é case-insensitive (ignora maiúsculas e minúsculas), e é por isso que o exemplo 2 correspondeu. ai é accent-insensitive (ignora acentos), e faz um trabalho separado: sob esta collation 'e' = 'é' é verdadeiro, e sob utf8mb4_0900_as_cs é falso. Essa tabela é também o que o nome da sua própria coluna significa. Execute a consulta acima contra qualquer tabela e coluna para ver sob quais regras você está trabalhando.

  1. Pedir uma comparação que respeite maiúsculas e minúsculas

Funciona do mesmo jeito em uma coluna.

COLLATE em uma coluna abre mão da busca pelo índice

O índice de uma coluna é construído na collation da própria coluna, então uma comparação em outra collation não pode usá-lo para encontrar os valores correspondentes. O EXPLAIN da consulta acima informa uma varredura de todas as 1.000 linhas em vez de uma busca. Isso não custa nada em 1.000 filmes e custa muito em uma tabela grande. Quando você precisa de correspondência que respeite maiúsculas e minúsculas em todas as consultas, o guia Conjuntos de caracteres e collations cobre como armazenar a coluna dessa forma em vez disso.

De onde vem o padrão

Um banco de dados criado sem collation recebe a do servidor, uma tabela recebe a do banco de dados, e uma coluna recebe a da tabela. Então uma coluna sem nenhuma collation nomeada em nenhum ponto de sua história está comparando sem diferenciar maiúsculas e minúsculas por causa de uma configuração do servidor. @@ na frente de um nome lê uma configuração do servidor, e este par diz a você qual delas você herdou:
Seu servidor responde com o que quer que tenha sido definido na inicialização, então trate o resultado como um fato sobre a sua própria instalação, e não sobre o MySQL.

Identificadores seguem uma regra diferente

Nomes de coluna nunca diferenciam maiúsculas de minúsculas. Nomes de banco de dados e de tabela são uma questão separada, decidida por lower_case_table_names: Execute SELECT @@lower_case_table_names; para ver em que situação você está. Você não pode mudar isso a partir de uma sessão: SET GLOBAL lower_case_table_names=1 responde ERROR 1238 (HY000): Variable 'lower_case_table_names' is a read only variable. É uma configuração de inicialização, ligada a como o servidor foi configurado pela primeira vez, então trate a resposta como uma propriedade do servidor em que você está. O conselho prático não depende da resposta. Escreva todo nome de banco de dados e de tabela em uma única caixa e use essa grafia em todo lugar, para que mover o mesmo SQL entre 2 servidores não possa transformar uma consulta que funciona em ERROR 1146 (42S02), o erro para uma tabela que não existe.

Resumo

  • Espere que uma comparação de strings ignore maiúsculas e minúsculas, porque a collation usual termina em _ci.
  • Leia a collation de uma coluna em INFORMATION_SCHEMA.COLUMNS.
  • Leia o nome de uma collation a partir do final: _ci e _ai ignoram, _cs, _as e _bin respeitam.
  • Use COLLATE para uma comparação pontual que respeite maiúsculas e minúsculas, e aceite que ela abre mão da busca pelo índice.
  • Mantenha uma única grafia para todo nome de banco de dados e de tabela, seja o que for que lower_case_table_names diga.

Veja também