登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  MySQL

MySQL IS_IPV4_COMPAT 怎样识别 IPv4 兼容地址

来源:17golang原创

时间:2026-11-17 20:30:22 496浏览 收藏

MySQL IS_IPV4_COMPAT() 接收二进制形式的 IPv6 地址。对于地址文本,先调用 INET6_ATON(),再把结果交给它;返回 1 表示 IPv4-compatible IPv6,返回 0 表示不属于这一类,输入 NULL 则返回 NULL。它识别的是地址类别,不是所有含 IPv4 尾部的 IPv6 地址。

如果我需要整理一列混合地址,会先把“能否解析”和“属于哪种地址”拆开。这样非法文本不会因为一个 COALESCE 就悄悄变成普通的“非兼容地址”。本文以 MySQL 8.4 文档为依据,示例仅说明查询写法,没有本地执行记录。

官方文档:https://dev.mysql.com/doc/refman/8.4/en/miscellaneous-functions.html

先确定识别对象与输入范围

IPv4-compatible 的常见文本形式为 ::IPv4地址,例如 ::192.0.2.37;mapped 形式则带有 ::ffff: 前缀,例如 ::ffff:192.0.2.37。两者即使尾部相同,也不能用同一个分类标签代替。IS_IPV4_MAPPED() 是区分后者的配套函数。

不要通过是否包含点号来分类:IPv6 地址的低位也可以写成十六进制,不一定以点分十进制结尾。也不要简单检查文本是否以 :: 开头,因为缩写、特殊地址和不同合法表示会让文本规则偏离二进制含义。这里让 MySQL 的解析与分类函数承担各自职责。

对纯 IPv4 文本,INET6_ATON() 产生 4 字节结果;对 IPv6 文本,产生 16 字节结果。需要混合存放时,VARBINARY(16) 能保留两种长度。若用固定 BINARY(16) 保存纯 IPv4 的 4 字节结果,填充后的值不再是原来的长度,后续不能再按同样的长度逻辑分类。

准备二进制地址并完成最小查询

先用受控的示例文本说明函数组合,再观察长度与十六进制表示。下列三个分类表达式的预期值分别为 1、0、1;这是依据函数定义说明的结果,不是现场查询截图。

-- 文本先转换为二进制,不能直接把地址字符串交给分类函数。
SELECT
  IS_IPV4_COMPAT(INET6_ATON('::192.0.2.37')) AS compatible,
  IS_IPV4_COMPAT(INET6_ATON('::ffff:192.0.2.37')) AS mapped_as_compatible,
  IS_IPV4_MAPPED(INET6_ATON('::ffff:192.0.2.37')) AS mapped;

-- 同时观察长度和十六进制,避免把客户端显示方式当成字段类型。
SELECT
  OCTET_LENGTH(INET6_ATON('::192.0.2.37')) AS address_bytes,
  HEX(INET6_ATON('::192.0.2.37')) AS address_hex;

第一个地址转换后的长度应为 16 字节,其低 32 位对应示例 IPv4 部分。HEX() 仅为观察字节提供可读表示,不改变 IS_IPV4_COMPAT() 需要二进制输入这一约定。传入 HEX() 的结果会得到文本字符,不能把它作为原二进制值继续分类。

地址文本与二进制分类函数关系图
原创静态说明图:看“输入表示”和“分类函数”两组,连线表示参数依赖,不是执行截图。

如果数据本身已经是 INET6_ATON() 产生的二进制列,可直接调用 IS_IPV4_COMPAT(ip_bin),不必转成文本再转换回来。关键是确认列中保存的到底是原始字节、HEX 文本,还是 Base64 文本,而不是只看客户端显示出来像什么。

把分类结果放进数据查询

实际查询通常需要同时保留缺失、无效、纯 IPv4 和两种 IPv6 嵌入形式。下面用两层 CTE 分开描述原始文本与解析结果,再通过 CASE 给出标签。样本中的地址用于文档说明,不发起网络连接。

-- CTE 只创建本条查询的数据集,不创建或修改业务表。
WITH samples AS (
  SELECT 1 AS id, '::192.0.2.37' AS ip_text
  UNION ALL SELECT 2, '::ffff:192.0.2.37'
  UNION ALL SELECT 3, '2001:db8::37'
  UNION ALL SELECT 4, '192.0.2.37'
  UNION ALL SELECT 5, 'not-an-ip'
  UNION ALL SELECT 6, NULL
), parsed AS (
  SELECT id, ip_text, INET6_ATON(ip_text) AS ip_bin
  FROM samples
)
SELECT id, ip_text,
       OCTET_LENGTH(ip_bin) AS address_bytes,
       CASE
         WHEN ip_text IS NULL THEN 'missing'
         WHEN ip_bin IS NULL THEN 'invalid'
         WHEN OCTET_LENGTH(ip_bin) = 4 THEN 'ipv4'
         WHEN IS_IPV4_COMPAT(ip_bin) = 1 THEN 'compatible'
         WHEN IS_IPV4_MAPPED(ip_bin) = 1 THEN 'mapped'
         ELSE 'other-ipv6'
       END AS address_kind
FROM parsed
ORDER BY id;

id 为 1 的样本应标记 compatible,2 为 mapped,3 为 other-ipv6,4 为 ipv4,5 为 invalid,6 为 missing。先检查 ip_text IS NULL,再检查 ip_bin IS NULL,能够保留输入缺失和解析失败的区别。这里的 other-ipv6 只表示没有命中前述两类,不证明地址可达、可分配或适合作为客户端来源。

CTE 的目的在于清楚表达查询结构,不承诺数据库只计算一次 INET6_ATON();优化器可能改写表达式。若只想筛选 compatible 行,在已有二进制地址列上使用 IS_IPV4_COMPAT(ip_bin) = 1 即可。不要对整列盲目解码,先确认存储约定。

输入状态与地址分类标签关系图
原创静态结构图:“输入状态”与“地址类别”分组用于解释查询标签,不是实际数据库运行结果。

处理兼容情况与使用限制

输入情况处理要点
地址文本先 INET6_ATON,再做二进制分类
已有二进制地址直接分类,保留原始长度
mapped 地址用 IS_IPV4_MAPPED 单独标记
非法地址文本解析结果为 NULL,单列为 invalid
缺失值保留 missing,避免与 invalid 混淆

这组表达式适用于提供相应函数的 MySQL 环境。若运行在其他数据库或兼容层,先以该产品的函数支持说明为准,不能仅凭它支持 MySQL 协议就推断行为一致。没有对应函数时,可以在应用层使用明确支持地址类别的 IP 库,并保持同样的缺失、无效与类别标签;不建议用 SQL 文本前缀替代二进制判断。

对大量记录反复在 WHERE 中解析文本,会增加转换计算;是否需要保存标准化二进制列或专用类别列,应结合数据更新方式与查询需求决定。本文没有性能测量,不给出“函数查询自动命中索引”或固定提速比例的承诺。使用持久化类别时,应确保地址变化与类别更新保持一致。

IS_IPV4_COMPAT 返回 0,是否说明输入是合法 IPv6?

不能这样推断。0 只表示没有识别为目标类别。面对文本输入,应先检查 INET6_ATON 是否成功,必要时再区分 4 字节和 16 字节结果。

为什么不要直接写 IS_IPV4_COMPAT(ip_text)?

因为该函数要求二进制 IPv6 表示。地址文本里的冒号、数字和点号是字符,并不是解析后的地址字节。文本列应先交给 INET6_ATON。

compatible 与 mapped 可以统一存成一个业务标签吗?

可以在明确的业务需求下另建总类,但底层识别仍应保留两者区别。不要让后续使用方误以为两个函数互相等价;更不能把地址分类结果直接当作访问授权或网络可达性的结论。

这套写法适合混合 IP 字段的数据整理:先确定存储表示,再保留解析状态,最后识别具体类别。对我而言,能解释 NULL 与 0 各代表什么,比只拿到一个布尔结果更有用。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>