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 tem 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:
Elas funcionam, mas o armazenamento é desperdiçado. SHA2 com 256 bits retorna um VARCHAR de 64 caracteres — o dobro dos bytes necessários, já que cada byte do hash é codificado como dois dígitos hexadecimais. Para obter saída binária você escreveria 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 envolvem SHA2() em UNHEX():
Isso dá a você um armazenamento compacto. É um pouco verboso, mas é a abordagem padrão e funciona bem para SHA-256 e SHA-512.

Com o VillageSQL: digest()

A extensão vsql_crypto do VillageSQL adiciona digest(data, algorithm), que retorna um hash VARBINARY diretamente — sem necessidade de envolver em UNHEX().
Use 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. Armazene digest(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