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 →
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

Substitua 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

  1. Corresponder a qualquer um de vários valores

  1. Não corresponder a nenhum deles

  1. Uma lista de números

Números não levam aspas. As linhas voltam na ordem de actor_id porque o ORDER BY pediu isso, não porque a lista está nessa ordem.

  1. 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.
Uma consulta escrita dentro de outra consulta é uma subconsulta. Uma seção posterior as cobre de forma completa. Vale a pena conhecer uma aqui porque uma lista 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.
Com NOT IN, a mesma lista não retorna nada.
Todo filme tem uma classificação, e 822 deles não são classificados como 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 IN para testar uma coluna contra uma lista de valores em uma cláusula.
  • Leia x IN (a, b) como x = 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