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 MySQL não tem um tipo booleano. BOOL e BOOLEAN são grafias de TINYINT(1), que armazena qualquer número que caiba em um byte. A coluna guarda 5 e -1 com a mesma facilidade que 0 e 1, e os devolve exatamente como entraram. A extensão vsql_boolean do VillageSQL adiciona um tipo de coluna STRICTBOOL que guarda dois valores e recusa todo o resto.

Por que TINYINT(1) é uma armadilha

Esta é a coluna que o MySQL dá a você, com quatro linhas inseridas:
Nada reclamou. Agora faça a mesma pergunta de duas formas:
Três linhas contam como verdadeiras (truthy), e uma é igual a TRUE. As duas consultas parecem corretas e discordam, porque TRUE é o literal 1 e WHERE active testa qualquer valor diferente de zero. Uma linha que guarda 5 está ativa em uma consulta e inativa na outra. Nada no esquema impediu que o 5 fosse gravado, então a discordância é descoberta depois, por um relatório que não fecha.

A coluna STRICTBOOL

A coluna aceita as strings 'true'/'false', 't'/'f', 'yes'/'no', 'on'/'off' e '1'/'0', em qualquer combinação de maiúsculas e minúsculas. Passe-as como strings; um número sem aspas é recusado. Seja qual for a grafia que entra, true ou false é o que volta:
A linha 5 não forneceu valor e recebeu o padrão da coluna. Qualquer coisa fora das grafias aceitas é recusada onde deve ser, no insert:
Filtre pelo valor da mesma forma que você o escreveu:

Contagem

Dois agregados vêm com o tipo. boolean_sum conta as linhas verdadeiras e boolean_avg dá a proporção delas:
Os dois agregados ignoram NULL, então a proporção é calculada sobre as linhas que responderam:
Um sim em duas respostas é uma proporção de 0.5, em três linhas. Se você quer que NULL conte como false, diga isso na consulta em vez de esperar que o agregado presuma.

Indexação

Uma coluna STRICTBOOL é indexada como qualquer outra:
Se o índice vale a pena é a pergunta de sempre. Uma coluna com dois valores só é seletiva quando um deles é raro, como um flag locked em uma tabela de contas em que quase nada está bloqueado.

Migrando uma coluna existente

Você não pode converter uma coluna TINYINT no lugar. O servidor recusa:
Em vez disso, adicione uma segunda coluna e preencha-a:
Cada uma dessas duas instruções atribui um literal. Uma instrução que calcula o valor é recusada, porque uma coluna STRICTBOOL não aceita uma expressão de string:
A conversão explícita que o erro pede é a função do próprio tipo, então uma única instrução funciona:
A migração também é o momento de decidir o que aquelas linhas com 5 e -1 significavam. Tudo que era diferente de zero virou true acima, que é o que WHERE active teria dito. Se algum relatório no seu sistema usava active = 1 em vez disso, ele discordava, e é agora que você descobre. Quando a nova coluna estiver correta, remova a antiga e renomeie:

Solução de Problemas

Veja também