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 →
Encontrar todas as linhas em que um endereço IP está dentro de uma sub-rede exige comparar valores numéricos de IP com um intervalo. A abordagem padrão do MySQL usa aritmética bit a bit com 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.
As duas formas funcionam para IPv4. A abordagem com 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ão vsql_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:
Para uma versão parametrizada em que a sub-rede vem de uma variável:

Predicados de contenção

A extensão inclui os cinco predicados de contenção do PostgreSQL como funções. Elas recebem dois valores INET e retornam 1, 0 ou NULL: A consulta de sub-rede acima se torna uma única chamada:
Apenas a parte de rede de cada valor é comparada, até o menor dos dois comprimentos de prefixo — então 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:
Em vez disso, passe 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 com inet_network() funciona para IPv6 sem nenhuma alteração:

Padrão de tabela de redes

Um caso de uso comum: uma tabela networks 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ão cidr_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 colunas INET 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