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 IPv4 cabe em um inteiro de 4 bytes. O IPv6 tem 128 bits e precisa de 16 bytes de armazenamento binário. O MySQL fornece INET6_ATON() e INET6_NTOA() para isso, e elas funcionam — mas misturar IPv4 e IPv6 em uma única coluna exige cuidado extra. O tipo INET do VillageSQL armazena as duas famílias em uma única coluna com uma API consistente.

A Abordagem do MySQL para IPv6: VARBINARY(16)

O MySQL fornece INET6_ATON() e INET6_NTOA() para armazenamento binário de IPv6. INET6_ATON() trata tanto IPv4 quanto IPv6:
Armazenando as duas famílias em uma única coluna:
INET6_NTOA() retorna IPv4 em notação decimal com pontos e IPv6 em notação comprimida. A coluna VARBINARY(16) comporta ambos. Essa é a abordagem padrão e ela funciona. O atrito está nas operações que precisam saber qual família uma linha contém:
Não há uma forma nativa de extrair o comprimento do prefixo, a máscara de rede ou o endereço de rede de uma coluna VARBINARY.

Com o VillageSQL: Tipo INET Unificado

A extensão vsql_network_address do VillageSQL fornece um tipo INET que armazena IPv4 e IPv6 nativamente. As mesmas funções funcionam para as duas famílias — sem verificações de comprimento nem caminhos de código separados.

Trabalhando especificamente com IPv6

Os endereços IPv6 são armazenados e recuperados em notação expandida:

Filtrando por família de endereço

MySQL vs VillageSQL para IPv6

Perguntas Frequentes

O tipo INET armazena IPv4 no formato IPv4 mapeado em IPv6 (::ffff:x.x.x.x)?

Não — os endereços IPv4 são armazenados como IPv4 nativo, não como IPv4 mapeado em IPv6. inet_family() retorna 4 para endereços IPv4, independentemente de como foram escritos.

O INET trata a notação comprimida de IPv6, como ::1?

Sim. inet_from_string('::1') e inet_from_string('fe80::1') são analisados corretamente. A notação comprimida é aceita na entrada; a saída é sempre a forma expandida.

Posso indexar uma coluna INET para consultas rápidas?

Sim — CREATE INDEX idx_ip ON access_log(ip_address) funciona. As consultas de igualdade e as varreduras de intervalo (para consultas de sub-rede) usam o índice. Consulte Consultando por Sub-rede no MySQL para o padrão.

VARBINARY(16) + INET6_ATON está errado?

Não — é a abordagem correta usando apenas o MySQL. É mais compacta do que o INET (4 ou 16 bytes contra 19 fixos), mas você perde a detecção nativa de família, o tratamento de prefixo e a validação. Para esquemas que precisam funcionar com IPv4 e IPv6 e com operações que consideram o prefixo, o INET é mais ergonômico.

Solução de Problemas

Veja também