所有函数(按字母顺序)

本主题按字母顺序列出所有 Snowflake 系统定义(即内置)的函数、标量或表。

该列表包括:

  • 每个函数的名称。

  • 每个函数的摘要。

  • 函数所属类别的列表。

函数名称

摘要

类别

A

ABS

返回数值表达式的绝对值。

数值函数

ACOS

计算其输入的反余弦值(反余弦);结果是 [0, pi] 区间中的数字。

数值函数

ACOSH

计算其输入的反双曲余弦值。

数值函数

ADD_MONTHS

在日期或时间戳上添加或减去指定的月数,保留月末信息。

日期和时间函数

ALERT_HISTORY

此 INFORMATION_SCHEMA 表函数可用于查询指定日期范围内的 警报 历史记录。

Information Schema表函数

ALL_USER_NAMES

返回当前账户中的所有用户名。

上下文函数

ANY_VALUE

返回组中表达式的某些值。

聚合函数窗口函数

APPLICATION_JSON

返回一个 JSON 对象,该对象指定用于通知的 JSON 消息。

通知函数

APPROX_COUNT_DISTINCT

使用 HyperLogLog 返回输入的非重复基数的近似值(即 HLL(col1, col2, ... ) 返回 COUNT(DISTINCT col1, col2, ... ) 的近似值)。

聚合函数窗口函数

APPROX_PERCENTILE

返回所需百分位数的近似值,即,如果列 c 中有 n 个数字,则 APPROX_PERCENTILE(c, p) 将返回一个数字,使 c 中大约有 n * p 个数字小于返回的数字。

聚合函数窗口函数

APPROX_PERCENTILE_ACCUMULATE

在聚合结束时返回 T-Digest 状态(作为 JSON 对象)的内部表示。

聚合函数窗口函数

APPROX_PERCENTILE_COMBINE

将多个百分位数输入状态组合(合并)为单个输出状态。

聚合函数窗口函数

APPROX_PERCENTILE_ESTIMATE

返回指定 T-Digest 状态所需的近似百分位数值。

聚合函数窗口函数

APPROX_TOP_K

使用 Space-Saving 返回输入中出现频率最高的值的近似值,以及其近似频率。

聚合函数窗口函数

APPROX_TOP_K_ACCUMULATE

在聚合结束时返回 Space-Saving 的摘要。

聚合函数窗口函数

APPROX_TOP_K_COMBINE

将多个输入状态组合(合并)为单个输出状态。

聚合函数窗口函数

APPROX_TOP_K_ESTIMATE

返回给定 Space-Saving 状态下出现频率最高的值的近似值及其估计频率。

聚合函数窗口函数

APPROXIMATE_JACCARD_INDEX

根据输入的 MinHash 状态返回其相似度(Jaccard 指数)的估计值。

聚合函数窗口函数

APPROXIMATE_SIMILARITY

根据输入的 MinHash 状态返回其相似度(Jaccard 指数)的估计值。

聚合函数窗口函数

ARRAY_AGG

返回输入值,并将其转换为数组。

聚合函数窗口函数半结构化和结构化数据函数

ARRAY_APPEND

返回一个包含源数组的所有元素以及新元素的数组。

半结构化和结构化数据函数

ARRAY_CAT

返回由两个数组连接而成的数组。

半结构化和结构化数据函数

ARRAY_COMPACT

返回一个移除了缺失值和 null 值的紧凑数组,从而有效地将稀疏数组转换为密集数组。

半结构化和结构化数据函数

ARRAY_CONSTRUCT

返回由零个、一个或多个输入构造的数组。

半结构化和结构化数据函数

ARRAY_CONSTRUCT_COMPACT

返回由零个、一个或多个输入构造的数组;构造的数组会忽略所有 NULL 输入值。

半结构化和结构化数据函数

ARRAY_CONTAINS

如果在指定的 ARRAY 中找到指定值,则返回 TRUE。

半结构化和结构化数据函数

ARRAY_DISTINCT

返回一个新 ARRAY,其中只包含与输入 ARRAY不同的元素。

半结构化和结构化数据函数

ARRAY_EXCEPT

返回一个新 ARRAY,其中包含来自某个输入 ARRAY 且其他输入 ARRAY 中不含的元素。

半结构化和结构化数据函数

ARRAY_FLATTEN

将 ARRAYs 中的 ARRAY 展平为单个 ARRAY。

半结构化和结构化数据函数

ARRAY_GENERATE_RANGE

返回一个 ARRAY,其值为指定范围(如 [2, 3, 4])内的整型值。

半结构化和结构化数据函数

ARRAY_INSERT

返回一个包含源数组的所有元素以及新元素的数组。

半结构化和结构化数据函数

ARRAY_INTERSECTION

返回一个数组,其中包含两个输入数组中的匹配元素。

半结构化和结构化数据函数

ARRAY_MAX

给定一个输入 ARRAY,返回具有最高值的元素,该元素不是 SQL NULL。

半结构化和结构化数据函数

ARRAY_MIN

给定一个输入 ARRAY,返回具有最低值的元素,该元素不是 SQL NULL。

半结构化和结构化数据函数

ARRAY_POSITION

返回元素在数组中首次出现位置的索引。

半结构化和结构化数据函数

ARRAY_PREPEND

返回一个包含新元素以及源数组的所有元素的数组。

半结构化和结构化数据函数

ARRAY_REMOVE

给定源 ARRAY,返回一个 ARRAY,其中包含已移除的指定值元素。

半结构化和结构化数据函数

ARRAY_REMOVE_AT

给定源 ARRAY,返回一个 ARRAY,其中包含位于指定位置的已移除元素。

半结构化和结构化数据函数

ARRAY_SIZE

返回输入数组的大小。

半结构化和结构化数据函数

ARRAY_SLICE

返回从输入数组的指定元素子集构造的数组。

半结构化和结构化数据函数

ARRAY_SORT

返回一个 ARRAY,包含按升序或降序排序的输入 ARRAY 的元素。

半结构化和结构化数据函数

ARRAY_TO_STRING

通过将所有值转换为字符串(使用 TO_VARCHAR),然后连接这些字符串(使用第二个实参中的字符串来分隔元素),以返回转换为字符串的输入数组。

半结构化和结构化数据函数

ARRAY_UNION_AGG

返回一个 ARRAY,其中包含列中的输入 ARRAYs 的非重复值并集。

聚合函数窗口函数

ARRAY_UNIQUE_AGG

返回一个 ARRAY,其中包含指定列中的所有非重复值。

聚合函数窗口函数

ARRAYS_OVERLAP

比较两个数组是否至少有一个共同元素。

半结构化和结构化数据函数

ARRAYS_TO_OBJECT

返回一个 OBJECT,其中包含一个输入 ARRAY 指定的键和另一个输入 ARRAY 指定的值。

半结构化和结构化数据函数

AS_<object_type>

此函数系列可用于将 VARIANT 值严格类型转换为其他数据类型。

半结构化和结构化数据函数

AS_ARRAY

将 VARIANT 值转换为数组。

半结构化和结构化数据函数

AS_BINARY

将 VARIANT 值转换为二进制字符串。

半结构化和结构化数据函数

AS_BOOLEAN

将 VARIANT 值转换为 BOOLEAN 值。

半结构化和结构化数据函数

AS_CHAR、AS_VARCHAR

将 VARIANT 值转换为字符串。

半结构化和结构化数据函数

AS_DATE

将 VARIANT 值转换为日期。

半结构化和结构化数据函数

AS_DECIMAL、AS_NUMBER

将 VARIANT 值转换为定点十进制值(与浮点值不匹配),精度和小数位数可选。

半结构化和结构化数据函数

AS_DOUBLE、AS_REAL

将 VARIANT 值转换为浮点值。

半结构化和结构化数据函数

AS_INTEGER

将 VARIANT 值转换为整数。

半结构化和结构化数据函数

AS_OBJECT

将 VARIANT 值转换为对象。

半结构化和结构化数据函数

AS_TIME

将 VARIANT 值转换为时间值。

半结构化和结构化数据函数

AS_TIMESTAMP_*

将 VARIANT 值转换为相应的 TIMESTAMP 值。

半结构化和结构化数据函数

ASCII

返回字符串第一个字符的 ASCII 代码。

字符串和二进制函数

ASIN

计算其实参的反正弦值(反正弦);结果是 [-pi/2, pi/2] 区间中的数字。

数值函数

ASINH

计算其实参的反双曲正弦值。

数值函数

ATAN

计算其实参的反正切值(反正切);结果是 [-pi, pi] 区间中的数字。

数值函数

ATAN2

计算其两个实参之比的反正切值(反正切)。

数值函数

ATANH

计算其实参的反双曲正切值。

数值函数

AUTO_REFRESH_REGISTRATION_HISTORY

此表函数可用于查询在指定对象的元数据中注册的数据文件的历史记录,以及为这些操作计费的 credit。

Information Schema表函数

AUTOMATIC_CLUSTERING_HISTORY

此表函数用于查询指定日期范围内给定表的 自动聚类 历史记录。

Information Schema表函数

AVG

返回非 NULL 记录的平均值。

聚合函数窗口函数

B

BASE64_DECODE_BINARY

将 Base64 编码的字符串解码为二进制值。

字符串和二进制函数

BASE64_DECODE_STRING

将 Base64 编码的字符串解码为字符串。

字符串和二进制函数

BASE64_ENCODE

使用 Base64 编码对输入(字符串或二进制值)进行编码。

字符串和二进制函数

[ NOT ] BETWEEN

当输入表达式(数值或字符串)在指定的下限和上限范围内时,返回 TRUE

条件表达式函数

BIT_LENGTH

以位为单位返回字符串或二进制值的长度。

字符串和二进制函数

BITAND

返回两个数值表达式按位进行 AND 运算的值。

按位表达式函数

BITAND_AGG

返回组中所有非 NULL 数字记录按位进行 AND 运算的值。

聚合函数窗口函数按位表达式函数

BITMAP_BIT_POSITION

给定一个数值,返回位图中表示该值的位的相对位置。

聚合函数

BITMAP_BUCKET_NUMBER

给定一个数值,返回位图的标识符(“桶编号”),此位图包含表示该值的位。

聚合函数

BITMAP_CONSTRUCT_AGG

返回一个位图,此位图包含为组中每个非重复值设置的位。

聚合函数

BITMAP_COUNT

给定一个表示某列的非重复值集合的位图,返回非重复值的数量。

聚合函数

BITMAP_OR_AGG

返回一个位图,此位图包含对输入位图进行二进制 OR 运算的结果。

聚合函数

BITNOT

返回数值表达式的按位取反结果。

按位表达式函数

BITOR

返回两个数值表达式按位进行 OR 运算的值。

按位表达式函数

BITOR_AGG

返回组中所有非 NULL 数字记录按位进行 OR 运算的值。

聚合函数窗口函数按位表达式函数

BITSHIFTLEFT

将数值表达式的位向左移动 n 位。

按位表达式函数

BITSHIFTRIGHT

将数值表达式的位向右移动 n 位。

按位表达式函数

BITXOR

返回两个数值表达式按位进行 XOR 运算的值。

按位表达式函数

BITXOR_AGG

返回组中所有非 NULL 数字记录按位进行 XOR 运算的值。

聚合函数窗口函数按位表达式函数

BOOLAND

计算两个数值表达式的布尔值 AND。

条件表达式函数

BOOLAND_AGG

如果组中所有非 NULL 布尔记录的计算结果都是 TRUE,则返回 TRUE。

聚合函数窗口函数条件表达式函数

BOOLNOT

计算单个数值表达式的布尔 NOT 值。

条件表达式函数

BOOLOR

计算两个数值表达式的布尔值 OR。

条件表达式函数

BOOLOR_AGG

如果组中至少有一条布尔记录的计算结果为 TRUE,则返回 TRUE。

聚合函数窗口函数条件表达式函数

BOOLXOR

计算两个数值表达式的布尔 XOR 值(即其中一个表达式是 TRUE,但不是两个表达式都是 TRUE)。

条件表达式函数

BOOLXOR_AGG

如果组中正好有一条布尔记录的值为 TRUE,则返回 TRUE。

聚合函数窗口函数条件表达式函数

BUILD_SCOPED_FILE_URL

使用暂存区名称和相对文件路径作为输入,生成指向暂存文件的有作用域的 Snowflake 文件 URL。

文件函数

BUILD_STAGE_FILE_URL

使用暂存区名称和相对文件路径作为输入,生成指向暂存文件的 Snowflake 文件 URL

文件函数

C

CASE

工作方式类似于级联的“if-then-else”语句。

条件表达式函数

CAST、::

将一种数据类型的值转换为另一种数据类型。

转换函数

CBRT

返回数值表达式的立方根。

数值函数

CEIL

返回来自 input_expr 的值,这些值四舍五入到最接近的相等或更大的整数值,或者四舍五入到具有指定小数位数、最接近的相等或更大的值。

数值函数

CHARINDEX

搜索在第二个实参中首次出现的第一个实参,如果成功找到,则返回第一个实参在第二个实参中的位置(从 1 开始)。

字符串和二进制函数

CHECK_JSON

检查 JSON 文档的有效性。

半结构化和结构化数据函数

CHECK_XML

检查 XML 文档的有效性。

半结构化和结构化数据函数

CHR、CHAR

将 Unicode 代码点(包含 7 位 ASCII)转换为与输入 Unicode 匹配的字符。

字符串和二进制函数

COALESCE

返回其实参中的第一个非 NULL 表达式;如果其所有实参都是 NULL,则返回 NULL。

条件表达式函数

COLLATE

返回原始字符串的副本,但此副本具有指定的 collation_specification 属性,而不是原始的 collation_specification 属性。

字符串和二进制函数

COLLATION

返回表达式的排序规则规范。

字符串和二进制函数

COMPLETE (SNOWFLAKE.CORTEX)

在给出提示时,使用您选择的受支持语言模型生成响应(补全)。

字符串和二进制函数

COMPLETE_TASK_GRAPHS

返回已完成的 图形 运行的状态。

Information Schema表函数

COMPRESS

使用压缩方法压缩输入字符串或二进制值。

字符串和二进制函数

CONCAT、||

连接一个或多个字符串,或连接一个或多个二进制值。

字符串和二进制函数

CONCAT_WS

连接两个或多个字符串,或连接两个或多个二进制值。

字符串和二进制函数

CONDITIONAL_CHANGE_EVENT

如果当前行中 expr1 实参的值与前一行中 expr1 的值不同,则返回窗口分区内每行的窗口事件编号。

窗口函数

CONDITIONAL_TRUE_EVENT

根据布尔实参 expr1 的结果,返回窗口分区内每行的窗口事件编号。

窗口函数

CONTAINS

如果 expr1 包含 expr2,则返回 true。

字符串和二进制函数

CONVERT_TIMEZONE

将时间戳转换为另一个时区。

日期和时间函数

COPY_HISTORY

此表函数可用于查询过去 14 天内不同维度的 Snowflake 数据加载历史记录。

Information Schema表函数

CORR

返回组中非 null 对的相关系数。

聚合函数窗口函数

COS

计算其实参的余弦值;实参应以弧度表示。

数值函数

COSH

计算其实参的双曲余弦值。

数值函数

COT

计算其实参的余切值;实参应以弧度表示。

数值函数

COUNT

返回指定列的非 NULL 记录数或记录总数。

聚合函数窗口函数

COUNT_IF

返回满足条件的记录数,如果没有记录满足条件,则返回 NULL。

聚合函数窗口函数

COVAR_POP

返回组中非 null 对的总体协方差。

聚合函数窗口函数

COVAR_SAMP

返回组中非 null 对的样本协方差。

聚合函数窗口函数

CUME_DIST

找出某个值相对于同一窗口分区内的其他值的累积分布。

窗口函数

CURRENT_ACCOUNT

返回用户当前会话使用的 账户定位器

上下文函数

CURRENT_ACCOUNT_NAME

返回当前账户的名称。

上下文函数

CURRENT_AVAILABLE_ROLES

返回一个字符串 (VARCHAR),其中列出了授予当前用户的所有账户级角色。

上下文函数

CURRENT_CLIENT

返回调用了该函数的客户端的版本。

上下文函数

CURRENT_DATABASE

返回当前会话使用的数据库的名称。

上下文函数

CURRENT_DATE

返回系统的当前日期。

上下文函数

CURRENT_IP_ADDRESS

返回提交请求的客户端的 IP 地址。

上下文函数

CURRENT_ORGANIZATION_NAME

返回当前账户所属的组织的名称。

上下文函数

CURRENT_REGION

返回当前用户登录的账户的区域名称。

上下文函数

CURRENT_ROLE

当主要角色是账户级角色时,返回当前会话使用的 主要角色 的名称;或者,如果当前会话使用的角色是数据库角色,则返回 NULL。

上下文函数

CURRENT_ROLE_TYPE

根据会话中的当前活跃角色是账户角色还是数据库角色,分别返回 ROLE 或 DATABASE_ROLE。

上下文函数

CURRENT_SCHEMA

返回当前会话使用的架构的名称。

上下文函数

CURRENT_SCHEMAS

返回活跃的搜索路径架构。

上下文函数

CURRENT_SECONDARY_ROLES

返回当前会话使用的 次要角色 的名称。

上下文函数

CURRENT_SESSION

返回与当前连接对应的 Snowflake 会话的唯一系统标识符。

上下文函数

CURRENT_STATEMENT

返回当前正在执行的语句的 SQL 文本。

上下文函数

CURRENT_TASK_GRAPHS

返回当前计划或正在执行的 图形 运行的状态。

Information Schema表函数

CURRENT_TIME

返回系统的当前时间。

上下文函数

CURRENT_TIMESTAMP

返回采用本地时区的系统当前时间戳。

上下文函数

CURRENT_TRANSACTION

返回当前会话中未完成事务的事务 ID。

上下文函数

CURRENT_USER

返回当前登录系统的用户名。

上下文函数

CURRENT_VERSION

返回当前的 Snowflake 版本。

上下文函数

CURRENT_WAREHOUSE

返回当前会话使用的仓库的名称。

上下文函数

D

DATA_METRIC_FUNCTION_REFERENCES

为每个获分配指定数据指标函数的对象返回一行,或者 为分配给指定对象的每个数据指标函数返回一行。

Information Schema表函数

DATA_METRIC_SCHEDULED_TIME

返回计划运行 DMF 的时间戳,如果手动调用该函数,则返回当前时间戳。

数据指标函数

DATA_TRANSFER_HISTORY

此表函数的用途是,查询指定日期范围内从 Snowflake 表传输到另一个云存储提供商网络(即从 Snowflake on AWS、Google Cloud Platform 或 Microsoft Azure 传输到另一个云提供商的网络)和/或地理区域的数据的历史记录。

Information Schema表函数

DATABASE_REFRESH_HISTORY

返回辅助数据库的刷新历史记录。

Information Schema表函数

DATABASE_REFRESH_PROGRESS、DATABASE_REFRESH_PROGRESS_BY_JOB

DATABASE_REFRESH_PROGRESS 函数系列可用于查询各个维度的数据库刷新状态。

Information Schema表函数

DATABASE_REPLICATION_USAGE_HISTORY

此表函数可用于查询指定日期范围内指定数据库的复制历史记录。

Information Schema表函数

DATABASE_STORAGE_USAGE_HISTORY

此表函数的用途是,查询指定日期范围内单个数据库(或账户中的所有数据库)的平均每日存储使用量(以字节为单位)。

Information Schema表函数

DATE_FROM_PARTS

从表示年、月、日的单个数值组件创建日期。

日期和时间函数

DATE_PART

从日期、时间或时间戳中提取指定的日期或时间部分。

日期和时间函数

DATE_TRUNC

将 DATE、TIME 或 TIMESTAMP 值截断为指定的精度。

日期和时间函数

DATEADD

将指定的日期或时间部分的指定值添加到日期、时间或时间戳中。

日期和时间函数

DATEDIFF

根据请求的日期或时间部分计算两个日期、时间或时间戳表达式之间的差异。

日期和时间函数

DAYNAME

从指定的日期或时间戳中提取三个字母的星期几名称。

日期和时间函数

DECODE

按顺序将选择表达式与每个搜索表达式进行比较。

条件表达式函数

DECOMPRESS_BINARY

将压缩的 BINARY 输入参数解压缩。

字符串和二进制函数

DECOMPRESS_STRING

将压缩的 BINARY 输入参数解压缩为字符串。

字符串和二进制函数

DECRYPT

使用 VARCHAR 加密短语对 BINARY 值进行解密。

加密函数

DECRYPT_RAW

使用 BINARY 密钥对 BINARY 值进行解密。

加密函数

DEGREES

将弧度转换为度。

数值函数

DENSE_RANK

返回一组值中某个值的排名,排名中没有间隔。

窗口函数

DIV0

像除法运算符 (/) 一样执行除法,但当除数为 0 时返回 0(而不是报告错误)。

数值函数

DIV0NULL

像除法运算符 (/) 一样执行除法,但当除数为 0 或 NULL 时返回 0(而不是报告错误或返回 NULL)。

数值函数

DUPLICATE_COUNT

返回具有重复项的列值的数量,包括 NULL 值。

数据指标函数

DYNAMIC_TABLE_GRAPH_HISTORY

此表函数返回有关当前账户中所有 动态表 的信息。

Information Schema表函数

DYNAMIC_TABLE_REFRESH_HISTORY

此表函数返回有关 动态表 每次刷新(已完成和正在运行)的信息。

Information Schema表函数

DYNAMIC_TABLES

此表函数返回有关 动态表 的元数据,其中包括当前时间 7 天内的聚合滞后指标和最近刷新的状态。

Information Schema表函数

E

EDITDISTANCE

计算两个输入字符串之间的 Levenshtein 距离。

字符串和二进制函数

EMAIL_INTEGRATION_CONFIG

返回一个 JSON 对象,该对象指定用于电子邮件通知的电子邮件通知集成、收件人和主题行。

通知函数

EMBED_TEXT_768 (SNOWFLAKE.CORTEX)

从英语文本创建向量嵌入。

字符串和二进制函数

ENCRYPT

使用 VARCHAR 加密短语对 VARCHAR 或 BINARY 值进行加密。

加密函数

ENCRYPT_RAW

使用 BINARY 密钥对 BINARY 值进行加密。

加密函数

ENDSWITH

如果第一个表达式以第二个表达式结尾,则返回 TRUE。

字符串和二进制函数

EQUAL_NULL

比较两个表达式是否相等。

条件表达式函数

EXP

计算欧拉数 (e) 的浮点值次方。

数值函数

EXPLAIN_JSON

此函数将 EXPLAIN 计划从 JSON 转换为表。

系统函数

EXTERNAL_FUNCTIONS_HISTORY

此表函数检索 Snowflake 为整个 Snowflake 账户调用的外部函数的历史记录。

Information Schema表函数

EXTERNAL_TABLE_FILES

此表函数的用途是,查询指定 外部表 的元数据中包含的暂存数据文件相关信息。

Information Schema表函数

EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY

此表函数可用于查询有关外部表的元数据历史记录的信息。

Information Schema表函数

EXTRACT

从日期、时间或时间戳中提取指定的日期或时间部分。

日期和时间函数

EXTRACT_ANSWER (SNOWFLAKE.CORTEX)

从文本文档中提取给定问题的答案。

字符串和二进制函数

EXTRACT_SEMANTIC_CATEGORIES

返回指定表或视图中每个支持的列的一组类别(语义和隐私)。

系统函数

F

FACTORIAL

计算其输入的阶乘。

数值函数

FILTER

基于 Lambda 表达式中的逻辑筛选 数组

半结构化和结构化数据函数

FIRST_VALUE

返回一组有序值中的第一个值。

窗口函数

FLATTEN

将复合值展平(分解)成多行。

表函数半结构化和结构化数据函数

FLOOR

返回来自 input_expr 的值,这些值四舍五入到最接近的相等或更小的整数值,或者四舍五入到具有指定小数位数、最接近的相等或更小的值。

数值函数

FRESHNESS

返回时间戳列的最大值与数据指标函数运行时的计划时间之间的差值(秒)。

数据指标函数

G

GENERATE_COLUMN_DESCRIPTION

使用 INFER_SCHEMA 函数输出,从一组包含半结构化数据的暂存文件中生成列的列表。

元数据函数

GENERATOR

根据指定的行数和/或指定的生成周期(以秒为单位)创建数据行。

表函数

GET

ARRAYOBJECT (或者包含 ARRAY 或 OBJECT 的 VARIANT)中提取一个值。

半结构化和结构化数据函数

GET_ABSOLUTE_PATH

使用暂存区名称和相对于暂存文件在暂存区中位置的路径作为输入,检索暂存文件的绝对路径。

文件函数

GET_ANACONDA_PACKAGES_REPODATA

返回 Anaconda 提供的第三方包的列表。

系统函数

GET_CONDITION_QUERY_UUID

返回为 警报 条件执行的 SQL 语句的查询 ID。

上下文函数

GET_DDL

返回可用于重新创建指定对象的 DDL 语句。

元数据函数

GET_IGNORE_CASE

从对象中提取字段值;如果任一实参为 NULL,则返回 NULL。

半结构化和结构化数据函数

GET_OBJECT_REFERENCES

返回指定对象引用的对象的列表。

表函数

GET_PATH、:

使用路径名从半结构化数据中提取值。

半结构化和结构化数据函数

GET_PRESIGNED_URL

使用暂存区名称和相对文件路径作为输入,生成指向暂存区文件的预签名 URL。

文件函数

GET_QUERY_OPERATOR_STATS

返回有关已完成查询中各个查询运算符的统计信息。

系统函数表函数

GET_RELATIVE_PATH

使用暂存区名称和云存储中的绝对文件路径作为输入,提取出暂存文件相对于其在暂存区中位置的路径。

文件函数

GET_STAGE_LOCATION

使用暂存区名称作为输入,检索外部或内部已命名暂存区的 URL。

文件函数

GETBIT

给定一个 INTEGER 值,返回指定位置的位值。

按位表达式函数

GETDATE

返回采用本地时区的系统当前时间戳。

上下文函数

GETVARIABLE

返回与 SQL 变量名关联的值。

上下文函数

GREATEST

返回表达式列表中的最大值。

条件表达式函数

GREATEST_IGNORE_NULLS

返回表达式列表中最大的非 NULL 值。

条件表达式函数

GROUPING

描述将哪个表达式列表分组到 GROUP BY 查询生成的行中。

聚合函数

GROUPING_ID

描述将哪个表达式列表分组到 GROUP BY 查询生成的行中。

聚合函数

H

H3_CELL_TO_BOUNDARY

返回表示 H3 单元格边界的 GEOGRAPHY 对象。

地理空间函数

H3_CELL_TO_CHILDREN

返回给定分辨率下 H3 单元格的子级 INTEGER IDs 的 ARRAY。

地理空间函数

H3_CELL_TO_CHILDREN_STRING

返回一个 VARCHARs ARRAY,其中包含给定分辨率下 H3 单元格的子级的十六进制 IDs。

地理空间函数

H3_CELL_TO_PARENT

返回给定分辨率的 H3 单元格的父单元 ID。

地理空间函数

H3_CELL_TO_POINT

返回 GEOGRAPHY 对象,此对象表示作为 H3 单元格的质心的点。

地理空间函数

H3_COMPACT_CELLS

返回一个 VARIANT 值的 数组,该数组包含更少、更大的 :ref:`H3 <label-data_types_geospatial_h3> ` 单元格的 INTEGER IDs,而该单元格与输入中的 H3 单元格覆盖相同区域。

地理空间函数

H3_COMPACT_CELLS_STRINGS

返回 VARIANT数组,其中包含 VARCHAR 十六进制 IDs,该数组中包含较少、较大的 H3 单元格,其覆盖区域与输入中的 H3 单元格相同。

地理空间函数

H3_COVERAGE

返回 IDs (作为 INTEGER 值)的 ARRAY,其标识完全覆盖某个形状(由 GEOGRAPHY 对象指定)的 H3 单元格的最小集合。

地理空间函数

H3_COVERAGE_STRINGS

返回十六进制 IDs (作为 VARCHAR 值)的 ARRAY,其标识完全覆盖某个形状(由 GEOGRAPHY 对象指定)的 H3 单元格的最小集合。

地理空间函数

H3_GET_RESOLUTION

返回 H3 单元格的分辨率。

地理空间函数

H3_GRID_DISK

返回距指定单元格 k 距离内的 H3 单元格 IDs 的 ARRAY。

地理空间函数

H3_GRID_DISTANCE

返回由 IDs 指定的两个 H3 单元格之间的距离。

地理空间函数

H3_GRID_PATH

返回表示两个单元格之间线条的 H3 单元格的 IDs 的 ARRAY。

地理空间函数

H3_INT_TO_STRING

H3 单元格 ID 的 INTEGER 值转换为十六进制格式。

地理空间函数

H3_IS_PENTAGON

如果 H3 单元格的边界表示五边形,则返回 TRUE。

地理空间函数

H3_IS_VALID_CELL

如果输入表示有效的 H3 单元格,则返回 TRUE。

地理空间函数

H3_LATLNG_TO_CELL

返回给定纬度、经度和分辨率下 H3 单元格 ID 的 INTEGER 值。

地理空间函数

H3_LATLNG_TO_CELL_STRING

以十六进制格式返回给定纬度、经度和分辨率下的 H3 单元格 ID (作为 VARCHAR 值)。

地理空间函数

H3_POINT_TO_CELL

返回给定分辨率下某个点(由 GEOGRAPHY 对象指定)的 H3 单元格 ID 的 INTEGER 值。

地理空间函数

H3_POINT_TO_CELL_STRING

返回给定分辨率下某个点(由 GEOGRAPHY 对象指定)的 H3 单元格 ID 的十六进制值。

地理空间函数

H3_POLYGON_TO_CELLS

返回 H3 单元格 IDs 的 INTEGER 值的 ARRAY,这些单元格的质心包含在 Polygon(由 GEOGRAPHY 对象指定)内。

地理空间函数

H3_POLYGON_TO_CELLS_STRINGS

返回 H3 单元格的十六进制 IDs 的 VARCHAR 值 ARRAY,这些单元格的质心包含在 Polygon(由 GEOGRAPHY 对象指定)内。

地理空间函数

H3_STRING_TO_INT

将十六进制格式的 H3 单元格 ID 转换为 INTEGER 值。

地理空间函数

H3_TRY_GRID_DISTANCE

H3_GRID_DISTANCE 的一个特殊版本,如果在尝试返回两个 H3 单元格之间的距离时出错,则返回 NULL。

地理空间函数

H3_TRY_GRID_PATH

H3_GRID_PATH 的一个特殊版本,如果在尝试返回一个 VARIANT 值数组(包含代表两个单元格之间的行的 H3 单元格 IDs)时出错,则返回 NULL。

地理空间函数

H3_UNCOMPACT_CELLS

返回 VARIANT 值数组,其中包含指定分辨率下 H3 单元格的 INTEGER IDs,其覆盖区域与输入中的 H3 单元格相同。

地理空间函数

H3_UNCOMPACT_CELLS_STRINGS

返回 VARIANT 值数组,其中包含指定分辨率下 H3 单元格的 VARCHAR 十六进制 IDs,其覆盖区域与输入中的 H3 单元格相同。

地理空间函数

HASH

返回已签名的 64 位哈希值。

哈希函数

HASH_AGG

返回输入行的(无序)集合上的汇总签名 64 位哈希值。

聚合函数窗口函数

HAVERSINE

使用 Haversine 公式计算地球表面两点之间的大圆距离(以千米为单位)。

地理空间函数

HEX_DECODE_BINARY

将十六进制编码的字符串解码为二进制值。

字符串和二进制函数

HEX_DECODE_STRING

将十六进制编码的字符串解码为字符串。

字符串和二进制函数

HEX_ENCODE

使用十六进制(也称为“hex”或“base16”)编码对输入进行编码。

字符串和二进制函数

HLL

使用 HyperLogLog 返回输入的非重复基数的近似值(即 HLL(col1, col2, ... ) 返回 COUNT(DISTINCT col1, col2, ... ) 的近似值)。

聚合函数窗口函数

HLL_ACCUMULATE

在聚合结束时返回 HyperLogLog 状态。

聚合函数窗口函数

HLL_COMBINE

将多个输入状态组合(合并)为单个输出状态。

聚合函数窗口函数

HLL_ESTIMATE

返回给定 HyperLogLog 状态的基数估计值。

聚合函数窗口函数

HLL_EXPORT

将 BINARY 格式的输入转换为 OBJECT 格式。

聚合函数窗口函数

HLL_IMPORT

将 OBJECT 格式的输入转换为 BINARY 格式。

聚合函数窗口函数

HOUR / MINUTE / SECOND

从时间或时间戳值中提取相应的时间部分。

日期和时间函数

I

IFF

根据布尔表达式的计算结果是 Ture 还是 False,返回两个值中的一个。

条件表达式函数

IFNULL

如果 expr1 是 NULL,则返回 expr2,否则返回 expr1

条件表达式函数

[ NOT ] ILIKE

执行不区分大小写的比较以确定字符串是否与指定模式相匹配。

字符串和二进制函数

ILIKE ANY

执行不区分大小写的比较,以将字符串与一个或多个指定模式进行匹配。

字符串和二进制函数

[ NOT ] IN

测试其实参是否是显式列表的成员之一或子查询的结果。

条件表达式函数

INFER_SCHEMA

自动检测一组包含半结构化数据的暂存数据文件中的文件元数据架构,并检索列定义。

表函数

INITCAP

返回输入字符串 (expr),其中每个单词的第一个字母为大写,后续字母为小写。

字符串和二进制函数

INSERT

用新的字符串或二进制值从指定位置开始替换指定长度的子字符串。

字符串和二进制函数

INTEGRATION

返回指定用于发送消息的通知集成的 JSON 对象。

通知函数

INVOKER_ROLE

返回执行查询的对象的账户级角色的名称,或者如果角色的名称是数据库角色,则返回 NULL。

上下文函数

INVOKER_SHARE

如果共享直接访问了调用 INVOKER_SHARE 函数的表或视图,则此函数返回该共享的名称。在其他情况下,此函数返回 NULL。

上下文函数

IS [ NOT ] DISTINCT FROM

比较两个表达式是否相等(或不相等)。

条件表达式函数

IS [ NOT ] NULL

确定表达式是 NULL 还是非 NULL。

条件表达式函数

IS_<object_type>

此函数系列用作布尔谓词,可用于确定在 VARIANT 列中存储的值的数据类型。

半结构化和结构化数据函数

IS_ARRAY

如果其 VARIANT 实参包含 ARRAY 值,则返回 TRUE。

半结构化和结构化数据函数

IS_BINARY

如果其 VARIANT 实参包含二进制字符串,则返回 TRUE。

半结构化和结构化数据函数

IS_BOOLEAN

如果其 VARIANT 实参包含布尔值,则返回 TRUE。

半结构化和结构化数据函数

IS_CHAR、IS_VARCHAR

如果其 VARIANT 实参包含字符串值,则返回 TRUE。

半结构化和结构化数据函数

IS_DATABASE_ROLE_IN_SESSION

验证数据库角色是否位于用户当前会话的活动主要角色或辅助角色层次结构中,或者指定的列是否包含用户当前会话的活动主要角色或辅助角色层次结构中的数据库角色。

上下文函数

IS_DATE、IS_DATE_VALUE

验证 VARIANT 值是否包含 DATE 值。

半结构化和结构化数据函数

IS_DECIMAL

如果 VARIANT 实参包含定点十进制值或整数值,则返回 TRUE。

半结构化和结构化数据函数

IS_DOUBLE、IS_REAL

如果其 VARIANT 实参包含浮点值、定点十进制值或整数值,则返回 TRUE。

半结构化和结构化数据函数

IS_GRANTED_TO_INVOKER_ROLE

如果 INVOKER_ROLE 函数返回的角色根据调用函数的上下文继承实参中指定角色的权限,则返回 TRUE。

上下文函数

IS_INSTANCE_ROLE_IN_SESSION

验证会话的用户活动主要角色或辅助角色层次结构是否继承指定的实例角色。

上下文函数

IS_INTEGER

如果其 VARIANT 实参包含整数值,则返回 TRUE。

半结构化和结构化数据函数

IS_NULL_VALUE

如果其 VARIANT 实参为 JSON null 值,则返回 true。

条件表达式函数半结构化和结构化数据函数

IS_OBJECT

如果其 VARIANT 实参包含 OBJECT 值,则返回 TRUE。

半结构化和结构化数据函数

IS_ROLE_IN_SESSION

验证账户角色是否位于会话的用户活跃主要角色或辅助角色层次结构中,或者指定的列是否包含会话的用户活跃主要角色或辅助角色层次结构中的角色。

上下文函数

IS_TIME

验证 VARIANT 值是否包含 TIME 值。

半结构化和结构化数据函数

IS_TIMESTAMP_*

验证 VARIANT 值是否包含相应的 TIMESTAMP 值。

半结构化和结构化数据函数

J

JAROWINKLER_SIMILARITY

计算两个输入字符串之间的 Jaro-Winkler 相似度 (link removed)。

字符串和二进制函数

JSON_EXTRACT_PATH_TEXT

将第一个实参解析为 JSON 字符串,并返回第二个实参中的路径指向的元素的值。

半结构化和结构化数据函数

K

KURTOSIS

返回非 NULL 记录的总体过量峰度。

聚合函数窗口函数

L

LAG

访问同一结果集中前一行的数据(无需将表与其自身联接)。

窗口函数

LAST_DAY

返回日期或时间戳的指定日期部分的最后一天。

日期和时间函数

LAST_QUERY_ID

返回当前会话中指定查询的 ID。

上下文函数

LAST_SUCCESSFUL_SCHEDULED_TIME

返回时间戳,该时间戳表示最近一次成功评估警报条件(执行评估操作时未出现错误)的计划时间。

日期和时间函数

LAST_TRANSACTION

返回在当前会话中提交或回滚的最后一个事务的事务 ID。

上下文函数

LAST_VALUE

返回一组有序值中的最后一个值。

窗口函数

LEAD

访问同一结果集中后续行中的数据,而无需将表联结到该数据。

窗口函数

LEAST

返回表达式列表中的最小值。

条件表达式函数

LEAST_IGNORE_NULLS

返回表达式列表中最小的非 NULL 值。

条件表达式函数

LEFT

返回其输入中最左侧的子字符串。

字符串和二进制函数

LENGTH、LEN

返回输入字符串或二进制值的长度。

字符串和二进制函数

[ NOT ] LIKE

执行区分大小写的比较,以确定字符串是否与指定的模式匹配。

字符串和二进制函数

LIKE ALL

执行区分大小写的比较,以将字符串与一个或多个指定模式进行匹配。

字符串和二进制函数

LIKE ANY

执行区分大小写的比较,以将字符串与一个或多个指定模式进行匹配。

字符串和二进制函数

LISTAGG

返回由 delimiter 字符串分隔的输入值的连接结果。

聚合函数窗口函数

LN

返回数值表达式的自然对数。

数值函数

LOCALTIME

返回系统的当前时间。

上下文函数

LOCALTIMESTAMP

返回采用本地时区的系统当前时间戳。

上下文函数

LOG

返回数值表达式的对数。

数值函数

LOGIN_HISTORY、LOGIN_HISTORY_BY_USER

LOGIN_HISTORY 表函数系列可用于查询 Snowflake 用户在不同维度的登录尝试。

Information Schema表函数

LOWER

返回所有字符转换为小写的输入字符串 (expr)。

字符串和二进制函数

LPAD

用另一个字符串中的字符向左填充字符串,或者用另一个二进制值中的字节向左填充二进制值。

字符串和二进制函数

LTRIM

从字符串中移除前导字符(包括空格)。

字符串和二进制函数

M

MAP_CAT

返回两个 MAPs 的连接结果。

半结构化和结构化数据函数

MAP_CONTAINS_KEY

确定指定的 MAP 是否包含指定的键。

半结构化和结构化数据函数

MAP_DELETE

返回一个 MAP,它基于现有的 MAP,并移除了其一个或多个键。

半结构化和结构化数据函数

MAP_INSERT

返回一个新 MAP,它由输入 MAP 组成,并插入了一个新的键值对(用新值更新了现有的键)。

半结构化和结构化数据函数

MAP_KEYS

返回 MAP 中的键。

半结构化和结构化数据函数

MAP_PICK

返回一个新 MAP,它包含现有 MAP 中的指定键值对。

半结构化和结构化数据函数

MAP_SIZE

返回 MAP 的大小。

半结构化和结构化数据函数

MATERIALIZED_VIEW_REFRESH_HISTORY

此表函数的用途是,查询指定日期范围内指定物化视图的 物化视图 刷新历史记录。

Information Schema表函数

MAX

返回 expr 中的记录的最大值。

聚合函数窗口函数

MAX_BY

查找包含某列最大值的行,并返回该行中另一列的值。

聚合函数

MD5、MD5_HEX

返回一个 32 字符的十六进制编码字符串,其包含 128 位 MD5 消息摘要。

字符串和二进制函数

MD5_BINARY

返回一个 16 字节的 BINARY 值,其包含 128 位 MD5 消息摘要。

字符串和二进制函数

MD5_NUMBER – 已过时

返回 128 位 MD5 消息摘要,该消息摘要解释为带符号的 128 位大端数。

字符串和二进制函数

MD5_NUMBER_LOWER64

计算 128 位 MD5 消息摘要,将其解释为带符号的 128 位大端序数字,并将数字的低 64 位作为无符号整数返回。

字符串和二进制函数

MD5_NUMBER_UPPER64

计算 128 位 MD5 消息摘要,将其解释为带符号的 128 位大端序数字,并将数字的上 64 位作为无符号整数返回。

字符串和二进制函数

MEDIAN

确定一组值的中位数。

聚合函数窗口函数

MIN

返回 expr 中的记录的最小值。

聚合函数窗口函数

MIN_BY

查找包含某列最小值的行,并返回该行中另一列的值。

聚合函数

MINHASH

返回 MinHash 状态,此状态包含一个大小为 k 的数组,该数组的构造方式为:向输入行应用 k 个不同哈希函数,并保留每个哈希函数的最小值。

聚合函数窗口函数

MINHASH_COMBINE

将多个 MinHash 输入状态组合为单个 MinHash 输出状态。

聚合函数窗口函数

MOD

返回输入 expr1 除以输入 expr2 的余数。

数值函数

MODE

对于 expr1 中的值,返回出现频率最高的值。

聚合函数窗口函数

MONTHNAME

从指定的日期或时间戳中提取三个字母的月份名称。

日期和时间函数

MONTHS_BETWEEN

返回两个 DATE 或 TIMESTAMP 值之间的月数。

日期和时间函数

N

NETWORK_RULE_REFERENCES

为每个与指定网络规则相关联的对象返回一行, 为每个与指定容器相关联的网络规则返回一行。

Information Schema表函数

NEXT_DAY

返回在输入日期之后出现的第一个指定 DOW (周中某天)的日期。

日期和时间函数

NORMAL

生成一个正态分布的伪随机浮点数,其具有指定的 meanstddev (标准差)。

数据生成函数

NOTIFICATION_HISTORY

此表函数可用于查询通过 Snowflake 发送的通知的历史记录。

Information Schema表函数

NTH_VALUE

返回一组有序值中的第 n 个值(不超过 1000)。

窗口函数

NTILE

将一个有序数据集按照 constant_value 指定的桶数平分。

窗口函数

NULL_COUNT

返回表中指定列的 NULL 值总数。

数据指标函数

NULLIF

如果 expr1 等于 expr2,则返回 NULL,否则返回 expr1

条件表达式函数

NULLIFZERO

如果该实参的计算结果为 0,则返回 NULL;否则返回该实参。

条件表达式函数

NVL

如果 expr1 是 NULL,则返回 expr2,否则返回 expr1

条件表达式函数

NVL2

根据第一个输入是否为 NULL 来返回值。

条件表达式函数

O

OBJECT_AGG

每组返回一个 OBJECT。

聚合函数窗口函数半结构化和结构化数据函数

OBJECT_CONSTRUCT

返回由实参构造的 OBJECT

半结构化和结构化数据函数

OBJECT_CONSTRUCT_KEEP_NULL

返回由实参构造的 OBJECT

半结构化和结构化数据函数

OBJECT_DELETE

返回一个对象,它包含输入(即源)对象的内容,并移除了一个或多个键。

半结构化和结构化数据函数

OBJECT_INSERT

返回一个对象,它由输入对象组成,并插入了一个新的键值对(或者用新值更新了现有的键)。

半结构化和结构化数据函数

OBJECT_KEYS

返回一个数组,它包含输入对象最顶层键的列表。

半结构化和结构化数据函数

OBJECT_PICK

返回一个新 OBJECT,它包含现有对象中的一些键值对。

半结构化和结构化数据函数

OCTET_LENGTH

返回字符串或二进制值的长度(以字节为单位)。

字符串和二进制函数

P

PARSE_IP

返回一个 JSON 对象,它由有效 INET (互联网协议)或 CIDR (无类别互联网域路由)IPv4 或 IPv6 字符串中的所有部分组成。

字符串和二进制函数

PARSE_JSON

将输入字符串解释为 JSON 文档,并生成一个 VARIANT 值。

半结构化和结构化数据函数

PARSE_URL

返回一个 JSON 对象,它由有效输入 URL/URI 中的所有部分(片段、主机、路径、端口、查询、方案)组成。

字符串和二进制函数

PARSE_XML

将输入字符串解释为 XML 文档,并生成一个 OBJECT 值。

半结构化和结构化数据函数

PERCENT_RANK

返回一组值中某个值的相对排名,此排名指定为介于 0.0 到 1.0 之间的百分比。

窗口函数

PERCENTILE_CONT

根据输入列(在 order_by_expr 中指定)的连续分布返回百分位值。

聚合函数窗口函数

PERCENTILE_DISC

根据输入列(在 order_by_expr 中指定)的离散分布返回百分位值。

聚合函数窗口函数

PI

将 pi 的值作为浮点值返回。

数值函数

PIPE_USAGE_HISTORY

此表函数的用途是,查询指定日期范围内使用 Snowpipe 加载到 Snowflake 表中的数据的历史记录。

Information Schema表函数

POLICY_CONTEXT

根据一个或多个上下文函数的值模拟查询结果,这让您可以确定策略如何影响查询结果。

上下文函数

POLICY_REFERENCES

为每个获分配指定策略的对象返回一行,或者 为分配给指定对象的每个策略返回一行。

Information Schema表函数

POSITION

搜索在第二个实参中首次出现的第一个实参,如果成功找到,则返回第一个实参在第二个实参中的位置(从 1 开始)。

字符串和二进制函数

POW、POWER

返回某个数字 (x) 的指定次幂 (y)。

数值函数

PREVIOUS_DAY

返回在输入日期之前出现的第一个指定 DOW (星期几)的日期。

日期和时间函数

Q

QUERY_ACCELERATION_HISTORY

QUERY_ACCELERATION_HISTORY 函数用于查询指定日期范围内的 Query Acceleration Service 历史记录。

Information Schema表函数

QUERY_HISTORY、QUERY_HISTORY_BY_*

QUERY_HISTORY 表函数系列可用于查询各个维度上的 Snowflake 查询历史记录。

Information Schema表函数

R

RADIANS

将度转换为弧度。

数值函数

RANDOM

每次调用都会返回一个伪随机 64 位整数。

数据生成函数

RANDSTR

返回指定长度 ( length) 的随机字符串。

数据生成函数

RANK

返回一组有序值中某个值的排名。

窗口函数

RATIO_TO_REPORT

返回组内某个值与组内值之和的比率。

窗口函数

[ NOT ] REGEXP

执行比较以确定字符串是否与指定模式相匹配。

字符串函数(正则表达式)

REGEXP_COUNT

返回模式在字符串中出现的次数。

字符串函数(正则表达式)

REGEXP_INSTR

返回字符串主体中正则表达式模式的指定匹配项的位置。

字符串函数(正则表达式)

REGEXP_LIKE

执行比较以确定字符串是否与指定模式相匹配。

字符串函数(正则表达式)

REGEXP_REPLACE

返回指定模式(或模式的所有匹配项)已被移除或替换为替换字符串的主体。

字符串函数(正则表达式)

REGEXP_SUBSTR

返回字符串中与正则表达式匹配的子字符串。

字符串函数(正则表达式)

REGEXP_SUBSTR_ALL

返回一个 ARRAY,其中包含字符串中与正则表达式匹配的所有子字符串。

字符串函数(正则表达式)

REGR_AVGX

返回组中非 null 对的自变量的平均值,其中 x 是自变量,y 是因变量。

聚合函数窗口函数

REGR_AVGY

返回组中非 null 对的因变量的平均值,其中 x 是自变量,y 是因变量。

聚合函数窗口函数

REGR_COUNT

返回组中非 null 数字对的数量。

聚合函数窗口函数

REGR_INTERCEPT

返回组中非 null 对的单变量线性回归直线的截距。

聚合函数窗口函数

REGR_R2

返回组中非 null 对的决定系数。

聚合函数窗口函数

REGR_SLOPE

返回组中非 null 对的线性回归直线的斜率。

聚合函数窗口函数

REGR_SXX

返回非 null 对的 REGR_COUNT(y, x) * VAR_POP(x)。

聚合函数窗口函数

REGR_SXY

返回非 null 对的 REGR_COUNT(expr1, expr2) * COVAR_POP(expr1, expr2)。

聚合函数窗口函数

REGR_SYY

返回非 null 对的 REGR_COUNT(y, x) * VAR_POP(y)。

聚合函数窗口函数

REGR_VALX

如果第一个实参为 NULL,则返回 NULL;否则,返回第二个实参。

条件表达式函数

REGR_VALY

如果第二个实参为 NULL,则返回 NULL;否则,返回第一个实参。

条件表达式函数

REPEAT

通过按指定次数重复输入来构建字符串。

字符串和二进制函数

REPLACE

移除在所有位置出现的指定子字符串,并可以选择将它们替换为另一个子字符串。

字符串和二进制函数

REPLICATION_GROUP_REFRESH_HISTORY

返回过去 14 天内辅助复制或故障转移组的复制历史记录。

Information Schema表函数

REPLICATION_GROUP_REFRESH_PROGRESS、REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB

REPLICATION_GROUP_REFRESH_PROGRESS 函数系列可用于查询复制组或故障转移组刷新的状态。

Information Schema表函数

REPLICATION_GROUP_USAGE_HISTORY

返回过去 14 天内辅助复制组或故障转移组的复制使用历史记录。

Information Schema表函数

REPLICATION_USAGE_HISTORY

此表函数可用于查询指定日期范围内指定数据库的复制历史记录。

Information Schema表函数

REST_EVENT_HISTORY

返回在指定时间间隔内向 Snowflake 发出的 SCIM REST API 请求的列表。

表函数

RESULT_SCAN

返回前一条命令的结果集(在执行查询的 24 小时内),就好像结果是一个表一样。

表函数

REVERSE

颠倒字符串中字符的顺序或二进制值中字节的顺序。

字符串和二进制函数

RIGHT

返回其输入中最右侧的子字符串。

字符串和二进制函数

[ NOT ] RLIKE

执行比较以确定字符串是否与指定模式相匹配。

字符串函数(正则表达式)

ROUND

返回 input_expr 的四舍五入值。

数值函数

ROW_COUNT

返回指定表的总行数。

数据指标函数

ROW_NUMBER

返回窗口分区内每行的唯一行号。

窗口函数

RPAD

用另一个字符串中的字符向右填充字符串,或者用另一个二进制值中的字节向右填充二进制值。

字符串和二进制函数

RTRIM

从字符串中移除尾随字符(包括空格)。

字符串和二进制函数

RTRIMMED_LENGTH

返回其实参的长度,减去尾随空格,但包括前导空格。

字符串和二进制函数

S

SCHEDULED_TIME

返回表示当前警报计划时间的时间戳。

日期和时间函数

SEARCH_OPTIMIZATION_HISTORY

此表函数用于查询指定日期范围内指定表的 搜索优化服务 维护历史记录。

Information Schema表函数

SENTIMENT (SNOWFLAKE.CORTEX)

返回给定英语输入文本的情绪分数。

字符串和二进制函数

SEQ1 / SEQ2 / SEQ4 / SEQ8

返回单调递增整数的序列(带回绕)。

数据生成函数

SERVERLESS_TASK_HISTORY

此表函数用于查询 无服务器任务 使用历史记录。

Information Schema表函数

SHA1、SHA1_HEX

返回一个 40 字符的十六进制编码字符串,其包含 160 位 SHA-1 消息摘要。

字符串和二进制函数

SHA1_BINARY

返回一个 20 字节的二进制值,其包含 160 位 SHA-1 消息摘要。

字符串和二进制函数

SHA2、SHA2_HEX

返回一个包含 N 位 SHA-2 消息摘要的十六进制编码字符串,其中 N 是指定的输出摘要大小。

字符串和二进制函数

SHA2_BINARY

返回一个包含 N 位 SHA-2 消息摘要的二进制值,其中 N 是指定的输出摘要大小。

字符串和二进制函数

SHOW_PYTHON_PACKAGES_DEPENDENCIES

返回指定的 Python 包的依赖项及其版本的列表。

系统函数

SIGN

返回其实参的符号。

数值函数

SIN

计算其实参的正弦值;实参应以弧度表示。

数值函数

SINH

计算其实参的双曲正弦值。

数值函数

SKEW

返回非 NULL 记录的样本偏度。

聚合函数

SOUNDEX

返回包含输入字符串的语音表示形式的字符串。

字符串和二进制函数

SOUNDEX_P123

返回包含输入字符串的语音表示形式的字符串,并在第一个和第二个字母使用相同数字时保留第二个字母的 Soundex 代码数字。

字符串和二进制函数

SPACE

构建一个由指定数量的空格组成的字符串。

字符串和二进制函数

SPLIT

使用给定的分隔符拆分给定的字符串,并在字符串数组中返回结果。

字符串和二进制函数

SPLIT_PART

在指定字符处拆分给定的字符串,并返回请求的部分。

字符串和二进制函数

SPLIT_TO_TABLE

此表函数拆分字符串(基于指定的分隔符),并将结果展平为行。

字符串和二进制函数表函数

SQRT

返回非负数值表达式的平方根。

数值函数

SQUARE

返回数值表达式的平方(即数值表达式乘以其自身)。

数值函数

ST_AREA

返回 GEOGRAPHYGEOMETRY 对象中多边形的面积。

地理空间函数

ST_ASEWKB

给定一个类型为 GEOGRAPHYGEOMETRY 的值,以 EWKB (扩展的已知二进制) 格式返回该值的二进制表示形式。

地理空间函数

ST_ASEWKT

给定一个类型为 GEOGRAPHYGEOMETRY 的值,以 EWKT (扩展的已知文本) 格式返回该值的文本 (VARCHAR) 表示形式。

地理空间函数

ST_ASGEOJSON

给定一个类型为 GEOGRAPHYGEOMETRY 的值,返回该值的 GeoJSON 表示形式。

地理空间函数

ST_ASWKB、ST_ASBINARY

给定一个类型为 GEOGRAPHYGEOMETRY 的值,以 `WKB (已知二进制)<https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary>`_ 格式返回该值的二进制表示形式。

地理空间函数

ST_ASWKT、ST_ASTEXT

给定一个类型为 GEOGRAPHYGEOMETRY 的值,以 `WKT (已知文本)<https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry>`_ 格式返回该值的文本 (VARCHAR) 表示形式。

地理空间函数

ST_AZIMUTH

给定一个表示原点(观察者位置)的点和一个指定的点,返回以弧度为单位的方位角。

地理空间函数

ST_BUFFER

返回一个表示 MultiPolygon 的 GEOMETRY 对象,该多边形包含输入 GEOMETRY 对象指定距离内的点。

地理空间函数

ST_CENTROID

返回表示 GEOGRAPHYGEOMETRY 对象的几何中心的点。

地理空间函数

ST_COLLECT

有两种形式的 ST_COLLECT。

地理空间函数

ST_CONTAINS

如果一个 GEOGRAPHYGEOMETRY 对象完全位于另一个相同类型的对象内,则返回 TRUE。

地理空间函数

ST_COVEREDBY

如果一个地理空间对象中没有点位于另一个地理空间对象之外,则返回 TRUE。

地理空间函数

ST_COVERS

如果一个地理空间对象中没有任何点位于另一个地理空间对象之外,则返回 TRUE。

地理空间函数

ST_DIFFERENCE

给定两个 GEOGRAPHY 输入对象,返回一个 GEOGRAPHY 对象,它表示第一个对象中不在第二个对象中的点(即两个对象之间的差异)。

地理空间函数

ST_DIMENSION

给定一个类型为 GEOGRAPHYGEOMETRY 的值,返回该值的“维度”。

地理空间函数

ST_DISJOINT

如果两个 GEOGRAPHY 对象或两个 GEOMETRY 对象不相交(即不共享空间的任何部分),则返回 TRUE。

地理空间函数

ST_DISTANCE

返回两个 GEOGRAPHY 对象之间的最小测地线距离,或两个 GEOMETRY 对象之间的最小欧几里得距离。

地理空间函数

ST_DWITHIN

如果两点(两个 GEOGRAPHY 对象)之间的最小测地线距离在指定距离之内,则返回 TRUE。

地理空间函数

ST_ENDPOINT

返回 LineString 中的最后一个点。

地理空间函数

ST_ENVELOPE

返回包围指定的 GEOGRAPHYGEOMETRY 对象的最小边界框(矩形“信封”)。

地理空间函数

ST_GEOGFROMGEOHASH

返回表示 地理哈希 边界的多边形的 GEOGRAPHY 对象。

地理空间函数转换函数

ST_GEOGPOINTFROMGEOHASH

返回表示 地理哈希 对象。

地理空间函数转换函数

ST_GEOGRAPHYFROMWKB

解析 WKB (已知二进制) (link removed) 或 EWKB (扩展的已知二进制) 输入,并返回 GEOGRAPHY 类型的值。

地理空间函数转换函数

ST_GEOGRAPHYFROMWKT

解析 `WKT (已知文本)<https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry>`_EWKT (扩展的已知文本) 输入,并返回 GEOGRAPHY 类型的值。

地理空间函数转换函数

ST_GEOHASH

返回 GEOGRAPHYGEOMETRY 对象的 地理哈希 (link removed)。

地理空间函数

ST_GEOMETRYFROMWKB

解析 `WKB (已知二进制)<https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary>`_ 或 EWKB (扩展的已知二进制)输入,并返回 GEOMETRY 类型的值。

地理空间函数转换函数

ST_GEOMETRYFROMWKT

解析 `WKT (已知文本)<https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry>`_ 或 EWKT (扩展的已知文本)输入,并返回 GEOMETRY 类型的值。

地理空间函数转换函数

ST_GEOMFROMGEOHASH

返回表示 地理哈希 (link removed) 边界的多边形的 GEOMETRY 对象。

地理空间函数

ST_GEOMPOINTFROMGEOHASH

返回表示 地理哈希 (link removed) 中心的点的 GEOMETRY 对象。

地理空间函数

ST_HAUSDORFFDISTANCE

返回两个 GEOGRAPHY 对象之间的离散 豪斯多夫距离 (link removed)。

地理空间函数

ST_INTERSECTION

给定两个 GEOGRAPHY 输入对象,返回一个 GEOGRAPHY 对象,它表示的形状包含了两个输入对象都拥有的点的集合(即两个对象的交集)。

地理空间函数

ST_INTERSECTION_AGG

给定一个 GEOGRAPHY 列,返回一个表示形状的 GEOGRAPHY 对象,该形状包含与列中的对象所表示的形状相同的组合点集(即形状的交集)。

地理空间函数

ST_INTERSECTS

如果两个 GEOGRAPHY 对象或两个 GEOMETRY 对象相交(即共享空间的任何部分),则返回 TRUE。

地理空间函数

ST_ISVALID

如果指定的 GEOGRAPHY 或 GEOMETRY 对象表示 有效形状,则返回 TRUE。

地理空间函数

ST_LENGTH

返回 GEOGRAPHY 对象中的 LineString 的测地线长度,或者 GEOMETRY 对象中的 LineString 的欧几里得长度。

地理空间函数

ST_MAKEGEOMPOINT、ST_GEOM_POINT

构造一个 GEOMETRY 对象,该对象表示具有指定经度和纬度的点。

地理空间函数

ST_MAKELINE

构造一个 GEOGRAPHYGEOMETRY 对象,它表示连接输入对象中各点的直线。

地理空间函数

ST_MAKEPOINT、ST_POINT

构造一个 GEOGRAPHY 对象,该对象表示具有指定经度和纬度的点。

地理空间函数

ST_MAKEPOLYGON、ST_POLYGON

构造一个 GEOGRAPHYGEOMETRY 对象,它表示一个无孔多边形。

地理空间函数

ST_MAKEPOLYGONORIENTED

构造一个 GEOGRAPHY 对象,它表示一个无孔多边形。

地理空间函数

ST_NPOINTS、ST_NUMPOINTS

返回 GEOGRAPHYGEOGRAPHY 对象中的点数。

地理空间函数

ST_PERIMETER

返回 GEOGRAPHYGEOMETRY 对象中多边形周长的长度。

地理空间函数

ST_POINTN

返回 LineString 中指定索引处的点。

地理空间函数

ST_SETSRID

返回一个 GEOMETRY 对象,其 SRID (空间参考系标识符)设置为指定值。

地理空间函数

ST_SIMPLIFY

给定一个表示直线或多边形的 GEOGRAPHYGEOMETRY 输入对象,返回该对象的简化近似对象。

地理空间函数

ST_SRID

返回 GEOGRAPHYGEOMETRY 对象的 SRID (空间参考系标识符)。

地理空间函数

ST_STARTPOINT

返回 LineString 中的第一个点。

地理空间函数

ST_SYMDIFFERENCE

给定两个 GEOGRAPHY 输入对象,返回一个 GEOGRAPHY 对象,它表示两个输入对象中不是对象交集一部分的点的集合(即两个对象的 对称差 (link removed))。

地理空间函数

ST_TRANSFORM

GEOMETRY 对象从一个 空间参考系 (SRS) (link removed) 转换为另一个空间参考系。

地理空间函数

ST_UNION

给定两个 GEOGRAPHY 输入对象,返回一个 GEOGRAPHY 对象,它表示两个对象的形状组合集(即两个形状的并集)。

地理空间函数

ST_UNION_AGG

给定一个 GEOGRAPHY 列,返回一个 GEOGRAPHY 对象,该对象表示由列中的对象所表示的至少一个形状中的组合点集(即形状的并集)。

地理空间函数

ST_WITHIN

如果第一个地理空间对象完全包含在第二个地理空间对象中,则返回 true。

地理空间函数

ST_X

返回由 GEOGRAPHYGEOMETRY 对象表示的点的经度(X 坐标)。

地理空间函数

ST_XMAX

返回指定的 GEOGRAPHYGEOMETRY 对象中包含的所有点的最大经度(X 坐标)。

地理空间函数

ST_XMIN

返回指定的 GEOGRAPHYGEOMETRY 对象中包含的所有点的最小经度(X 坐标)。

地理空间函数

ST_Y

返回由 GEOGRAPHYGEOMETRY 对象表示的点的纬度(Y 坐标)。

地理空间函数

ST_YMAX

返回指定的 GEOGRAPHYGEOMETRY 对象中包含的所有点的最大纬度(Y 坐标)。

地理空间函数

ST_YMIN

返回指定的 GEOGRAPHYGEOMETRY 对象中包含的所有点的最小纬度(Y 坐标)。

地理空间函数

STAGE_DIRECTORY_FILE_REGISTRATION_HISTORY

此表函数可用于查询有关目录表的元数据历史记录的信息。

Information Schema表函数

STAGE_STORAGE_USAGE_HISTORY

此表函数的用途是,查询指定日期范围内账户中 所有 Snowflake 暂存区的平均每日数据存储使用量(以字节为单位)。

Information Schema表函数

STARTSWITH

如果 expr1expr2 开头,则返回 true。

字符串和二进制函数

STDDEV、STDDEV_SAMP

返回非 NULL 值的样本标准差(样本方差的平方根)。

聚合函数窗口函数

STDDEV_POP

返回非 NULL 值的总体标准差(方差的平方根)。

聚合函数窗口函数

STRIP_NULL_VALUE

JSON null 值转换为 SQL NULL 值。

半结构化和结构化数据函数

STRTOK

将给定的字符串标记化,然后返回请求的部分。

字符串和二进制函数

STRTOK_SPLIT_TO_TABLE

使用给定的一组分隔符将字符串标记化,然后将结果展平为行。

字符串和二进制函数表函数

STRTOK_TO_ARRAY

使用给定的一组分隔符将给定的字符串标记化,然后将标记作为数组返回。

字符串和二进制函数半结构化和结构化数据函数

SUBSTR、SUBSTRING

返回 base_expr 中的字符串或二进制值的部分,从 start_expr 指定的字符/字节开始,并且可选择限制长度。

字符串和二进制函数

SUM

返回 expr 的非 NULL 记录总和。

聚合函数窗口函数

SUMMARIZE (SNOWFLAKE.CORTEX)

总结给定的英语输入文本。

字符串和二进制函数

SYSDATE

返回系统的当前时间戳,以 UTC 时区为准。

上下文函数

SYSTEM$ABORT_SESSION

中止指定的会话。

系统函数

SYSTEM$ABORT_TRANSACTION

如果指定的事务正在运行,则中止该事务。

系统函数

SYSTEM$ADD_EVENT(适用于 Snowflake Scripting)

添加一个用于跟踪的事件。

系统函数

SYSTEM$ALLOWLIST

返回要添加到防火墙允许名单的主机名和端口号,以便您可以从防火墙后面访问 Snowflake。

系统函数

SYSTEM$ALLOWLIST_PRIVATELINK

返回 AWS PrivateLink (https://aws.amazon.com/privatelink/)、Azure 专用链接 (https://azure.microsoft.com/en-us/services/private-link/) 和 Google Cloud Private Service Connect (https://cloud.google.com/vpc/docs/configure-private-service-connect-services) 部署的主机名和端口号,它们将添加到防火墙允许名单中,以便您可以从防火墙后面访问 Snowflake。

系统函数

SYSTEM$AUTHORIZE_PRIVATELINK

为当前账户启用与 Snowflake 服务的专用连接。

系统函数

SYSTEM$AUTHORIZE_STAGE_PRIVATELINK_ACCESS

授权 Snowflake 访问 Microsoft Azure Private Endpoint,以访问当前账户的 适用于内部暂存区的 Azure Private Endpoint

系统函数

SYSTEM$BEHAVIOR_CHANGE_BUNDLE_STATUS

返回当前账户的指定 行为变更版本捆绑包 的状态。

系统函数

SYSTEM$BLOCK_INTERNAL_STAGES_PUBLIC_ACCESS

防止所有公共流量访问 Microsoft Azure 上当前 Snowflake 账户的内部暂存区。

系统函数

SYSTEM$CANCEL_ALL_QUERIES

取消指定会话中的所有活跃/正在运行的查询。

系统函数

SYSTEM$CANCEL_QUERY

如果指定的查询(或语句)当前处于活跃/运行状态,则取消该查询(或语句)。

系统函数

SYSTEM$CLEANUP_DATABASE_ROLE_GRANTS

撤消对共享中已删除对象的权限,并向共享授予数据库角色。

系统函数

SYSTEM$CLIENT_VERSION_INFO

返回 Snowflake 客户端和驱动程序的版本信息。

系统函数

SYSTEM$CLUSTERING_DEPTH

根据指定的列(或为表定义的群集密钥)计算表的平均深度。

系统函数

SYSTEM$CLUSTERING_INFORMATION

根据表中的一列或多列,返回表的群集信息(包括平均群集深度)。

系统函数

SYSTEM$CLUSTERING_RATIO – 已弃用

根据表中的一列或多列计算表的群集比。

系统函数

SYSTEM$CONVERT_PIPES_SQS_TO_SNS

将使用 Amazon SQS (Simple Queue Service) 通知的管道转换为适用于 S3 桶的 Amazon Simple Notification Service (SNS) 服务。

系统函数

SYSTEM$CREATE_BILLING_EVENT

创建 可计费事件,该事件跟踪使用者对已安装的创收型应用程序的使用情况。

系统函数

SYSTEM$CURRENT_USER_TASK_NAME

返回从任务定义的语句或存储过程中调用时正在执行的任务的名称。

系统函数

SYSTEM$DATABASE_REFRESH_HISTORY – 已弃用

返回一个显示辅助数据库刷新历史记录的 JSON 对象。

系统函数

SYSTEM$DATABASE_REFRESH_PROGRESS、SYSTEM$DATABASE_REFRESH_PROGRESS_BY_JOB – 已弃用

SYSTEM$DATABASE_REFRESH_PROGRESS 函数系列可用于查询各个维度的数据库刷新状态。

系统函数

SYSTEM$DISABLE_BEHAVIOR_CHANGE_BUNDLE

为当前账户禁用指定 行为变更版本捆绑包 中包含的行为变更。

系统函数

SYSTEM$DISABLE_DATABASE_REPLICATION

禁用主数据库以及与其链接的所有辅助数据库的复制。

系统函数

SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE

为当前账户启用指定 行为变更版本捆绑包 中包含的行为变更。

系统函数

SYSTEM$ESTIMATE_QUERY_ACCELERATION

对于先前执行的查询,此函数返回一个 JSON 对象,该对象指定此查询是否符合使用 Query Acceleration Service 的条件。

系统函数

SYSTEM$ESTIMATE_SEARCH_OPTIMIZATION_COSTS

返回向给定表添加 搜索优化 以及为搜索优化配置特定列的估算成本。

系统函数

SYSTEM$EXPLAIN_JSON_TO_TEXT

此函数将 EXPLAIN 输出从 JSON 转换为格式化文本。

系统函数

SYSTEM$EXPLAIN_PLAN_JSON

给定 SQL 语句的文本,此函数会生成 JSON 格式的 EXPLAIN 执行计划。

系统函数

SYSTEM$EXTERNAL_TABLE_PIPE_STATUS

检索与外部表关联的内部(隐藏)管道对象的当前刷新状态的 JSON 表示形式。

系统函数

SYSTEM$FINISH_OAUTH_FLOW

设置在开始 OAuth 流程的 SYSTEM$START_OAUTH_FLOW 调用中作为实参传递的密钥的 OAUTH_REFRESH_TOKEN 参数值。

系统函数

SYSTEM$GENERATE_SAML_CSR

生成证书签名请求 (CSR),其主题设置为存储在 SAML2 集成 中的证书的主题,并且可以指定要在 CSR 中使用的 DN

系统函数

SYSTEM$GENERATE_SCIM_ACCESS_TOKEN

返回有效期为六个月的新 SCIM 访问令牌。

系统函数

SYSTEM$GET_AWS_SNS_IAM_POLICY

返回 AWS IAM 策略声明,该声明必须添加到 Amazon SNS 主题策略中,才能允许由 Snowflake 创建的 Amazon SQS 消息队列订阅该主题。

系统函数

SYSTEM$GET_CLASSIFICATION_RESULT

返回指定对象的分类结果。

系统函数

SYSTEM$GET_CMK_AKV_CONSENT_URL

返回与客户管理的密钥相关的 Azure Key Vault 账户的同意 URL。

系统函数

SYSTEM$GET_CMK_CONFIG

返回与客户管理的密钥 (CMKs) 和 Tri-Secret Secure 一起使用的配置信息:

系统函数

SYSTEM$GET_CMK_INFO

返回与 Tri-Secret Secure 一起使用的客户管理的密钥 (CMK) 的状态。

系统函数

SYSTEM$GET_CMK_KMS_KEY_POLICY

返回一个 ARRAY,其中包含与客户管理的密钥相关的 AWS Key Management Service 策略信息的片段。

系统函数

SYSTEM$GET_COMPUTE_POOL_STATUS

检索 计算池 的状态。

系统函数

SYSTEM$GET_DIRECTORY_TABLE_STATUS

返回一个记录列表,这些记录包含账户中暂存区的 目录表 一致性状态。

系统函数

SYSTEM$GET_GCP_KMS_CMK_GRANT_ACCESS_CMD

返回 Google Cloud gcloud 命令,以获取 Google Cloud Key Management Service 的策略信息,以便与客户管理的密钥一起使用。

系统函数

SYSTEM$GET_ICEBERG_TABLE_INFORMATION

返回 :doc:`Iceberg 表 </user-guide/tables-iceberg>`的根元数据文件位置和最新快照的状态。

系统函数

SYSTEM$GET_LOGIN_FAILURE_DETAILS

返回一个 JSON 对象,它表示与 External OAuth、SAML 或密钥对身份验证关联的失败登录尝试。

系统函数

SYSTEM$GET_PREDECESSOR_RETURN_VALUE

检索 任务图 中的前置任务的返回值。

系统函数

SYSTEM$GET_PRIVATELINK

验证当前账户是否获得了 Snowflake 服务的专用连接授权。

系统函数

SYSTEM$GET_PRIVATELINK_AUTHORIZED_ENDPOINTS

返回当前账户的授权端点列表,以便与 Snowflake 服务的专用连接结合使用。

系统函数

SYSTEM$GET_PRIVATELINK_CONFIG

返回必要 Snowflake 账户信息的 JSON 表示形式,这些信息有助于以自助方式配置与 Snowflake 服务或 Snowflake 内部暂存区的专用连接。

系统函数

SYSTEM$GET_SERVICE_LOGS

Snowpark Container Services 服务 容器中检索本地日志。

系统函数

SYSTEM$GET_SERVICE_STATUS

检索 Snowpark Container Services 服务 的状态。

系统函数

SYSTEM$GET_SNOWFLAKE_PLATFORM_INFO

返回 Snowflake 账户所在的虚拟网络的 IDs。

系统函数

SYSTEM$GET_TAG

返回与指定的 Snowflake 对象或列关联的标记值。

系统函数

SYSTEM$GET_TAG_ALLOWED_VALUES

返回可在 受支持的对象 上设置的逗号分隔的字符串值列表,或返回 NULL 以指示标签键没有任何指定的字符串值,并接受所有 可能 的字符串值。

系统函数

SYSTEM$GET_TAG_ON_CURRENT_COLUMN

根据指定的标签,返回分配给列的标签字符串;如果未向指定列分配标签,则返回 NULL。

系统函数

SYSTEM$GET_TAG_ON_CURRENT_TABLE

根据指定的标签,返回分配给表的标签字符串;如果没有为指定的表分配标签,则返回 NULL。

系统函数

SYSTEM$GET_TASK_GRAPH_CONFIG

对于从任务定义的语句或存储过程中调用时正在执行的任务,返回该任务的配置字符串的值。

系统函数

SYSTEM$GLOBAL_ACCOUNT_SET_PARAMETER

组织 中的指定账户启用复制和故障转移功能。

系统函数

SYSTEM$INTERNAL_STAGES_PUBLIC_ACCESS_STATUS

检查是否允许公共 IP 地址访问 Microsoft Azure 上当前 Snowflake 账户的内部暂存区。

系统函数

SYSTEM$LAST_CHANGE_COMMIT_TIME

返回一个令牌,它可用于检测数据库表或视图在两次调用该函数之间是否发生了变化。

系统函数

SYSTEM$LINK_ACCOUNT_OBJECTS_BY_NAME

向目标(当前)账户中的账户对象添加全局标识符,这些对象是使用脚本创建的,并与源账户中的同名对象相匹配。

系统函数

SYSTEM$LOG、SYSTEM$LOG_<level> (适用于 Snowflake Scripting)

以指定的严重性级别记录消息。

系统函数

SYSTEM$MIGRATE_SAML_IDP_REGISTRATION

将由账户参数 SAML_IDENTITY_PROVIDER 定义的现有 SAML 身份提供商(即 IdP)配置迁移至安全集成。

系统函数

SYSTEM$PIPE_FORCE_RESUME

强行恢复已使用 ALTER PIPE 暂停的管道。

系统函数

SYSTEM$PIPE_STATUS

检索管道当前状态的 JSON 表示形式。

系统函数

SYSTEM$QUERY_REFERENCE

返回可以传递给存储过程的 查询引用

系统函数

SYSTEM$REFERENCE

返回对表、视图或函数这些对象的 引用

系统函数

SYSTEM$REGISTER_CMK_INFO

注册与 Tri-Secret Secure 一起使用的客户管理的密钥 (CMK)。

系统函数

SYSTEM$REGISTRY_LIST_IMAGES – 已弃用

列出 镜像仓库 中的镜像。

系统函数

SYSTEM$REVOKE_PRIVATELINK

为当前账户禁用与 Snowflake 服务的专用连接。

系统函数

SYSTEM$REVOKE_STAGE_PRIVATELINK_ACCESS

撤消提供给 Snowflake 的以下授权:访问 Microsoft Azure Private Endpoint,以访问当前账户的 适用于内部暂存区的 Azure Private Endpoint

系统函数

SYSTEM$SET_RETURN_VALUE

显式设置任务的返回值。

系统函数

SYSTEM$SET_SPAN_ATTRIBUTES (适用于 Snowflake Scripting)

设置与包含跟踪事件的 span 相关的属性名称和值。

系统函数

SYSTEM$SHOW_ACTIVE_BEHAVIOR_CHANGE_BUNDLES

返回当前可用的 行为变更版本捆绑包 的数组、每个捆绑包的默认状态以及当前账户的捆绑包的实际状态。

系统函数

SYSTEM$SHOW_BUDGETS_IN_ACCOUNT

返回您有访问权限的账户中的 预算

系统函数

SYSTEM$SHOW_OAUTH_CLIENT_SECRETS

以字符串形式返回客户端密钥。

系统函数

SYSTEM$SNOWPIPE_STREAMING_UPDATE_CHANNEL_OFFSET_TOKEN

用新的偏移令牌更新 Snowpipe Streaming 使用的特定通道的偏移令牌。

系统函数

SYSTEM$START_OAUTH_FLOW

启动 OAUTH 客户端流程,返回在浏览器中使用的 URL,以完成 OAuth 同意过程。

系统函数

SYSTEM$STREAM_BACKLOG

返回指定流的当前 偏移 与当前时间戳之间的表版本集。

表函数

SYSTEM$STREAM_GET_TABLE_TIMESTAMP

返回位于指定流当前偏移处或之前的最新表版本的时间戳(以纳秒为单位)。

系统函数

SYSTEM$STREAM_HAS_DATA

指明指定的流是否包含变更数据获取 (CDC) 记录。

系统函数

SYSTEM$TASK_DEPENDENTS_ENABLE

递归恢复指定任务及其所有依赖任务。

系统函数

SYSTEM$TASK_RUNTIME_INFO

返回有关当前任务运行的信息。

系统函数

SYSTEM$TYPEOF

返回表示与表达式关联的 SQL 数据类型的字符串。

系统函数

SYSTEM$UNBLOCK_INTERNAL_STAGES_PUBLIC_ACCESS

允许来自公共 IP 地址的流量访问 Microsoft Azure 上当前 Snowflake 账户的内部暂存区。

系统函数

SYSTEM$USER_TASK_CANCEL_ONGOING_EXECUTIONS

中止系统已开始处理的指定任务的运行(即 TASK_HISTORY 输出中具有 EXECUTING 状态的运行)。

系统函数

SYSTEM$VALIDATE_STORAGE_INTEGRATION

验证指定存储集成的配置。

系统函数

SYSTEM$VERIFY_CMK_INFO

验证您的客户管理的密钥 (CMK) 配置并返回有关已注册的 CMK 的消息。

系统函数

SYSTEM$VERIFY_EXTERNAL_OAUTH_TOKEN

确定 External OAuth 访问令牌是否有效,或者已过期并需要重新生成。

系统函数

SYSTEM$WAIT

等待指定的时间后再继续。

系统函数

SYSTEM$WHITELIST – 已弃用

返回要添加到防火墙允许名单的主机名和端口号,以便您可以从防火墙后面访问 Snowflake。

系统函数

SYSTEM$WHITELIST_PRIVATELINK – 已弃用

返回 AWS PrivateLink (https://aws.amazon.com/privatelink/)、Azure 专用链接 (https://azure.microsoft.com/en-us/services/private-link/) 和 Google Cloud Private Service Connect (https://cloud.google.com/vpc/docs/configure-private-service-connect-services) 部署的主机名和端口号,它们将添加到防火墙允许名单中,以便您可以从防火墙后面访问 Snowflake。

系统函数

SYSTIMESTAMP

返回系统的当前时间戳。

上下文函数

T

TAG_REFERENCES

返回一个表,其中每行显示标记和值之间的关联。

Information Schema表函数

TAG_REFERENCES_ALL_COLUMNS

返回一个表,其中每行显示分配给特定列的标记名称和标记值。

Information Schema表函数

TAG_REFERENCES_WITH_LINEAGE

返回一个表,其中每行显示指定标记与标记关联到的 Snowflake 对象之间的关联。

Account Usage 表函数表函数

TAN

计算其实参的正切值;实参应以弧度表示。

数值函数

TANH

计算其实参的双曲正切值。

数值函数

TASK_DEPENDENTS

此表函数返回 任务图 中给定根任务的子 任务 列表。

Information Schema表函数

TASK_HISTORY

您可以使用此表函数查询指定日期范围内的 任务 使用历史记录。

Information Schema表函数

TEXT_HTML

返回一个 JSON 对象,该对象指定用于通知的 HTML 消息。

通知函数

TEXT_PLAIN

返回一个 JSON 对象,该对象指定用于通知的纯文本消息。

通知函数

TIME_FROM_PARTS

根据各个数字部分创建时间。

日期和时间函数

TIME_SLICE

计算时间“切片”的开始或结束,其中切片的长度是标准时间单位(分钟、小时、天等)的倍数。

日期和时间函数

TIMEADD

将指定的日期或时间部分的指定值添加到日期、时间或时间戳中。

日期和时间函数

TIMEDIFF

根据指定的日期或时间部分计算两个日期、时间或时间戳表达式之间的差异。

日期和时间函数

TIMESTAMP_FROM_PARTS

根据各个数字部分创建时间戳。

日期和时间函数

TIMESTAMPADD

将指定的日期或时间部分的指定值添加到日期、时间或时间戳中。

日期和时间函数

TIMESTAMPDIFF

根据指定的日期或时间部分计算两个日期、时间或时间戳表达式之间的差异。

日期和时间函数

TO_ARRAY

将输入表达式转换为 ARRAY

转换函数半结构化和结构化数据函数

TO_BINARY

将输入表达式转换为二进制值。

转换函数

TO_BOOLEAN

将输入文本或数值表达式转换为布尔值。

转换函数

TO_CHAR、TO_VARCHAR

将输入表达式转换为字符串。

转换函数

TO_DATE、DATE

将输入表达式转换为日期。

转换函数日期和时间函数

TO_DECIMAL、TO_NUMBER、TO_NUMERIC

将输入表达式转换为定点数。

转换函数

TO_DOUBLE

将表达式转换为双精度浮点数。

转换函数

TO_GEOGRAPHY

解析输入,并返回 GEOGRAPHY 类型的值。

地理空间函数转换函数

TO_GEOMETRY

解析输入,并返回 GEOMETRY 类型的值。

地理空间函数转换函数

TO_JSON

将 VARIANT 值转换为包含该值的 JSON 表示形式的字符串。

转换函数半结构化和结构化数据函数

TO_OBJECT

将输入值转换为 OBJECT

转换函数半结构化和结构化数据函数

TO_TIME、TIME

将输入表达式转换为时间。

转换函数日期和时间函数

TO_TIMESTAMP / TO_TIMESTAMP_*

将输入表达式转换为相应的时间戳。

转换函数日期和时间函数

TO_VARIANT

将任何值转换为 VARIANT 值或 NULL(如果输入为 NULL)。

转换函数

TO_XML

VARIANT 转换为包含该值的 XML 表示形式的 VARCHAR。

转换函数半结构化和结构化数据函数

TOP_INSIGHTS (SNOWFLAKE.ML)

在数据集中找到最重要的维度,从这些维度构建片段,然后检测这些片段中哪些对指标有影响。

表函数

TRANSFORM

基于 Lambda 表达式中的逻辑转换 数组

半结构化和结构化数据函数

TRANSLATE (SNOWFLAKE.CORTEX)

将给定的输入文本从一种受支持的语言翻译为另一种受支持的语言。

字符串和二进制函数

TRANSLATE

TRANSLATE() 函数替换字符串中的字符。

字符串和二进制函数

TRIM

从字符串中移除前导和尾随字符。

字符串和二进制函数

TRUNCATE、TRUNC

将输入表达式向下舍入到更接近于零的最接近(或相等)的整数,或者四舍五入到具有指定小数位数、最接近的相等或更小的值。

数值函数

TRUNC

将 DATE、TIME 或 TIMESTAMP 值截断为指定的精度。

日期和时间函数

TRY_BASE64_DECODE_BINARY

BASE64_DECODE_BINARY 的特殊版本,如果在解码过程中发生错误,它会返回 NULL 值。

字符串和二进制函数

TRY_BASE64_DECODE_STRING

BASE64_DECODE_STRING 的特殊版本,如果在解码过程中发生错误,它会返回 NULL 值。

字符串和二进制函数

TRY_CAST

CAST、:: 的特殊版本,可用于部分数据类型转换。

转换函数

TRY_DECRYPT

DECRYPT 的特殊版本,如果在解密过程中发生错误,它会返回 NULL 值。

加密函数

TRY_DECRYPT_RAW

DECRYPT_RAW 的特殊版本,如果在解密过程中发生错误,它会返回 NULL 值。

加密函数

TRY_HEX_DECODE_BINARY

HEX_DECODE_BINARY 的特殊版本,如果在解码过程中发生错误,它会返回 NULL 值。

字符串和二进制函数

TRY_HEX_DECODE_STRING

HEX_DECODE_STRING 的特殊版本,如果在解码过程中发生错误,它会返回 NULL 值。

字符串和二进制函数

TRY_PARSE_JSON

PARSE_JSON 的特殊版本,如果在解析过程中发生错误,它会返回 NULL 值。

半结构化和结构化数据函数

TRY_TO_BINARY

TO_BINARY 的特殊版本,它执行相同的操作(即将输入表达式转换为二进制值),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TRY_TO_BOOLEAN

TO_BOOLEAN 的特殊版本,它执行相同的操作(即将输入表达式转换为布尔值),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TRY_TO_DATE

TO_DATE 函数的特殊版本,它执行相同的操作(即将输入表达式转换为日期),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数日期和时间函数

TRY_TO_DECIMAL、TRY_TO_NUMBER、TRY_TO_NUMERIC

TO_DECIMAL、TO_NUMBER、TO_NUMERIC 的特殊版本,它执行相同的操作(即将输入表达式转换为定点数),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TRY_TO_DOUBLE

TO_DOUBLE 的特殊版本,它执行相同的操作(即将输入表达式转换为双精度浮点数),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TRY_TO_GEOGRAPHY

解析输入,并返回 GEOGRAPHY 类型的值。

地理空间函数转换函数

TRY_TO_GEOMETRY

解析输入,并返回 GEOMETRY 类型的值。

地理空间函数转换函数

TRY_TO_TIME

TO_TIME、TIME 的特殊版本,它执行相同的操作(即将输入表达式转换为时间),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TRY_TO_TIMESTAMP / TRY_TO_TIMESTAMP_*

TO_TIMESTAMP / TO_TIMESTAMP_* 的特殊版本,它执行相同的操作(即将输入表达式转换为时间戳),但支持错误处理(即,如果无法执行转换,它将返回 NULL 值而不是引发错误)。

转换函数

TYPEOF

返回存储在 VARIANT 列中的值的类型。

半结构化和结构化数据函数

U

UNICODE

返回字符串中第一个 Unicode 字符的 Unicode 代码点。

字符串和二进制函数

UNIFORM

生成一个位于 [min, max] 范围(含两者)内的均匀分布的伪随机数。

数据生成函数

UNIQUE_COUNT

返回表中指定列的唯一非 NULL 值总数。

数据指标函数

UPPER

返回所有字符转换为大写的输入字符串 expr

字符串和二进制函数

UUID_STRING

以格式化字符串的形式,生成一个符合 RFC 4122 版本 4(随机)或版本 5(命名)的 UUID。

字符串和二进制函数数据生成函数

V

VALIDATE

验证在过去执行 COPY INTO <table> 命令时加载的文件,并返回加载期间遇到的所有错误,而不仅仅是第一个错误。

表函数

VALIDATE_PIPE_LOAD

此表函数可用于验证指定时间范围内 Snowpipe 处理的数据文件。

Information Schema表函数

VAR_POP

返回组中非 NULL 记录的总体方差。

聚合函数窗口函数

VAR_SAMP

返回组中非 NULL 记录的样本方差。

聚合函数窗口函数

VARIANCE、VARIANCE_SAMP

返回组中非 NULL 记录的样本方差。

聚合函数窗口函数

VARIANCE_POP

返回组中非 NULL 记录的总体方差。

聚合函数窗口函数

VECTOR_COSINE_SIMILARITY

计算两个 向量 之间的余弦相似性。

向量相似性函数

VECTOR_INNER_PRODUCT

计算两个 向量 的内积。

向量相似性函数

VECTOR_L2_DISTANCE

计算两个 向量 之间的 L2 距离。

向量相似性函数

W

WAREHOUSE_LOAD_HISTORY

此表函数可用于查询指定日期范围内单个仓库的活动历史记录(定义为“查询负载”)。

Information Schema表函数

WAREHOUSE_METERING_HISTORY

此表函数可用在查询中,以返回指定日期范围内单个仓库(或账户中的所有仓库)的每小时 Credit 使用量。

Information Schema表函数

WIDTH_BUCKET

构造等宽直方图(其中直方图范围被划分为大小相同的间隔),并在对表达式求值后返回表达式的值落入的桶编号。

数值函数

X

XMLGET

根据指定标签的名称和实例编号,从外部 XML 元素的内容中提取 XML 元素对象(通常简称为 标签)。

半结构化和结构化数据函数

Y

YEAR* / DAY* / WEEK* / MONTH / QUARTER

从日期或时间戳中提取相应的日期部分。

日期和时间函数

Z

ZEROIFNULL

如果其实参为 null,则返回 0;否则,返回其实参。

条件表达式函数

ZIPF

返回 N 个元素和特征指数为 s 的 Zipf 分布整数。

数据生成函数

语言: 中文