VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
IN testa uma coluna contra vários valores de uma vez. Ele diz o que uma cadeia de
OR diz, em uma cláusula, e é a cláusula que a maioria das pessoas usa quando um
filtro passa de 2 valores.
Abra o cliente com mysql -u root -p sakila antes de começar.
Como o IN funciona
COLUMN_NAME pela coluna a testar, e FIRST_VALUE e
SECOND_VALUE pelos valores a aceitar.
A condição é verdadeira quando a coluna é igual a qualquer valor entre os parênteses. Separe
os valores com vírgulas, e use quantos precisar.
x IN (a, b) significa o mesmo que x = a OR x = b. Escreva o que ficar mais legível,
e espere que IN fique mais legível com mais de 2 valores.
Exemplos
- Corresponder a qualquer um de vários valores
- Não corresponder a nenhum deles
- Uma lista de números
actor_id porque o
ORDER BY pediu isso, não porque a lista está nessa ordem.
- Uma lista que o servidor calcula sozinho
Os parênteses podem conter uma consulta em vez de uma lista. film_actor é a tabela que
emparelha cada filme com cada ator que aparece nele, então isto pede os filmes em que o ator 1
aparece, sem que você saiba nenhum id de filme.
IN é onde a maioria das pessoas
escreve a primeira.
Um NULL na lista quebra o NOT IN
IN e NOT IN não tratam um NULL na lista do mesmo jeito, e nenhum dos dois
avisa você.
Com IN, um NULL na lista é inofensivo. Uma linha que corresponde a um valor real é
mantida mesmo assim.
NOT IN, a mesma lista não retorna nada.
G, então um resultado vazio
é uma surpresa. A razão é que NOT IN pergunta se a coluna difere de
cada valor da lista, e nada pode ser mostrado como diferente de NULL.
Comparar qualquer coisa com NULL dá NULL em vez de verdadeiro ou falso, então a
condição inteira nunca é verdadeira e nenhuma linha sobrevive.
Isso importa mais quando a lista é uma subconsulta, porque uma subconsulta que você não
escreveu à mão pode retornar um NULL que você não esperava. Adicione
WHERE COLUMN_NAME IS NOT NULL dentro da subconsulta quando isso for possível. A
lição sobre IS NULL cobre como NULL se compara.
Resumo
- Use
INpara testar uma coluna contra uma lista de valores em uma cláusula. - Leia
x IN (a, b)comox = a OR x = b. - Coloque strings da lista entre aspas e deixe os números sem aspas.
- Coloque uma subconsulta entre os parênteses quando a lista for ela mesma uma resposta.
- Mantenha NULL fora de uma lista
NOT IN, porque ela não retorna nenhuma linha.
Veja também
- AND, OR e NOT — a cadeia de OR que o IN substitui
- IS NULL — por que comparar com NULL não é verdadeiro nem falso
- BETWEEN — testando um intervalo em vez de uma lista
- Subconsultas — a forma de consulta usada no exemplo 4