内置函数摘要

Greenplum数据库支持内置函数和运算符，包括可用于窗口表达式的分析函数和窗口函数。 有关使用内置Greenplum数据库函数的信息，请参阅Greenplum数据库管理员指南中的“使用函数和运算符”。

• Greenplum数据库函数类型
• 内置函数和运算符
• JSON函数和操作符
• 窗口函数
• 高级聚合函数
• 文本搜索函数和操作符
• 范围函数和运算符

Parent topic: Greenplum数据库参考指南

Greenplum数据库函数类型

Greenplum数据库评估SQL表达式中使用的函数和运算符。 某些函数和运算符只允许在master服务器上执行，因为它们可能导致Greenplum数据库segment实例中的不一致。 该表描述了Greenplum数据库函数类型。

Table 1. Greenplum数据库中的函数

在Greenplum数据库中，数据跨segment分割 - 每个segment是不同的PostgreSQL数据库。 为了防止出现不一致或意外的结果，如果它们包含SQL命令或以任何方式修改数据库，则不要在segment级别执行归类为VOLATILE的函数。 例如，不允许在Greenplum数据库中对分布式数据执行诸如setval()之类的函数，因为它们可能导致segment实例之间的数据不一致。

为确保数据一致性，可以在master服务器上评估和运行的语句中安全地使用VOLATILE和STABLE函数。 例如，以下语句在master上运行（没有FROM子句的语句）：

SELECT setval('myseq', 201);
SELECT foo();

如果语句具有包含分布式表的FROM子句，并且FROM子句中的函数返回一组行，则该语句可以在segment上运行：

SELECT * from foo();

Greenplum数据库不支持返回表引用（rangeFuncs）的函数或使用refCursor数据类型的函数。

内置函数和运算符

下表列出了PostgreSQL支持的内置函数和运算符的类别。 Greenplum数据库支持所有函数和运算符，如PostgreSQL，但STABLE和VOLATILE函数除外，它们受Greenplum数据库函数类型中的限制。 有关这些内置函数和运算符的更多信息，请参阅PostgreSQL文档的函数和运算符部分。

Table 2. 内置函数和运算符

JSON函数和操作符

Greenplum数据库包含用于创建和操作JSON数据的内置函数和运算符。

• JSON操作符
  • JSON创建函数
  • JSON聚合函数
  • JSON处理函数

Note: 对于json数据类型值，即使JSON对象包含重复键，也会保留所有键/值对。 对于重复键，JSON处理函数将最后一个值视为可操作的值。 对于jsonb数据类型，不保留重复的对象键。 如果输入包含重复键，则仅保留最后一个值。 参考 关于JSON数据。

JSON操作符

此表描述了可用于json和jsonb数据类型的运算符。

Table 3. json和jsonb操作符

Note: 对于json和jsonb数据类型，这些运算符都有并行变体。 字段，元素和路径提取运算符返回与其左侧输入（json或jsonb）相同的数据类型，但指定为返回text的那些除外，它将值强制转换为text。 如果JSON输入没有与请求匹配的正确结构，则字段，元素和路径提取操作符将返回NULL，而不是失败; 例如，如果不存在这样的元素。

需要jsonb数据类型作为左操作数的运算符如下表所述。 其中许多运算符可以由jsonb运算符类索引。 有关jsonb包含和存在语义的完整描述，请参阅jsonb容器与存在。 有关如何使用这些运算符有效地索引jsonb数据的信息，请参阅jsonb索引 。

Table 4. jsonb操作符

下表中的标准比较运算符仅适用于jsonb数据类型，不适用于json数据类型。 它们遵循jsonb索引中描述的B树操作的排序规则 。

Table 5. jsonb比较操作符

Note: !=运算符在解析器阶段转换为<>。 不可能实现执行不同操作的!=和<>运算符。

JSON创建函数

此表描述了创建json数据类型值的函数。 （目前，jsonb没有等效函数，但您可以将其中一个函数的结果转换为jsonb。）

Table 6. JSON创建函数

Note: array_to_json和row_to_json与to_json具有相同的行为， 除了提供漂亮的打印选项。 为to_json描述的行为同样适用于由其他JSON创建函数转换的每个单独的值。

Note: hstore扩展具有从hstore到json的强制转换， 因此通过JSON创建函数转换的hstore值将表示为JSON对象，而不是原始字符串值。

JSON聚合函数

此表显示函数将记录聚合到JSON对象数组和值对聚合到JSON对象

Table 7. JSON聚合函数

JSON处理函数

此表显示可用于处理json和jsonb值的函数。

许多这些处理函数和运算符将JSON字符串中的Unicode转义转换为适当的单个字符。 如果输入数据类型是jsonb，则这不是问题，因为转换已经完成。 但是，对于json数据类型输入，这可能会导致抛出错误。 请参阅 关于JSON数据。

Table 8. JSON处理函

Note:

1. 函数json_populate_record()， json_populate_recordset()， json_to_record()和json_to_recordset()的示例使用常量。 但是，典型的用法是引用FROM子句中的表，并使用其中一个json或jsonb列作为函数的参数。 然后可以在查询的其他部分中引用所提取的键值。 例如，可以在WHERE子句和目标列表中引用该值。 以这种方式提取多个值可以提高性能，而不是使用每个键操作符单独提取它们。 JSON键与目标行类型中的相同列名匹配。 这些函数的JSON类型强制转换可能不会产生某些类型的期望值。 将不会在输出中省略未出现在目标行类型中的JSON字段，并且与任何JSON字段不匹配的目标列将为NULL。
2. 不应将json_typeof函数null返回值null与SQL NULL混淆。 调用json_typeof('null'::json)将返回null， 调用json_typeof(NULL::json)将返回SQLNULL。

窗口函数

以下是Greenplum数据库内置窗口函数。 所有窗口函数都是不可变的。 有关窗口函数的更多信息，请参阅Greenplum数据库管理员指南中的“窗口表达式”。

Table 9. 窗口函数

高级聚合函数

以下内置高级分析函数是PostgreSQL数据库的Greenplum扩展。 分析函数是不可变的。

Note: Greenplum MADlib分析扩展提供了额外的高级功能，可以使用Greenplum数据库数据执行统计分析和机器学习。 请参阅Greenplum MADlib分析扩展。

Table 10. 高级聚合函数

文本搜索函数和操作符

下表总结了为全文搜索提供的函数和运算符。 有关Greenplum数据库文本搜索工具的详细说明， 请参阅使用全文搜索。

Table 11. 文本搜索运算符

Note: tsquery包含运算符仅考虑两个查询中列出的词位，忽略组合运算符。

除了表中显示的运算符之外，还为类型tsvector和tsquery定义了普通的B树比较运算符（=, \<, 等）。 这些对于文本搜索不是很有用，但允许在这些类型的列上构建唯一索引。

Table 12. 文本搜索函数

Note: 接受可选的regconfig参数的所有文本搜索函数将在省略该参数时使用default_text_search_config指定的配置。

下表中的功能单独列出，因为它们通常不用于日常文本搜索操作。 它们有助于开发和调试新的文本搜索配置。

Table 13. 文本搜索调试函数

范围函数和运算符

有关范围类型的概述，请参阅范围类型。

下表显示了可用于范围类型的运算符。

Table 14. 范围运算符

简单比较运算符<，>，<=和>=首先比较下限，只有在相等的情况下，才比较上限。 这些比较通常对范围不是很有用，但提供的是允许在范围上构建B树索引。

当涉及空范围时，左/右/邻接运算符总是返回false; 也就是说，空范围不被认为是在任何其他范围之前或之后。

如果结果范围需要包含两个不相交的子范围，则并集和差异运算符将失败，因为无法表示这样的范围。

下表显示了可用于范围类型的函数。

Table 15. 范围函数

如果范围为空或请求的边界为无限，则lower和upper函数返回null。 对于空范围，lower_inc，upper_inc，lower_inf和upper_inf函数都返回false。