VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
INET_ATON(). O tipo INET do VillageSQL fornece funções de rede que tornam a mesma consulta mais legível e funcionam tanto para IPv4 quanto para IPv6.
A Abordagem Padrão: Verificações de Intervalo Bit a Bit
Para IPv4,INET_ATON() converte um endereço em um inteiro sem sinal de 32 bits. Uma verificação de pertencimento a uma sub-rede é um AND bit a bit: se (ip & netmask) == network_address, o IP está na sub-rede.
BETWEEN é legível. A forma bit a bit é mais fácil de compor quando os parâmetros da sub-rede são variáveis.
Nenhuma das duas abordagens funciona para IPv6 — INET_ATON() só trata IPv4.
Com o VillageSQL: Funções de Rede em Colunas INET
A extensãovsql_network_address do VillageSQL fornece predicados de contenção que respondem diretamente “este endereço está dentro daquela sub-rede” — inet_contained_by(), inet_contains() e inet_overlaps() — além de inet_network(), inet_set_masklen() e inet_compare() para montar a verificação à mão. Todas elas funcionam em colunas INET tanto IPv4 quanto IPv6.
Consulta de contenção em sub-rede
Para verificar se um IP armazenado pertence a uma sub-rede, aplique a máscara do comprimento de prefixo da sub-rede ao endereço e compare o resultado com a rede alvo:Predicados de contenção
A extensão inclui os cinco predicados de contenção do PostgreSQL como funções. Elas recebem dois valoresINET e retornam 1, 0 ou NULL:
A consulta de sub-rede acima se torna uma única chamada:
192.168.1.5/24 e 192.168.1.9/24 são a mesma rede,
e as formas estritas retornam 0 para elas, enquanto as formas _or_equals retornam 1.
Dois endereços de famílias diferentes nunca correspondem: comparar um valor IPv4 com um
IPv6 retorna 0 em vez de gerar um erro, como no PostgreSQL.
Os dois argumentos devem ser INET. Um valor CIDR não é convertido implicitamente:
inet_from_string() na sub-rede, como faz o exemplo acima. Essas
funções foram adicionadas na versão 0.0.5 do vsql_network_address.
Contenção por intervalo com inet_compare
Uma alternativa que evita recalcular a rede em cada linha — útil quando você tem o endereço de broadcast disponível:Consultas de sub-rede IPv6 (mesmo padrão)
A mesma abordagem cominet_network() funciona para IPv6 sem nenhuma alteração:
Padrão de tabela de redes
Um caso de uso comum: uma tabelanetworks com CIDRs autorizados, e verificar se um IP de entrada está em algum deles.
Padrão vs VillageSQL
Perguntas Frequentes
O VillageSQL tem o operador de contenção << do PostgreSQL?
O comportamento está lá, como funções em vez de operadores: inet_contained_by() para <<, inet_contains() para >>, as variantes _or_equals para <<= e >>=, e inet_overlaps() para &&. Consulte Predicados de contenção.
A consulta de sub-rede usa o índice?
O padrãocidr_to_string(inet_network(inet_set_masklen(...))) não usa uma varredura de índice — ele recalcula o endereço de rede para cada linha. Para tabelas grandes, a abordagem de intervalo com inet_compare é mais amigável ao índice, porque expressa a consulta como um intervalo na coluna ip_address.
Posso armazenar sub-redes e consultar contenção ao mesmo tempo?
Sim. Armazene tanto o endereço do host quanto a sub-rede em colunasINET e compare-os com inet_contained_by(host_ip, subnet). Se a sub-rede está em uma coluna CIDR, converta-a primeiro — os predicados de contenção recebem INET dos dois lados e não convertem CIDR implicitamente.
Solução de Problemas
Veja também
- Armazenando Endereços IP no MySQL — o tipo INET usado nas consultas de sub-rede
- Armazenamento de IPv6 no MySQL — as consultas de sub-rede funcionam da mesma forma para IPv6 com INET
- Consultas de Geolocalização por IP no MySQL — indo além das sub-redes com dados de IP