表函数¶

表函数的简单示例¶

以下函数适合作为表函数：

• 接受账户和日期，并返回在该日期记入该账户的所有费用的函数。（在某一特定日期可能会收取多项费用。)

• 接受用户 ID 并返回分配给该用户的数据库角色的函数。（用户可能具有多个角色，包括“sysadmin”和“useradmin”。）

每个输出行依赖于多个输入行的函数¶

表函数可以根据影响每个输出行的输入行数分为两类：

• 1 对 N

• M 对 N

前面描述的函数是 1 对 N 表函数：每个输出行仅依赖于一个输入行。例如，函数 record_high_temperatures_for_date() 可能会产生多个输出行（在该日期达到记录的每个城市一行）。特定输入日期的每个输出行仅取决于该日期；每个输出行都独立于每隔一个日期的行。

Snowflake 还支持 M 到 N 表函数：每个输出行可以依赖于多个输入行。例如，如果函数生成股票价格的移动平均线，则该函数使用来自多个输入行（多个日期）的股票价格来生成每个输出行。

更一般地说，在 M 到 N 函数中，一组 M 个输入行生成一组 N 个输出行。M 可以是一行或多行。N 可以是零行、一行或多行。

例如，在 10 天移动平均线中，M 为 10。N 为 1，因为每组 10 个输入行生成一个平均价格。

内置表函数与用户定义表函数¶

Snowflake 提供了数百个内置函数，其中许多是表函数。内置表函数在 系统定义表函数 中列出。

Users can also write their own functions, called user-defined functions or "UDFs". Some UDFs are scalar; some are tabular. User-defined table functions are called "UDTFs". For information about UDFs (including UDTFs), see 用户定义的函数概述.

内置表函数和用户定义表函数通常遵循相同的规则；例如，它们的调用方式与 SQL 语句相同。

在 FROM 子句中使用表函数¶

表包含一组行。同样，表函数返回一组行。表和表函数都用于需要一组行的上下文中。具体来说，表函数用于 SQL 语句的 FROM 子句中。

为了帮助 SQL 编译器将表函数识别为行源，Snowflake 要求表函数调用由 TABLE() 关键字封装。

例如，以下语句调用名为 record_high_temperatures_for_date() 的表函数，该函数将值 DATE 作为实参：

SELECT city_name, temperature
    FROM TABLE(record_high_temperatures_for_date('2021-06-27'::DATE))
    ORDER BY city_name;

Copy

For more information about the syntax of TABLE(), see 表字面量.

表函数与一般函数一样，可以在每次调用中接受零个、一个或多个输入实参。每个实参必须是标量表达式。

For more details about the syntax of table function calls, see 语法 (in this topic).

使用表作为表函数的输入¶

表函数的实参可以是字面量或表达式，例如表的列。例如，下面的 SELECT 语句将表中的值作为实参传递给表函数：

CREATE OR REPLACE table dates_of_interest (event_date DATE);
INSERT INTO dates_of_interest (event_date) VALUES
    ('2021-06-21'::DATE),
    ('2022-06-21'::DATE);

CREATE OR REPLACE FUNCTION record_high_temperatures_for_date(d DATE)
    RETURNS TABLE (event_date DATE, city VARCHAR, temperature NUMBER)
    as
    $$
    SELECT d, 'New York', 65.0
    UNION ALL
    SELECT d, 'Los Angeles', 69.0
    $$;

SELECT
        doi.event_date as "Date", 
        record_temperatures.city,
        record_temperatures.temperature
    FROM dates_of_interest AS doi,
         TABLE(record_high_temperatures_for_date(doi.event_date)) AS record_temperatures
      ORDER BY doi.event_date, city;
+------------+-------------+-------------+
| Date       | CITY        | TEMPERATURE |
|------------+-------------+-------------|
| 2021-06-21 | Los Angeles |          69 |
| 2021-06-21 | New York    |          65 |
| 2022-06-21 | Los Angeles |          69 |
| 2022-06-21 | New York    |          65 |
+------------+-------------+-------------+

表函数的实参可以来自其他类似表的源，包括视图和其他表函数。