VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
MD5(), SHA1() e SHA2() embutidas. Elas funcionam, mas retornam strings hexadecimais — 64 caracteres para um hash SHA-256, quando os dados subjacentes têm 32 bytes. Armazenar hashes em binário reduz isso pela metade e é mais eficiente de indexar. A digest() da extensão vsql_crypto do VillageSQL retorna binário bruto e oferece uma única função para todos os algoritmos.
O Padrão do MySQL: Funções Dispersas, Saída em Hexadecimal
O MySQL oferece três funções separadas para hashing:UNHEX(SHA2('hello', 256)), o que funciona, mas é incômodo de digitar de forma consistente.
Também não existe a opção sha224 nem sha384 — você fica limitado ao que o MySQL expõe.
A Solução Alternativa Padrão: UNHEX + SHA2
Para um armazenamento binário compacto, os desenvolvedores envolvemSHA2() em UNHEX():
Com o VillageSQL: digest()
A extensãovsql_crypto do VillageSQL adiciona digest(data, algorithm), que retorna um hash VARBINARY diretamente — sem necessidade de envolver em UNHEX().
HEX() quando precisar de uma string legível para registro em log ou exibição:
Algoritmos suportados
Não use MD5 nem SHA-1 em novas aplicações — ambos têm vulnerabilidades de colisão conhecidas. SHA-256 é o padrão prático para a maioria dos usos.
Especificamente para o armazenamento de senhas,
digest() é a ferramenta errada — consulte Hash de Senhas no MySQL para crypt() e gen_salt().
Quando Usar Cada Abordagem
Para novos projetos no VillageSQL,
digest() é a escolha mais limpa. Para aplicações existentes somente MySQL, UNHEX(SHA2()) é igualmente correto.
Perguntas Frequentes
Qual é a diferença entre digest() e SHA2()?
SHA2('hello', 256) retorna uma string hexadecimal de 64 caracteres. digest('hello', 'sha256') retorna um VARBINARY de 32 bytes. Elas calculam o mesmo hash — a diferença é a codificação. O armazenamento binário é mais compacto e mais rápido de indexar.
Posso usar digest() para detectar linhas duplicadas?
Sim. Armazenedigest(content, 'sha256') em uma coluna indexada e depois consulte com WHERE sha256 = digest(incoming_content, 'sha256'). Esse é um padrão comum para deduplicar arquivos enviados, detectar registros alterados ou construir consultas endereçáveis por conteúdo.
digest() é seguro para senhas?
Não.digest() é um hash rápido — ele é calculado em microssegundos. O hash de senhas exige um algoritmo lento e iterado. Use crypt() e gen_salt() da mesma extensão. Consulte Hash de Senhas no MySQL.
digest() suporta HMAC?
Não —digest() é um hash simples, sem chave. Para códigos de autenticação com chave, use hmac(). Consulte Assinaturas HMAC no MySQL.
Solução de Problemas
Veja também
- Hash de Senhas no MySQL — hash lento e adaptativo projetado especificamente para credenciais
- Assinaturas HMAC no MySQL — hash com chave para verificação de integridade e validação de webhooks
- Criptografia Simétrica no MySQL — quando você precisa dos dados de volta, não apenas de um fingerprint