AVG

从窗口式查询返回一组值的平均值。窗口查询是根据时间或行数定义的。有关窗口式查询的信息，请参阅窗口式查询。要返回在指定时间窗口内选择的值表达式的流的指数加权平均值，请参阅 EXP_AVG。

在使用 AVG 时，请注意以下事项：

如果你不使用OVER子句，AVG以聚合函数的形式计算。在这种情况下，聚合查询必须包含GROUP BY 子句在基于以下条件的单调表达式上ROWTIME它将流分组为有限的行。否则，该组是无限流，查询将永远不会完成，也不会发出任何行。有关更多信息，请参阅聚合函数。
使用 GROUP BY 子句的窗口式查询处理滚动窗口中的行。有关更多信息，请参阅滚动窗口（使用 GROUP BY 的聚合）。
如果您将OVER子句，AVG以分析函数的形式计算。有关更多信息，请参阅分析函数。
使用 OVER 子句的窗口式查询处理滑动窗口中的行。有关更多信息，请参阅滑动窗口

语法

滚动窗口式查询



AVG(number-expression) ... GROUP BY monotonic-expression | time-based-expression

滑动窗口式查询



AVG([DISTINCT | ALL] number-expression) OVER window-specification

参数

DISTINCT

仅对值的每个唯一实例执行聚合函数。

ALL

对所有值执行聚合函数。ALL 为默认值。

number-expression

指定针对聚合中的每一行计算的值表达式。

OVER window-specification

将流中的记录除以时间范围间隔或行数分区。窗口规范定义流中记录的划分方式 (按时间范围间隔或行数)。

GROUP B单调表达式|time-based-expression

基于分组表达式的值为记录分组，从而针对在所有列中具有相同值的每组行返回一个摘要行。

示例

示例数据集

以下示例基于样本股票数据集，该数据集是入门练习在里面Amazon Kinesis Analytics. 要运行每个示例，您需要一个具有示例股票行情输入流的 Amazon Kinesis Analytics 应用程序。要了解如何创建Analytics（Analytics），请参阅开始使用在里面Amazon Kinesis Analytics.

具有以下架构的示例股票数据集。



(ticker_symbol  VARCHAR(4),
sector          VARCHAR(16),
change          REAL,
price           REAL)

示例 1：使用 GROUP BY 子句返回值的平均值

在此示例中，聚合查询有一个GROUP BY子句 on onROWTIME它将流分组为有限的行。随后，从 AVG 子句返回的行计算 GROUP BY 函数。

使用 STEP（推荐）



CREATE OR REPLACE STREAM "DESTINATION_SQL_STREAM" (
    ticker_symbol VARCHAR(4), 
    avg_price     DOUBLE);  
    
CREATE OR REPLACE PUMP "STREAM_PUMP" AS 
  INSERT INTO "DESTINATION_SQL_STREAM" 
    SELECT STREAM 
        ticker_symbol,
        AVG(price) AS avg_price
    FROM "SOURCE_SQL_STREAM_001"
    GROUP BY ticker_symbol, 
        STEP("SOURCE_SQL_STREAM_001".ROWTIME BY INTERVAL '60' SECOND);

使用 FLOOR



CREATE OR REPLACE STREAM "DESTINATION_SQL_STREAM" (
    ticker_symbol VARCHAR(4), 
    avg_price     DOUBLE);  

CREATE OR REPLACE PUMP "STREAM_PUMP" AS 
  INSERT INTO "DESTINATION_SQL_STREAM" 
    SELECT STREAM 
        ticker_symbol,
        AVG(price) AS avg_price
    FROM "SOURCE_SQL_STREAM_001"
    GROUP BY ticker_symbol, 
        FLOOR("SOURCE_SQL_STREAM_001".ROWTIME TO MINUTE);

结果

上一示例输出的流与以下内容类似。

示例 2：使用 OVER 子句返回值的平均值

在此示例中，OVER子句将流中的记录除以前 '1' 小时的时间范围间隔。随后，从 AVG 子句返回的行计算 OVER 函数。



CREATE OR REPLACE STREAM "DESTINATION_SQL_STREAM" (
    ticker_symbol VARCHAR(4),
    avg_price     DOUBLE);
CREATE OR REPLACE PUMP "STREAM_PUMP" AS 
    INSERT INTO "DESTINATION_SQL_STREAM"
    SELECT STREAM ticker_symbol, 
        AVG(price) OVER (
            PARTITION BY ticker_symbol
            RANGE INTERVAL '1' HOUR PRECEDING) AS avg_price
    FROM "SOURCE_SQL_STREAM_001"

上一示例输出的流与以下内容类似。

使用说明

Amazon Kinesis AnalyticsAVG应用于间隔类型。此功能偏离了 SQL:2008 标准。

当用作分析函数时，AVG如果正在评估的窗口不包含任何行，或者如果所有行都包含空值，则返回 null。有关更多信息，请参阅分析函数。对于 a，AVG 也会返回空值PARTITION BY子句，窗口内与输入行匹配的分区不包含任何行或所有行均为空。有关 PARTITION BY 的更多信息，请参阅 WINDOW 子句 (滑动窗口)。

AVG忽略一组值或数值表达式中的空值。例如，以下各项返回值 2：

AVG(1, 2, 3) = 2
AVG(1,null, 2, null, 3, null) = 2

AVG

语法