本文介绍日志服务支持的 IP 函数语法及常见场景的使用示例。 ## 函数列表 :::tip * 针对海外 IP 地址，暂不支持通过 ip_to_province 函数查询省份、不支持通过 ip_to_provider 函数查询运营商，且 ip_to_geo 函数查询到的经纬度为所在地国家的经纬度。 * 受限于 IP 地址分配机制与 IP 地址库的覆盖度，使用 IP 地址函数时，可能查询不到极少部分 IP 地址的详细地理信息，或查询结果存在一定误差。 * 在日志服务分析语句（SQL 语句）中，需要使用单引号（''）包裹代表字符串的字符，无符号包裹或被双引号（""）包裹的字符为字段名或列名。例如`'time'` 代表字符串，`time` 或 `"time"` 代表字段名或列名。 ::: |函数类型 |函数名称 |语法 |说明 | |---|---|---|---| |IPv4 地址函数|[IP_TO_CITY 函数](/docs/6470/1206718#3014effe) |IP_TO_CITY(KEY) |分析目标 IPv4 地址所属城市，并返回城市的中文名称。 |\ | | | | | |^^|^^|IP_TO_CITY(KEY, 'en') |分析目标 IPv4 地址所属城市，并返回城市的行政区划代码。 | |^^|[IP_TO_CITY_GEO 函数](/docs/6470/1206718#00008360) |IP_TO_CITY_GEO(KEY) |分析目标 IPv4 地址所属城市的经纬度，每个城市只有一个经纬度。 | |^^|[IP_TO_COUNTRY 函数](/docs/6470/1206718#9f68bee4) |IP_TO_COUNTRY(KEY) |分析目标 IPv4 地址所属国家或地区，并返回国家或地区的中文名称。 | |^^|^^|IP_TO_COUNTRY(KEY, 'en') |分析目标 IPv4 地址所属国家或地区，并返回国家或地区的代码。 | |^^|[IP_TO_CONTINENT 函数](/docs/6470/1206718#30831809) |IP_TO_CONTINENT(KEY) |分析目标 IPv4 地址所属大洲，并返回大洲的中文名称。 | |^^|^^|IP_TO_CONTINENT(KEY, 'en') |分析目标 IPv4 地址所属大洲，并返回大洲的代码。 | |^^|[IP_TO_DOMAIN 函数](/docs/6470/1206718#2994f174) |IP_TO_DOMAIN(KEY) |判断目标 IPv4 地址是内网地址还是外网地址。 | |^^|[IP_TO_GEO 函数](/docs/6470/1206718#367052dd) |IP_TO_GEO(KEY) |分析目标 IPv4 地址所在位置的经纬度。 | |^^|[IP_TO_PROVIDER 函数](/docs/6470/1206718#7886a2f6) |IP_TO_PROVIDER(KEY) |分析目标 IPv4 地址所对应的网络运营商。 | |^^|[IP_TO_PROVINCE 函数](/docs/6470/1206718#521aaa8a) |IP_TO_PROVINCE(KEY) |分析目标 IPv4 地址所属省份，并返回省份的中文名称。 | |^^|^^|IP_TO_PROVINCE(KEY, 'en') |分析目标 IPv4 地址所属省份，并返回省份的行政区划代码。 | |IPv4 网段函数 |[IS_PREFIX_SUBNET_OF 函数](/docs/6470/1206718#7e9b4836) |IS_PREFIX_SUBNET_OF(*x*, KEY) |判断目标 IPv4 网段是否为某网段的子网。 | |^^|[IS_SUBNET_OF 函数](/docs/6470/1206718#939bf017) |IS_SUBNET_OF(*x*, KEY) |判断目标 IPv4 地址是否在某网段内。 | |^^|[IP_SUBNET_RANGE 函数](/docs/6470/1206718#2777d1f2) |IP_SUBNET_RANGE(KEY) |获取 IPv4 网段范围。 | |IPv6地址函数 |[IPV6_TO_CITY 函数](/docs/6470/1206718#e79bf226) |IPV6_TO_CITY(KEY) |分析目标 IPv6 地址所属城市的名称。 | |^^|[IPV6_TO_CITY_GEO 函数](/docs/6470/1206718#64bdec9b) |IPV6_TO_CITY_GEO(KEY) |分析目标 IPv6 地址所属城市的经纬度。 | |^^|[IPV6_TO_COUNTRY 函数](/docs/6470/1206718#2cf609d9) |IPV6_TO_COUNTRY(KEY) |分析目标 IPv6 地址所属国家或地区。 | |^^|[IPV6_TO_CONTINENT 函数](/docs/6470/1206718#25efda6a) |IPV6_TO_CONTINENT(KEY) |分析目标 IPv6 地址所属大洲。 | |^^|[IPV6_TO_DOMAIN 函数](/docs/6470/1206718#62b641c6) |IPV6_TO_DOMAIN(KEY) |判断目标 IPv6 地址是内网地址还是外网地址。 | |^^|[IPV6_TO_PROVIDER 函数](/docs/6470/1206718#25d934e0) |IPV6_TO_PROVIDER(KEY) |分析目标 IPv6 地址所对应的网络运营商。 | |^^|[IPV6_TO_PROVINCE 函数](/docs/6470/1206718#8cf2fdab) |IPV6_TO_PROVINCE(*x*)) |分析目标 IPv6 地址所属省份。 | ## IP_TO_CITY 函数 IP_TO_CITY 函数用于分析指定的 IPv4 地址所属城市。 ### 函数**语法** * 语法格式 * 返回城市的中文名称。 ```SQL IP_TO_CITY(KEY) ``` * 返回城市的行政区划代码。 ```SQL IP_TO_CITY(KEY,'en') ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属城市的名称和行政区划代码。 * 检索和分析语句 ```SQL * | SELECT IP_TO_CITY(test_ip), IP_TO_CITY(test_ip, 'en') ``` * 检索和分析结果

## IP_TO_CITY_GEO 函数 IP_TO_CITY_GEO 函数用于分析指定的 IPv4 地址所属城市的经纬度。每个城市只有一个经纬度。 ### 函数**语法** * 语法格式 ```SQL IP_TO_CITY_GEO(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。格式为`纬度,经度`。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属城市的经纬度。 * 检索和分析语句 ```SQL * | SELECT IP_TO_CITY_GEO(test_ip) ``` * 检索和分析结果

## IP_TO_COUNTRY 函数 IP_TO_COUNTRY 函数用于分析指定的 IPv4 地址所属国家或地区。 ### 函数**语法** * 返回国家或地区的中文名称。 ```SQL IP_TO_COUNTRY(KEY) ``` * 返回国家或地区的代码。 ```SQL IP_TO_COUNTRY(KEY,'en') ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的国家或地区的中文名称和代码。 * 检索和分析语句 ```SQL * | SELECT IP_TO_COUNTRY(test_ip),IP_TO_COUNTRY(test_ip,'en') ``` * 检索和分析结果

## IP_TO_CONTINENT 函数 IP_TO_CONTINENT 函数用于分析指定的 IPv4 地址所属大洲。 ### 函数**语法** * 返回大洲的中文名称。 ```SQL IP_TO_CONTINENT(KEY) ``` * 返回大洲的代码。 ```SQL IP_TO_CONTINENT(KEY,'en') ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的大洲的中文名称和代码。 * 检索和分析语句 ```SQL * | SELECT IP_TO_CONTINENT(test_ip),IP_TO_CONTINENT(test_ip,'en') ``` * 检索和分析结果 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/16d24e51520f42ffa93e2e5fcf9d77e9 =951x) ## IP_TO_DOMAIN 函数 IP_TO_DOMAIN 函数用于分析指定的 IPv4 地址是内网地址还是外网地址。 ### 函数**语法** * 语法格式 ```SQL IP_TO_DOMAIN(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 intranet 或 internet。 * intranet ：内网。 * internet ：外网。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址是内网地址还是外网地址。 * 检索和分析语句 ```SQL * | SELECT IP_TO_DOMAIN(test_ip) ``` * 检索和分析结果

## IP_TO_GEO 函数 IP_TO_GEO 函数用于分析指定的 IPv4 地址所在位置的经纬度。 ### 函数**语法** * 语法格式 ```SQL IP_TO_GEO(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型，格式为`纬度,经度`。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所在的经纬度。 * 检索和分析语句 ```SQL * | SELECT IP_TO_GEO(test_ip) ``` * 检索和分析结果

## IP_TO_PROVIDER 函数 IP_TO_PROVIDER 函数用于分析指定的 IPv4 地址对应的网络运营商。 ### 函数**语法** * 语法格式 ```SQL IP_TO_PROVIDER(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的网络运营商。 * 检索和分析语句 ```SQL * | SELECT IP_TO_PROVIDER(test_ip) ``` * 检索和分析结果

## IP_TO_PROVINCE 函数 IP_TO_PROVINCE 函数分析指定的 IPv4 地址所属省份。 ### 函数**语法** * 语法格式 * 返回省份的中文名称。 ```SQL IP_TO_PROVINCE(KEY) ``` * 返回省份的行政区划代码。 ```SQL IP_TO_PROVINCE(KEY,'en') ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的省份名称和行政区划代码。 * 检索和分析语句 ```SQL * | SELECT IP_TO_PROVINCE(test_ip), IP_TO_PROVINCE(test_ip,'en') ``` * 检索和分析结果

## IS_PREFIX_SUBNET_OF 函数 IS_PREFIX_SUBNET_OF 函数用于判断指定的网段是否为目标网段的子网。 ### 函数**语法** * 语法格式 ```SQL IS_PREFIX_SUBNET_OF(x, KEY) ``` * 参数说明 |参数 |说明 | |---|---| |*x* |IPv4 网段。 | |KEY |字段、表达式，其值为 IPv4 网段。|\ | |判断该网段是否属于 x 网段内。 | * 返回值说明返回值为 Boolean 类型。 ### 函数示例 * 场景判断 `test_ip` 字段值所在网段是否属于 `192.168.0.1/24` 网段。 * 检索和分析语句 ```SQL * | SELECT IS_PREFIX_SUBNET_OF('192.168.0.1/24',CONCAT(test_ip,'/24')) ``` * 检索和分析结果

## IS_SUBNET_OF 函数 IS_SUBNET_OF 函数用于判断目标 IPv4 地址是否在指定的网段内。 ### 函数**语法** * 语法格式 ```SQL IS_SUBNET_OF(x, KEY) ``` * 参数说明 |参数 |说明 | |---|---| |*x* |IPv4 网段。 | |y |字段、表达式，其值为 IPv4 地址。|\ | |判断该 IP 地址是否属于 x 网段内。 | * 返回值说明返回值为 Boolean 类型。 ### 函数示例 * 场景判断 `test_ip` 字段值是否属于 `192.168.0.1/24` 网段。 * 检索和分析语句 ```SQL * | SELECT IS_SUBNET_OF('192.168.0.1/24',test_ip) ``` * 检索和分析结果

## IP_SUBNET_RANGE 函数 IP_SUBNET_RANGE 函数用于获取 IPv4 网段范围。 ### 函数**语法** * 语法格式 ```SQL IP_SUBNET_RANGE(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv4 网段。 | * 返回值说明返回值为 JSON 类型。 ### 函数示例 * 场景获取 `test_ip` 字段值所在网段的范围。 * 检索和分析语句 ```SQL * | SELECT IP_SUBNET_RANGE(CONCAT(test_ip,'/24')) ``` * 检索和分析结果

## IPV6_TO_CITY 函数 IPV6_TO_CITY 函数用于分析指定的 IPv6 地址所属城市的名称。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_CITY(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的城市名。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_CITY(test_ip) ``` * 检索和分析结果

## IPV6_TO_CITY_GEO 函数 IPV6_TO_CITY_GEO 函数用于分析指定的 IPv6 地址所属城市的经纬度。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_CITY_GEO(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型，格式为`纬度,经度`。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属城市的经纬度。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_CITY_GEO(test_ip) ``` * 检索和分析结果

## IPV6_TO_COUNTRY 函数 IPV6_TO_COUNTRY 函数用于分析指定的 IPv6 地址所属国家或地区。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_COUNTRY(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的国家或地区。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_COUNTRY(test_ip) ``` * 检索和分析结果

## IPV6_TO_CONTINENT 函数 IPV6_TO_CONTINENT 函数用于分析指定的 IPv6 地址所属大洲。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_CONTINENT(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的大洲。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_CONTINENT(test_ip) ``` * 检索和分析结果 ![图片](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/3c1bc796d0864320a37ec670f70b35d1 =797x) ## IPV6_TO_DOMAIN 函数 IPV6_TO_DOMAIN 函数用于判断指定的 IPv6 地址是内网地址还是外网地址。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_DOMAIN(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 intranet 或 internet。 * intranet：内网。 * internet：外网。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址是内网地址还是外网地址。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_DOMAIN(test_ip) ``` * 检索和分析结果

## IPV6_TO_PROVIDER 函数 IPV6_TO_PROVIDER 函数用于分析目标 IP 地址所对应的网络运营商。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_PROVIDER(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型。 ### 函数示例 * 场景通过 `test_ip` 字段查询相关 IPv6 地址所属的网络运营商。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_PROVIDER(test_ip) ``` * 检索和分析结果

## IPV6_TO_PROVINCE 函数 IPV6_TO_PROVINCE 函数用于分析目标 IPv6 地址所属省份。 ### 函数**语法** * 语法格式 ```SQL IPV6_TO_PROVINCE(KEY) ``` * 参数说明 |参数 |说明 | |---|---| |KEY |字段、表达式，其值为 IPv6 地址。 | * 返回值说明返回值为 Varchar 类型。函数示例 * 场景通过 `test_ip` 字段查询相关 IP 地址所属的省份。 * 检索和分析语句 ```SQL * | SELECT IPV6_TO_PROVINCE(test_ip) ``` * 检索和分析结果