Amazon Athena 中的函数

有关 Athena 引擎版本之间的函数变化，请参阅 Athena 引擎版本参考。有关可与 AT TIME ZONE 运算符共同使用的时区列表，请参阅 支持的时区。

Athena 引擎版本 3

Athena 引擎版本 3 中的函数是基于 Trino。有关 Trino 函数、运算符和表达式的信息，请参阅 函数和运算符 以及 Trino 文档中的以下子章节。

• 聚合

• 数组

• 二进制

• 按位运算

• Color (颜色)

• Comparison（比较）

• 条件

• 转换

• 日期和时间

• 十进制

• 地理空间

• HyperLogLog

• IP 地址

• JSON

• Lambda

• 逻辑

• 机器学习

• Map

• 数学

• 分位数摘要

• 正则表达式

• 会话

• 设置摘要

• String

• 表

• Teradata

• T-摘要

• URL

• UUID

• 窗口

invoker_principal() 函数

invoker_principal 函数是 Athena 引擎版本 3 独有的，在 Trino 中找不到。

返回 VARCHAR，其中包含运行调用函数的查询的主体（IAM 角色或 Identity Center 标识）的 ARN。例如，如果查询调用者使用 IAM 角色的权限来运行查询，则函数将返回 IAM 角色的 ARN。运行查询的角色必须允许 LakeFormation:GetDataLakePrincipal 操作。

使用量

SELECT invoker_principal()

下表显示了一个示例结果。

#	_col0
1	arn:aws:iam::111122223333:role/Admin

Athena 引擎版本 2

Athena 引擎版本 2 中的函数是基于 Presto 0.217。有关 Athena 引擎版本 2 中的地理空间函数的信息，请参阅 Athena 引擎版本 2 中的地理空间函数。

注意

Presto 0.217 函数的特定版本文档不再可用。有关当前 Presto 函数、运算符和表达式的信息，请参阅 Presto 函数和运算符，或者访问本节中的子类别链接。

• 逻辑运算符

• 比较函数和运算符

• 条件表达式

• 转换函数

• 数学函数和运算符

• 按位函数

• 十进制函数和运算符

• 字符串函数和运算符

• 二进制函数

• 日期与时间函数和运算符

• 正则表达式函数

• JSON 函数和运算符

• URL 函数

• 聚合函数

• 窗口函数

• 颜色函数

• 数组函数和运算符

• 映射函数和运算符

• Lambda 表达式和函数

• Teradata 函数