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 →
A maioria dos esquemas MySQL armazena endereços IP como VARCHAR(45). Funciona, mas desperdiça espaço, não faz nada para validar o formato e ordena lexicograficamente em vez de numericamente — então 192.168.1.10 vem antes de 192.168.1.9. O tipo INET do VillageSQL corrige tudo isso e lida com IPv4 e IPv6 na mesma coluna.

O Padrão do MySQL: VARCHAR

A abordagem direta:
VARCHAR(45) armazena qualquer string que você fornecer. Não há validação — 'not-an-ip' é inserido sem erro. A ordenação não segue a ordem numérica, e comparar com uma sub-rede exige manipulação de strings ou funções de conversão.

A Solução Alternativa Padrão: INT UNSIGNED + INET_ATON

Para IPv4, o INET_ATON() do MySQL converte uma string em notação decimal pontuada para um inteiro de 4 bytes. Isso é compacto e ordena corretamente:
Isso funciona bem para esquemas somente IPv4. O problema é o IPv6: INT UNSIGNED não consegue conter um endereço de 128 bits. Você precisaria de VARBINARY(16) e INET6_ATON() / INET6_NTOA() para IPv6, o que significa uma mudança de esquema quando o suporte a IPv6 for necessário.

Com o VillageSQL: O Tipo INET

A extensão vsql_network_address do VillageSQL adiciona um tipo nativo INET que armazena endereços IPv4 e IPv6 em um formato binário compacto — 19 bytes fixos por linha para ambas as famílias, com os valores IPv4 preenchidos até essa largura — e valida a entrada no momento da inserção.
Uma string inválida não aborta a instrução: inet_from_string() retorna NULL com o Warning 3200, então a linha é inserida com um valor NULL. Declare a coluna como NOT NULL se você quiser que uma entrada inválida faça o insert falhar.

Trabalhando com endereços armazenados

Indexação

Escolhendo uma Abordagem de Armazenamento

Para esquemas novos que precisam de IPv4 e IPv6 com validação integrada, INET é a opção mais limpa. Para esquemas somente IPv4 sem dependência do VillageSQL, INT UNSIGNED com INET_ATON / INET_NTOA é a abordagem consolidada. Para consultas por sub-rede em endereços armazenados, consulte Consultando por Sub-rede no MySQL.

Perguntas Frequentes

O INET pode armazenar endereços com máscara de rede, como 192.168.1.5/24?

Sim. INET permite bits de host — 192.168.1.5/24 é válido. Se você quiser impor que os bits de host sejam zero (endereços de rede puros), use o tipo CIDR em vez disso.

O INET valida o endereço no insert?

Sim. inet_from_string('not-an-ip') retorna NULL em vez de armazenar lixo. Se você passar NULL para uma coluna INET com uma restrição NOT NULL, o insert falha.

Como o ORDER BY ip_address ordena IPv4/IPv6 misturados?

Os endereços IPv4 vêm antes dos endereços IPv6. Dentro de cada família, os endereços são ordenados numericamente. Isso corresponde à ordem de classificação do INET do PostgreSQL.

O INET é o mesmo que o tipo inet do PostgreSQL?

Funcionalmente, sim — os mesmos tipos (INET, CIDR, MACADDR, MACADDR8), as mesmas convenções de nomenclatura de funções, as mesmas regras de validação. A principal diferença é que o VillageSQL fornece funções em vez de operadores para comparações e verificações de sub-rede.

Solução de Problemas

Veja também