本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用自动叙述计算
计算

可以使用该部分帮助您了解在自定义自动叙述时可供使用的函数。仅当您希望更改或在默认计算上构建时才需要自定义叙述。

在创建自动叙述后，将打开表达式编辑器。您还可以通过依次选择视觉对象菜单和 **Customize Narrative (自定义叙述)** 来激活表达式编辑器。要在使用表达式编辑器时添加计算，请选择 **\$1 Add computation (\$1 添加计算)**。

您可以使用以下代码表达式构建自动叙述。可以从标记为 **Insert code (插入代码)** 的列表中获取这些表达式。代码语句可以内联方式（在句子中）或作为块（在列表中）显示。
+ 表达式 – 创建您自己的代码表达式。
+ IF – 在评估条件之后包括表达式的 IF 语句。
+ FOR – 循环访问值的 FOR 语句。

您可以使用以下计算构建自动叙述。您可以使用表达式编辑器而不编辑任何语法，但如果您愿意，也可以自定义它。要与语法交互，请打开自动叙述表达式编辑器中的计算小部件。

**Topics**
+ [

# 针对异常值的 ML 支持的异常检测
](anomaly-detection-function.md)
+ [

# 最小变化者计算
](bottom-movers-function.md)
+ [

# 排名最低计算
](bottom-ranked-function.md)
+ [

# ML 支持的预测
](forecast-function.md)
+ [

# 增长率计算
](growth-rate-function.md)
+ [

# 最大值计算
](maximum-function.md)
+ [

# 指标比较计算
](metric-comparison-function.md)
+ [

# 最小值计算
](minimum-function.md)
+ [

# 同期增长率计算
](period-over-period-function.md)
+ [

# 期初至今计算
](period-to-date-function.md)
+ [

# 最大变化者计算
](top-movers-function.md)
+ [

# 排名最高计算
](top-ranked-function.md)
+ [

# 聚合总量计算
](total-aggregation-function.md)
+ [

# 唯一值计算
](unique-values-function.md)

# 针对异常值的 ML 支持的异常检测
针对异常值的异常检测

ML 支持的异常检测计算搜索您的数据以查找异常值。例如，您可以检测 2019 年 1 月 3 日总销售额的前三个异常值。如果启用贡献分析，您还可以检测每个异常值的关键驱动因素。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度，在 **Values (值)** 字段井中具有至少一个度量，并在 **Categories (类别)** 字段井中具有至少一个维度。配置屏幕提供了一个选项，用于分析其他字段作为关键驱动因素的贡献，即使这些字段不在字段井中。

有关更多信息，请参阅 [通过 ML 支持的异常检测功能检测异常值](anomaly-detection.md)。

**注意**  
不能将 ML 支持的异常检测添加到其他计算中，也不能将其他计算添加到异常检测中。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。您可以使用显示在叙述后面的 **`bold monospace font`** 中的项目。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `categoryFields` – 来自**类别**字段井。
  + `name` – 字段的格式化的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `itemsCount` – 此计算中包含的项目数。
+ `items` – 异常项目。
  + `timeValue` – 日期维度中的值。
    + `value` – 异常（异常值）发生点的日期/时间字段。
    + `formattedValue`— 异常时 date/time 字段中的格式化值。
  + `categoryName` – 类别的实际名称（cat1、cat2 等等）。
  + `direction` – x 轴或 y 轴上标识为异常的方向：`HIGH` 或 `LOW`。`HIGH` 表示“高于预期”。`LOW`表示“低于预期”。

    迭代项目时，`AnomalyDetection.items[index].direction` 可以包含 `HIGH` 或 `LOW`。例如，`AnomalyDetection.items[index].direction='HIGH'` 或 `AnomalyDetection.items[index].direction=LOW`。`AnomalyDetection.direction` 可以有一个 `ALL` 的空字符串。例如，`AnomalyDetection.direction=''`。
  + `actualValue` – 异常或异常值发生点处指标的实际值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
  + `expectedValue` – 异常（异常值）发生点处指标的预期值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。

# 最小变化者计算


最小变化者计算按日期计算自动叙述的数据集中排名最低的请求类别数。例如，您可以创建一个计算，查找销售收入最低的三种所售产品。

要使用该函数，要求在 **Time (时间)** 字段井中具有至少一个维度并在 **Categories (类别)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*类别*   
您要排名的类别维度。

*值*   
计算所基于的聚合度量。

*Number of movers (变化者数)*   
要显示的排名结果数。

*Order by (排序依据)*   
要使用的顺序：百分比差值或绝对差值。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与最大变化者计算返回的输出参数相同。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `categoryField` – 来自**类别**字段井。
  + `name` – 字段的格式化的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `startTimeValue` – 日期维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `endTimeValue` – 日期维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的绝对值。
+ `itemsCount` – 此计算中包含的项目数。
+ `items`：最小变化的项目。
  + `categoryField` – 类别字段。
    + `value` – 类别字段的值（内容）。
    + `formattedValue` – 类别字段的格式化值（内容）。如果字段为 null，这显示“`NULL`”。如果字段为空，这显示“`(empty)`”。
  + `currentMetricValue` – 指标字段的当前值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
  + `previousMetricValue` – 指标字段的先前值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
  + `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
    + `value` – 百分比差异计算的原始值。
    + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
    + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
  + `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
    + `value` – 绝对差异计算的原始值。
    + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
    + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

# 排名最低计算


排名最低计算按值计算自动叙述的数据集中排名最低的请求类别数。例如，您可以创建一个计算，查找销售收入最低的三个州。

要使用该函数，您需要在 **Categories (类别)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*类别*   
您要排名的类别维度。

*值*   
计算所基于的聚合度量。

*Number of results*   
要显示的排名结果数。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与排名最高计算返回的输出参数相同。
+ `categoryField` – 来自**类别**字段井。
  + `name` – 字段的格式化的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `itemsCount` – 此计算中包含的项目数。
+ `items`：排名最低的项目。
  + `categoryField` – 类别字段。
    + `value` – 类别字段的值（内容）。
    + `formattedValue` – 类别字段的格式化值（内容）。如果字段为 null，这显示“`NULL`”。如果字段为空，这显示“`(empty)`”。
  + `metricValue` – 指标字段。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。

## 示例


下面的屏幕截图显示了排名最低的计算的默认配置。

![\[排名最低的计算的默认配置。\]](http://docs.amazonaws.cn/quick/latest/userguide/images/bottom-ranked-computation.png)


# ML 支持的预测
预测

ML 支持的预测计算根据以前按季节的指标模式预测未来指标。例如，您可以创建一个计算来预测未来六个月的总收入。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

有关使用预测的详细信息，请参阅[使用 Amazon Quick Sight 预测和创建假设情景](forecasts-and-whatifs.md)。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

*Periods forward (未来的期间)*   
要预测的未来时间段数。范围从 1 到 1,000。

*Periods backward (过去的期间)*   
要作为预测基础的过去时间段数。范围从 0 到 1,000。

*Seasonality (季节性)*   
日历年中包含的季节数。默认设置 **automatic (自动)** 会为您检测此数值。范围从 1 到 180。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `metricValue` – 指标维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `timeValue` – 日期维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期字段格式化的值。
+ `relativePeriodsToForecast` – 最新日期时间记录与上一个预测记录之间的相对期间数量。

# 增长率计算


增长率计算比较一段时间内的值。例如，您可以创建一个计算以查找三个月的销售复合增长率（以百分比表示）。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

*Number of periods*   
要用于计算增长率的未来时间段数。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `previousMetricValue` – 指标维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `previousTimeValue` – 日期时间维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `compoundedGrowthRate` – 指标字段的当前值与先前值之间的百分比差异。
  + `value` – 百分比差异计算的原始值。
  + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
  + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
+ `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
  + `value` – 绝对差异计算的原始值。
  + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
  + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

# 最大值计算


最大值计算按值查找最大维度。例如，您可以创建一个计算来查找收入最高的月份。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与最小值计算返回的输出参数相同。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `metricValue` – 指标维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `timeValue` – 日期时间维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。

# 指标比较计算


指标比较计算比较不同度量中的值。例如，您可以创建一个计算来比较两个值，例如实际销售额与目标销售额。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度，并在 **Values (值)** 字段井中具有至少两个度量。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

*目标值*   
要与该值进行比较的字段。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `fromMetricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `fromMetricValue` – 指标维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `toMetricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `toMetricValue` – 指标维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `timeValue` – 日期时间维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
  + `value` – 百分比差异计算的原始值。
  + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
  + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
+ `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
  + `value` – 绝对差异计算的原始值。
  + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
  + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

# 最小值计算


最小值计算按值查找最小维度。例如，您可以创建一个计算来查找收入最低的月份。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与最大值计算返回的输出参数相同。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `metricValue` – 指标维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `timeValue` – 日期时间维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。

# 同期增长率计算


同期增长率计算比较两个不同时间段的值。例如，您可以创建一个计算，以了解销售额自上个时间段以来的增长或减少程度。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `previousMetricValue` – 指标维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `previousTimeValue` – 日期时间维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `currentMetricValue` – 指标维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `currentTimeValue` – 日期时间维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
  + `value` – 百分比差异计算的原始值。
  + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
  + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
+ `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
  + `value` – 绝对差异计算的原始值。
  + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
  + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

## 示例


**创建同期增长率计算**

1. 在要更改的分析中，选择**添加洞察**。

1. 对于**计算类型**，选择**同期增长率**，然后选择**选择**。

1. 在您创建的新见解中，添加要比较的时间维度和值维度字段。在下面的屏幕截图中，`Order Date` 和 `Sales (Sum)` 已添加到洞察中。选中这两个字段后，Quick Sight会显示最近一个月的年初至今销售额以及与上个月相比的百分比差异。  
![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/periodOverPeriod1.png)

1. （可选）要进一步自定义洞察，请打开视觉对象菜单并选择**自定义叙述**。在出现的**编辑叙述**窗口中，从**计算**列表中拖放所需的字段，然后选择**保存**。

# 期初至今计算


期初至今计算评估指定的期初至今的值。例如，您可以创建一个计算来找出您的 year-to-date销售收入。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*日期*   
您要排名的日期维度。

*值*   
计算所基于的聚合度量。

*Time granularity (时间粒度)*   
要用于计算的日期粒度，例如“本年迄今”。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `previousMetricValue` – 指标维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `previousTimeValue` – 日期时间维度中的先前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `currentMetricValue` – 指标维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
+ `currentTimeValue` – 日期时间维度中的当前值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `periodGranularity` – 此计算的期间粒度（**MONTH**、**YEAR** 等等）。
+ `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
  + `value` – 百分比差异计算的原始值。
  + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
  + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
+ `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
  + `value` – 绝对差异计算的原始值。
  + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
  + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

## 示例


**创建期初至今计算**

1. 在要更改的分析中，选择**添加洞察**。

1. 对于**计算类型**，选择**起初至今**，然后选择**选择**。

1. 在您创建的新洞察中，添加要比较的时间维度和值维度字段。在下面的屏幕截图中，`Order Date` 和 `Sales (Sum)` 已添加到洞察中。选中这两个字段后，Quick Sight会显示最近一个月的年初至今销售额以及与上个月相比的百分比差异。  
![\[alt text not found\]](http://docs.amazonaws.cn/quick/latest/userguide/images/periodOverPeriod1.png)

1. （可选）要进一步自定义洞察，请打开视觉对象菜单并选择**自定义叙述**。在出现的**编辑叙述**窗口中，从**计算**列表中拖放所需的字段，然后选择**保存**。

# 最大变化者计算


最大变化者计算按日期计算自动叙述的数据集中排名最高的请求类别数。例如，您可以创建一个计算，以按一个时间段内的销售收入查找最热卖产品。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度，并在 **Categories (类别)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*类别*   
您要排名的类别维度。

*值*   
计算所基于的聚合度量。

*Number of results*   
要查找的排名最高的项目数。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与最小变化者计算返回的输出参数相同。
+ `timeField` – 来自**时间**字段井。
  + `name` – 字段的格式化的显示名称。
  + `timeGranularity` – 时间字段粒度（**DAY**、**YEAR** 等等）。
+ `categoryField` – 来自**类别**字段井。
  + `name` – 字段的格式化的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `startTimeValue` – 日期维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的值。
+ `endTimeValue` – 日期维度中的值。
  + `value` – 原始值。
  + `formattedValue` – 日期时间字段格式化的绝对值。
+ `itemsCount` – 此计算中包含的项目数。
+ `items`: 最大变化的项目。
  + `categoryField` – 类别字段。
    + `value` – 类别字段的值（内容）。
    + `formattedValue` – 类别字段的格式化值（内容）。如果字段为 null，这显示“`NULL`”。如果字段为空，这显示“`(empty)`”。
  + `currentMetricValue` – 指标字段的当前值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
  + `previousMetricValue` – 指标字段的先前值。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。
  + `percentDifference` – 指标字段的当前值与先前值之间的百分比差异。
    + `value` – 百分比差异计算的原始值。
    + `formattedValue` – 百分比差异的格式化值（例如，-42%）。
    + `formattedAbsoluteValue` – 百分比差异的格式化绝对值（例如，42%）。
  + `absoluteDifference` – 指标字段的当前值与先前值之间的绝对差异。
    + `value` – 绝对差异计算的原始值。
    + `formattedValue` – 由指标字段的格式首选项中的设置格式化的绝对差异。
    + `formattedAbsoluteValue` – 指标字段格式化的差异的绝对值。

# 排名最高计算


排名最高计算按值查找排名最高的维度。例如，您可以创建一个计算，查找销售收入最高的三个州。

要使用该函数，您需要在 **Categories (类别)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*类别*   
您要排名的类别维度。

*值*   
计算所基于的聚合度量。

*Number of results*   
要查找的排名最高的项目数。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。

**注意**  
这些输出参数与排名最低计算返回的输出参数相同。
+ `categoryField` – 来自**类别**字段井。
  + `name` – 字段的格式化的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `itemsCount` – 此计算中包含的项目数。
+ `items`：排名最高的项目。
  + `categoryField` – 类别字段。
    + `value` – 类别字段的值（内容）。
    + `formattedValue` – 类别字段的格式化值（内容）。如果字段为 null，这显示“`NULL`”。如果字段为空，这显示“`(empty)`”。
  + `metricValue` – 指标字段。
    + `value` – 原始值。
    + `formattedValue` – 指标字段格式化的值。
    + `formattedAbsoluteValue` – 指标字段格式化的绝对值。

# 聚合总量计算


聚合总量计算创建值的总计。例如，您可以创建一个计算来查找总收入。

要使用该函数，您需要在 **Time (时间)** 字段井中具有至少一个维度，并在 **Values (值)** 字段井中具有至少一个度量。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*值*   
计算所基于的聚合度量。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `categoryField` – 类别字段。
  + `name` – 类别字段的显示名称。
+ `metricField` – 来自**值**字段井。
  + `name` – 字段的格式化的显示名称。
  + `aggregationFunction` – 用于指标的聚合（**SUM**、**AVG** 等等）。
+ `totalAggregate` – 指标聚合的总值。
  + `value` – 原始值。
  + `formattedValue` – 指标字段格式化的值。
  + `formattedAbsoluteValue` – 指标字段格式化的绝对值。

# 唯一值计算


唯一值计算用于统计类别字段中的唯一值。例如，您可以创建一个计算来计算维度中唯一值数量，例如您拥有的客户数

要使用该函数，您需要在 **Categories (类别)** 字段井中具有至少一个维度。

## 参数


*name*   
您分配或更改的唯一描述性名称。如果您未创建自己的名称，则会分配一个名称。您可以稍后编辑它。

*类别*   
您要排名的类别维度。

## 计算输出


每个函数都会生成一组输出参数。您可以将这些输出添加到自动叙述以自定义它显示的内容。您也可以添加自己的自定义文本。

要找到输出参数，请打开右侧的 **Computations (计算)** 选项卡并找到您要使用的计算。计算的名称来自您创建见解时提供的名称。请通过只单击一次来选择输出参数。如果您单击两次，您将两次添加相同的输出。以**粗体**显示的项目可用于叙述中。
+ `categoryField` – 类别字段。
  + `name` – 类别字段的显示名称。
+ `uniqueGroupValuesCount` – 此计算中包含的唯一值的数量。