VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
BETWEEN. O tipo INET do VillageSQL torna o schema mais expressivo e trata IPv4 e IPv6 na mesma tabela.
Como Funciona a Geolocalização por IP
Não existe uma função do MySQL que mapeie um IP para um país. A geolocalização é um problema de consulta: você tem uma tabela de intervalos de IP — cada linha diz “os endereços de X a Y estão no país Z” — e você encontra qual intervalo contém o IP recebido. Bancos de dados gratuitos como o MaxMind GeoLite2 fornecem esses intervalos como arquivos CSV que você importa para o MySQL.A Abordagem Padrão: Intervalos de Inteiros
O MaxMind GeoLite2 (e bancos de dados semelhantes) vêm comnetwork como uma string CIDR e o início/fim de cada intervalo como inteiros. A abordagem com inteiros é compacta e amigável a índices:
start_ip permite uma varredura de intervalo eficiente. A limitação é que só funciona para IPv4. Uma tabela separada (com intervalos VARBINARY(16)) é necessária para IPv6.
Com o VillageSQL: IPv4/IPv6 Unificados com INET
O tipoINET do VillageSQL armazena endereços IPv4 e IPv6 com ordenação natural, para que você possa usar uma única tabela para ambas as famílias. inet_compare() toma o lugar de BETWEEN nas verificações de intervalo.
Armazenando por rede CIDR (schema alternativo)
Se os seus dados de GeoIP fornecem blocos CIDR em vez de pares início/fim, useCIDR para a coluna de rede e resolva a contenção por meio de consultas de sub-rede:
Escolhendo uma Abordagem
Para IPv4 puro e velocidade máxima de consulta, a abordagem
INT UNSIGNED + BETWEEN é difícil de superar. Para schemas que precisam tratar IPv4 e IPv6 em uma única tabela, INET com inet_compare é mais limpo e evita manter duas tabelas paralelas.
Comparando Fontes de Dados de Geolocalização
O schema de consulta é apenas metade da decisão — a fonte de dados determina a precisão, a atualidade e o custo. Veja como as opções comuns se comparam:
Os valores de precisão por país são autorreportados pelos provedores e variam por região — a cobertura da Ásia-Pacífico e da América Latina tende a ser menor do que a da América do Norte e da Europa em todas as fontes.
Qual escolher: o MaxMind GeoLite2 é o ponto de partida padrão — é gratuito, vem como arquivos simples que você importa uma vez, e as consultas rodam inteiramente dentro do MySQL, sem dependência externa. Para precisão em nível de cidade em produção, o GeoIP2 Precision é o caminho de upgrade. As fontes baseadas em API (ip-api.com, ipinfo.io) são convenientes para uso de baixo volume, mas adicionam latência HTTP e uma dependência de limite de taxa a cada consulta.
Quando Usar Cada Abordagem
Importando Dados do GeoLite2
O MaxMind GeoLite2 (gratuito, exige cadastro) fornece arquivos CSV. Para o schema baseado em intervalos:.mmdb e bibliotecas cliente oficiais para linguagens como Python, Node.js e Go, que são mais rápidas do que consultas SQL em cenários de alto volume.
Perguntas Frequentes
Devo fazer a geolocalização no MySQL ou no código da aplicação?
Para consultas de alto volume (a cada requisição HTTP), a geolocalização na camada de aplicação usando a biblioteca de leitura.mmdb do MaxMind é mais rápida — busca binária em memória, sem ida e volta ao SQL. A geolocalização baseada em SQL faz sentido para análises em lote, consultas de relatórios e pipelines de dados que já rodam no MySQL.
Como mantenho o banco de dados de GeoIP atualizado?
O MaxMind atualiza o GeoLite2 semanalmente. Crie um script para download periódico eTRUNCATE + recarga da tabela de geolocalização. Como alternativa, use o mmdbinspect do MaxMind ou um script de atualização para aplicar atualizações incrementais.
Quão precisa é a geolocalização por IP no MySQL?
A precisão depende inteiramente da fonte de dados, não do schema do MySQL. Em nível de país, o MaxMind GeoLite2 (gratuito) é preciso para aproximadamente 98% dos endereços IPv4. Em nível de cidade, cai para cerca de 80%. Para maior precisão, o produto pago GeoIP2 Precision do MaxMind chega a ~99,8% por país e ~85–90% por cidade. Nenhum banco de dados é perfeito — a precisão é tipicamente menor para redes móveis, VPNs e alguns intervalos da Ásia-Pacífico. A abordagem de consulta no MySQL não tem efeito sobre a precisão; você obtém exatamente o que os dados importados dizem.O MySQL pode consultar geolocalização por IP sem um plugin ou API externa?
Sim. A abordagem padrão — e o que este guia cobre — usa um banco de dados de GeoIP (como o MaxMind GeoLite2) importado para uma tabela MySQL comum como intervalos de inteiros. As consultas são consultas SQLBETWEEN simples. Sem plugin, sem API externa, sem chamada de rede no momento da consulta. A única dependência é importar e atualizar periodicamente os arquivos CSV simples do MaxMind. A extensão vsql_network_address do VillageSQL adiciona um tipo INET para um tratamento mais limpo de IPv4/IPv6, mas ela não é necessária para a abordagem básica.
Posso fazer join da geolocalização com meus logs de acesso em uma única consulta?
Sim — esse é um dos principais motivos para manter os dados de GeoIP no MySQL:Solução de Problemas
Veja também
- Armazenando Endereços IP no MySQL — armazenamento eficiente de IPs antes das consultas de geolocalização
- Consultando por Sub-rede no MySQL — consultas de IP baseadas em intervalo sobre as quais a geolocalização se apoia