Hive SQL 精进系列：解锁 Hive SQL 中 KeyValue 函数的强大功能

---

目录

• • 一、引言
  • [二、KeyValue 函数基础](#二、KeyValue 函数基础)
  • • [2.1 语法结构详解](#2.1 语法结构详解)
    • • [形式一：`keyvalue(string ,string ,string , string )`](#形式一：keyvalue(string ,[string ,string ,] string ))
      • [形式二：`keyvalue(string ,string )`](#形式二：keyvalue(string ,string ))
    • [2.2 参数详解](#2.2 参数详解)
    • [2.3 返回值规则](#2.3 返回值规则)
  • 三、丰富的应用场景
  • • [3.1 解析学生成绩信息](#3.1 解析学生成绩信息)
    • [3.2 处理员工考勤数据](#3.2 处理员工考勤数据)
    • [3.3 分析网站访问参数](#3.3 分析网站访问参数)
    • [3.4 提取设备配置信息](#3.4 提取设备配置信息)
  • 四、使用注意事项
  • • [4.1 分隔符的准确性](#4.1 分隔符的准确性)
    • [4.2 空值处理](#4.2 空值处理)
    • [4.3 多匹配情况](#4.3 多匹配情况)
  • 五、总结

---

一、引言

KeyValue 函数作为一个独具特色的工具，在处理包含键值对信息的字符串时发挥着重要作用。它能够按照特定规则拆分字符串，精准提取出我们所需的键对应的值。本文将全方位深入剖析 KeyValue 函数，涵盖其语法、参数、返回值规则，以及丰富多样的应用场景，并给出相应的注意事项。

二、KeyValue 函数基础

2.1 语法结构详解

KeyValue 函数有两种调用形式，下面为你详细解释这两种形式的具体含义和使用方法。

形式一：keyvalue(string ,[string ,string ,] string )

这种形式适用于需要自定义分隔符的情况。具体参数从左到右依次为：

• 第一个 string：这是待拆分的字符串 str，其中包含了我们想要解析的键值对信息。例如，'姓名:张三;年龄:25;性别:男' 就是一个包含多个键值对的字符串。
• 第二个和第三个 string（可选）：分别对应 split1 和 split2。split1 用于将字符串 str 分割成多个键值对部分，split2 则用于将每个键值对部分拆分为键和值。比如，在字符串 '姓名:张三;年龄:25;性别:男' 中，如果我们指定 split1 为 ;，split2 为 :，那么函数就会按照这个规则进行拆分。
• 最后一个 string：这是我们要查找的键 key。例如，我们想查找 年龄 对应的值，那么这里就传入 年龄。

以下是一个示例代码，展示如何使用这种形式的 KeyValue 函数：

-- 查找字符串中 '年龄' 对应的键值
SELECT keyvalue('姓名:张三;年龄:25;性别:男', ';', ':', '年龄') AS age;

在这个示例中，函数会先使用 ; 将字符串拆分为 姓名:张三、年龄:25、性别:男 这几个部分，然后使用 : 将每个部分拆分为键和值，最后找到 年龄 对应的键值 25 并返回。

形式二：keyvalue(string ,string )

这种形式是在使用默认分隔符的情况下使用的。参数含义如下：

• 第一个 string：同样是待拆分的字符串 str。
• 第二个 string：是要查找的键 key。

当使用这种形式时，函数会默认使用 ; 作为 split1，: 作为 split2 来进行字符串的拆分。以下是示例代码：

-- 使用默认分隔符查找字符串中 '性别' 对应的键值
SELECT keyvalue('姓名:张三;年龄:25;性别:男', '性别') AS gender;

在这个示例中，函数会按照默认的分隔符规则拆分字符串，找到 性别 对应的键值 男 并返回。

2.2 参数详解

• key ：必选参数，类型为 STRING。它代表我们期望从字符串中提取对应值的键。例如，在前面提到的字符串 '姓名:张三;年龄:25;性别:男' 中，如果我们将 key 设置为 姓名，那么函数就会尝试找出 姓名 对应的 张三 这个值。
• str ：同样是必选的 STRING 类型参数，是包含键值对信息的待拆分字符串。这个字符串的格式需要符合一定的规则，即键值对之间以及键和值之间有明确的分隔符。
• split1、split2 ：这两个参数为可选的 STRING 类型。split1 用于将字符串 str 分割成多个键值对部分，split2 则负责把每个键值对部分拆分为键和值。若未指定这两个参数，split1 默认是 ;，split2 默认是 :。

2.3 返回值规则

• 若 split1 或 split2 为 NULL，函数返回 NULL。这是因为缺少分隔符，函数无法正确地对字符串进行拆分操作。
• 当 str 或 key 为 NULL，或者字符串中没有匹配的 key 时，函数也返回 NULL。例如，如果 str 为 NULL，那么就没有可供拆分的字符串；如果 key 为 NULL，则无法确定要查找的键；如果字符串中不存在指定的 key，自然也无法找到对应的值。
• 若存在多个匹配的键值对，函数返回第一个匹配的 key 对应的 Value。例如，在字符串 '姓名:张三;年龄:25;姓名:李四' 中，如果 key 为 姓名，函数会返回第一个匹配的 张三。

三、丰富的应用场景

3.1 解析学生成绩信息

在学校的教学管理系统中，学生的成绩信息可能以字符串形式存储，方便数据的记录和传输。例如，每个学生的成绩记录可能是 '语文:85;数学:90;英语:78' 这样的格式。现在我们要查询某个学生的数学成绩。

SELECT keyvalue('语文:85;数学:90;英语:78', '数学') AS math_score;

由于未指定 split1 和 split2，函数会使用默认的分隔符 ; 和 : 进行拆分，最终返回 90，即该学生的数学成绩。

3.2 处理员工考勤数据

企业的考勤系统可能会将员工的考勤信息以字符串形式存储，如 '出勤天数:22;迟到次数:1;请假天数:2'。若要了解某位员工的出勤天数，可以使用以下查询：

SELECT keyvalue('出勤天数:22;迟到次数:1;请假天数:2', '出勤天数') AS attendance_days;

同样依据默认分隔符，函数会准确返回 22，即该员工的出勤天数。

3.3 分析网站访问参数

在网站分析中，我们常常会遇到包含各种参数的 URL 字符串，比如 'https://example.com?page=home&category=electronics&sort=price'。现在我们想获取 category 参数的值。

SELECT keyvalue('https://example.com?page=home&category=electronics&sort=price', '&', '=', 'category') AS category_value;

这里我们明确指定了 split1 为 &，split2 为 =，函数会根据这些分隔符拆分字符串，返回 electronics，即访问的商品类别。

3.4 提取设备配置信息

在物联网设备管理中，设备的配置信息可能以字符串形式存储，例如 '分辨率:1920x1080;刷新率:60Hz;亮度:50%'。若要获取设备的刷新率信息，可以使用如下查询：

SELECT keyvalue('分辨率:1920x1080;刷新率:60Hz;亮度:50%', '刷新率') AS refresh_rate;

通过默认分隔符拆分，函数返回 60Hz，即设备的刷新率。

四、使用注意事项

4.1 分隔符的准确性

在使用 KeyValue 函数时，分隔符的选择至关重要。如果数据中的分隔符与默认分隔符不同，或者数据格式复杂，就需要准确指定 split1 和 split2。例如，若数据中的键值对以 | 分隔，键和值以 -> 分隔，就必须在函数中明确指定这些分隔符，否则会导致拆分结果错误。

4.2 空值处理

要特别注意输入参数中是否存在 NULL 值。无论是 str、key，还是 split1、split2 为 NULL，都可能导致函数返回 NULL。在实际应用中，建议在调用函数前对输入数据进行有效性检查，避免因空值问题影响数据处理结果。

4.3 多匹配情况

当字符串中存在多个匹配的键值对时，函数只会返回第一个匹配的结果。如果业务需求需要处理所有匹配的键值对，就需要结合其他函数或编写更复杂的逻辑来实现。

五、总结

Hive SQL 的 KeyValue 函数为我们处理包含键值对信息的字符串提供了便捷、高效的解决方案。通过深入理解其语法、参数和返回值规则，以及掌握丰富的应用场景和注意事项，能够在实际的数据处理工作中灵活运用该函数，准确提取所需的信息，从而更高效地完成数据洞察和分析任务。