tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
日志服务
    文档
    Download PDF

    IP 函数

    最后更新时间：2024-03-20 11:32:03
    下载PDF
      IP 函数可用于判断 IP 地址属于内网还是外网，也可用于分析 IP 地址所属的国家、省份、城市。本文介绍 IP 地理函数的基本语法及示例。

      IP 地址函数

      说明：
      如下函数中的 KEY 参数表示日志字段（例如 ip），其值为 IP 地址；若其值为内部 IP 地址或非法字段将无法被解析，以 “NULL”或“未知”展示。
      IP 目前仅支持 IPv4 地址，IPv6 暂不支持。
      基于 IP 地址分配机制的限制，IP 地址库无法100%准确涵盖所有 IP 地址的地理信息，极少部分 IP 地址可能会查询不到详细地理信息或地理信息存在错误。
      函数名称
      说明
      示例
      ip_to_domain(KEY)
      判断目标 IP 地址是内网地址还是外网地址。内网则返回 intranet，外网则返回 internet，非法 IP 地址则返回 invalid。
      * | SELECT ip_to_domain(ip)
      ip_to_country(KEY)
      分析目标 IP 地址所属国家或地区。返回结果为国家或地区的中文名称。
      * | SELECT ip_to_country(ip)
      ip_to_country_code(KEY)
      分析目标 IP 地址所属国家或地区的代码。返回结果为国家或地区的代码。
      * | SELECT ip_to_country_code(ip)
      ip_to_country_geo(KEY)
      分析目标 IP 地址所属国家或地区的经纬度。返回结果为国家或地区的经纬度。
      * | SELECT ip_to_country_geo(ip)
      ip_to_province(KEY)
      分析目标 IP 地址所属省份。返回结果为省份的中文名称。
      * | SELECT ip_to_province(ip)
      ip_to_province_code(KEY)
      分析目标 IP 地址所属省份的代码。返回结果为省份的行政区划代码。
      * | SELECT ip_to_province_code(ip)
      ip_to_province_geo(KEY)
      分析目标 IP 地址所属省份的经纬度。返回结果为省份的经纬度。
      * | SELECT ip_to_province_geo(ip)
      ip_to_city
      分析目标 IP 地址所属城市。返回结果为城市的中文名称，国外城市为英文名。
      * | SELECT ip_to_city(ip)
      ip_to_city_code
      分析目标 IP 地址所属城市的代码。返回结果为城市的行政区规划代码，暂不支持中国台湾及国外城市。
      * | SELECT ip_to_city_code(ip)
      ip_to_city_geo
      分析目标 IP 地址所属城市的经纬度。返回结果为城市的经纬度，暂不支持中国台湾及国外城市。
      * | SELECT ip_to_city_geo(ip)
      ip_to_provider(KEY)
      分析目标 IP 地址对应的网络运营商，返回结果为网络运营商名称。
      * | SELECT ip_to_provider(ip)

      IP 网段函数

      说明：
      如下函数中的 KEY 参数表示日志字段（例如 ip），其值为 IP 地址。
      其中 ip_subnet_min、ip_subnet_max、ip_subnet_range 函数中的字段值为子网掩码格式的 IP 地址（例如：192.168.1.0/24），如果字段值为通用的 IP 地址，则需要使用 cancat 函数将其转换为子网掩码格式。
      函数名
      说明
      示例
      ip_prefix(KEY,prefix_bits)
      获取目标 IP 地址的前缀。返回结果为子网掩码格式 IP 地址。例如192.168.1.0/24。
      * | SELECT ip_prefix(ip,24)
      ip_subnet_min(KEY)
      获取 IP 网段中的最小 IP 地址。返回结果为 IP 地址，例如192.168.1.0。
      * | SELECT ip_subnet_min(concat(ip,'/24'))
      ip_subnet_max(KEY)
      获取 IP 网段中的最大 IP 地址。返回结果为 IP 地址，例如192.168.1.255。
      * | SELECT ip_subnet_max(concat(ip,'/24'))
      ip_subnet_range(KEY)
      获取 IP 网段范围。返回结果为 Array 类型的 IP 地址，例如[[192.168.1.0, 192.168.1.255]]。
      * | SELECT ip_subnet_range(concat(ip,'/24'))
      is_subnet_of
      判断目标 IP 地址是否在某网段内。返回结果为布尔值。
      * | SELECT is_subnet_of('192.168.0.1/24', ip)
      is_prefix_subnet_of
      判断目标网段是否为某网段的子网。返回结果为布尔值。
      * | SELECT is_prefix_subnet_of('192.168.0.1/24',concat(ip, '/24'))

      示例

      此处列举了 IP 函数在不同场景下的查询和分析示例。您在执行查询和分析操作后，还可以选择合适的统计图表展示查询和分析结果。
      说明：
      如下示例中的 ip 为日志字段。
      统计不是来自内网的请求总数。
      * | SELECT count(*) AS PV where ip_to_domain(ip)!='intranet'
      统计请求总数 Top10的省份。
      * | SELECT ip_to_province(ip) AS province, count(*) as PV GROUP BY province ORDER BY PV desc LIMIT 10
      如果上述结果中包含了内网请求，且您希望过滤这部分请求，可参考如下查询和分析语句。
      * | SELECT ip_to_province(ip) AS province, count(*) as PV where ip_to_domain(ip)!='intranet' GROUP BY province ORDER BY PV desc LIMIT 10
      统计 IP 地址的经纬度，确认客户端分布情况。
      * | SELECT ip_to_geo(ip) AS geo, count(*) AS pv GROUP BY geo ORDER BY pv DESC
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款