翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 自動説明文計算の使用
<a name="auto-narrative-computations"></a>

このセクションで、自動説明文をカスタマイズしているときに使用できる機能を理解してください。デフォルトの計算を変更または構築する場合は、説明文をカスタマイズするだけで済みます。

自動説明文を作成すると、式エディタが開きます。ビジュアルメニューを選択してから [**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 を使用した外れ値の異常検出
<a name="anomaly-detection-function"></a>

ML を使用した異常検出計算では、データから外れ値を検索します。たとえば、2019 年 1 月 3 日の総売上高で上位 3 つの外れ値を検出できます。寄与分析を有効にすると、各外れ値の主要因を検出することもできます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンション、[**Value (値)**] フィールドウェルに 1 つ以上のメジャー、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。設定画面には、フィールドウェル内に存在しない他のフィールドの寄与についても主要因として分析するオプションがあります。

詳細については、[ML を使用した異常検出による外れ値の検出](anomaly-detection.md)を参照してください。

**注記**  
ML を使用した異常検出を別の計算に追加することはできません。また、別の計算を異常検出に追加することはできません。

## 計算の出力
<a name="anomaly-detection-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトの作成時に指定した名前に基づきます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。続いて説明文に **`bold monospace font`** で表示される項目を使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `categoryFields` – [**Categories (カテゴリ)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
+ `metricField` [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `itemsCount` – この計算に含まれている項目の数。
+ `items` – 異常な項目。
  + `timeValue` – 日付ディメンションの値。
    + `value` – 異常 (外れ値) 発生時の日付/時刻フィールド。
    + `formattedValue` – 異常発生時の日付/時刻フィールドのフォーマットされた値。
  + `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` – メトリクスフィールドによってフォーマットされた絶対値。

# 下位製品計算
<a name="bottom-movers-function"></a>

下位製品の計算では、自動説明文のデータセットの一番下にランク付けされている日付別の要求されたカテゴリ数をカウントします。たとえば、売上高の下位 3 製品を見つける計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="bottom-movers-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*カテゴリ*   
ランク付けするカテゴリのディメンション。

*値*   
計算の基になっている集計指標。

*ムーバーの数*   
表示するランク付けされた結果の数。

*順*   
使用する順序は、パーセント差または絶対差です。

## 計算の出力
<a name="bottom-movers-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、上位製品の計算によって返されたのと同じ出力パラメータです。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `categoryField` – [**Categories (カテゴリ)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
+ `metricField` [**Values (値)**] フィールドウェルから。
  + `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` – メトリクスフィールドによってフォーマットされた差の絶対値。

# 下位計算
<a name="bottom-ranked-function"></a>

下位の計算では、自動説明文のデータセットの一番下にランク付けされている値別の要求されたカテゴリ数を計算します。たとえば、売上高で下位 3 州を見つける計算を作成できます。

この関数を使用するには、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="bottom-ranked-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*カテゴリ*   
ランク付けするカテゴリのディメンション。

*値*   
計算の基になっている集計指標。

*結果の数*   
表示するランク付けされた結果の数。

## 計算の出力
<a name="bottom-ranked-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、上位の計算によって返されたの同じ出力パラメータです。
+ `categoryField` – [**Categories (カテゴリ)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
+ `metricField` [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `itemsCount` – この計算に含まれている項目の数。
+ `items`: 下位の項目。
  + `categoryField` – カテゴリフィールド。
    + `value` – カテゴリフィールドの値 (コンテンツ)。
    + `formattedValue` – カテゴリフィールドのフォーマットされた値 (コンテンツ)。このフィールドが null の場合は、"`NULL`" が表示されます。フィールドが空の場合は、"`(empty)`" が表示されます。
  + `metricValue` – メトリクスフィールド。
    + `value` – 未加工値。
    + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
    + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。

## 例
<a name="bottom-ranked-function-example"></a>

次のスクリーンショットは、最下位ランクの計算のデフォルト設定を示しています。

![\[最下位ランクの計算のデフォルト設定。\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/bottom-ranked-computation.png)


# ML による予測
<a name="forecast-function"></a>

ML を使用した予測計算では、季節性による過去のメトリクスのパターンに基づいて将来のメトリクスを予測します。たとえば、次の 6 か月間の総収入を予測する計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

予測の使用の詳細については、[Amazon Quick Sight を使用した What-If シナリオの予測と作成](forecasts-and-whatifs.md)を参照してください。

## パラメータ
<a name="forecast-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

*期間を進める*   
予測する将来の期間数。1 から 1,000 の範囲です。

*期間を戻す*   
予測の基準にする過去の期間数。0 から 1,000 の範囲です。

*季節性*   
暦年に含まれる季節の数。デフォルトの設定、[**automatic (自動)**] で検出します。1 から 180 の範囲です。

## 計算の出力
<a name="forecast-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `metricValue` – メトリクスディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `timeValue` – 日付ディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – 日付フィールドでフォーマットされた値。
+ `relativePeriodsToForecast` – 最新の日時レコードと最後の予測レコード間の期間の相対数。

# 成長率計算
<a name="growth-rate-function"></a>

成長率の計算では、期間にわたる値を比較します。たとえば、売上に対する 3 か月の複合成長率をパーセントで表す計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="growth-rate-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

*期間の数*   
成長率を計算するために使用する将来の期間数。

## 計算の出力
<a name="growth-rate-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `previousMetricValue` – メトリクスディメンションの以前の値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `previousTimeValue` – 日時ディメンションの以前の値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。
+ `compoundedGrowthRate` – メトリクスフィールドの現在の値と以前の値のパーセント差。
  + `value` – パーセント差の計算の未加工値。
  + `formattedValue` – パーセント差のフォーマットされた値 (例: -42%)。
  + `formattedAbsoluteValue` – パーセント差のフォーマットされた絶対値 (例: 42%)。
+ `absoluteDifference` – メトリクスフィールドの現在の値と以前の値の絶対差。
  + `value` – 絶対差の計算の 未加工値。
  + `formattedValue` – メトリクスフィールドのフォーマット設定によってフォーマットされた絶対差。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた差の絶対値。

# 最大計算
<a name="maximum-function"></a>

最大計算は、値によって最大のディメンションを見つけます。たとえば、最も収入の多い月を見つけるための計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="maximum-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

## 計算の出力
<a name="maximum-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、最小計算によって返されたの同じ出力パラメータです。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `metricValue` – メトリクスディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `timeValue` – 日付ディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。

# メトリクス比較計算
<a name="metric-comparison-function"></a>

メトリクス比較計算では、さまざまな尺度の値を比較します。たとえば、実際の売上と売上目標の比較など、2 つの値を比較する計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンション、[**Value (値)**] フィールドウェルに 2 つ以上のメジャーが必要です。

## パラメータ
<a name="metric-comparison-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

*[Target value]* (ターゲット値)   
値と比較するフィールド。

## 計算の出力
<a name="metric-comparison-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `fromMetricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `fromMetricValue` – メトリクスディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `toMetricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `toMetricValue` – メトリクスディメンションの現在の値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `timeValue` – 日付ディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。
+ `percentDifference` – メトリクスフィールドの現在の値と以前の値のパーセント差。
  + `value` – パーセント差の計算の未加工値。
  + `formattedValue` – パーセント差のフォーマットされた値 (例: -42%)。
  + `formattedAbsoluteValue` – パーセント差のフォーマットされた絶対値 (例: 42%)。
+ `absoluteDifference` – メトリクスフィールドの現在の値と以前の値の絶対差。
  + `value` – 絶対差の計算の 未加工値。
  + `formattedValue` – メトリクスフィールドのフォーマット設定によってフォーマットされた絶対差。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた差の絶対値。

# 最小計算
<a name="minimum-function"></a>

最小計算は、値によって最小のディメンションを見つけます。たとえば、最も収入の少ない月を見つけるための計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="minimum-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

## 計算の出力
<a name="maximum-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、最大計算によって返されたの同じ出力パラメータです。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `metricValue` – メトリクスディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。
+ `timeValue` – 日付ディメンションの値。
  + `value` – 未加工値。
  + `formattedValue` – 日時フィールドでフォーマットされた値。

# 期間対期間計算
<a name="period-over-period-function"></a>

期間対期間計算では、2 つの異なる期間からの値を比較します。たとえば、前の期間から売上がどれだけ増減したかを調べる計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="period-over-period-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

## 計算の出力
<a name="period-over-period-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `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` – メトリクスフィールドによってフォーマットされた差の絶対値。

## 例
<a name="period-over-period-computation-example"></a>

**期間対期間計算を作成するには**

1. 変更する分析で、[**インサイトの追加**] を選択します。

1. [**計算タイプ**] で、[**期間対期間**]、[**選択**] の順に選択します。

1. 作成した新しいインサイトで、比較する時間ディメンションと値ディメンションフィールドを追加します。下のスクリーンショットでは、`Order Date` と `Sales (Sum)`がインサイトに追加されています。これら 2 つのフィールドを選択すると、Quick Sight は過去 1 か月の年初来の売上と、前月との差の割合を表示します。  
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/periodOverPeriod1.png)

1. (オプション) インサイトをさらにカスタマイズするには、オンビジュアルメニューを開いて [**説明文のカスタマイズ**] を選択します。表示される [**説明文の編集**] ウィンドウで、必要なフィールドを [**計算**] リストからドラッグアンドドロップし、[**保存**] を選択します。

# 期間累計計算
<a name="period-to-date-function"></a>

期間累計計算では、指定された期間の現在までの値が評価されます。たとえば、計算を作成して、年初来の売上を確認することができます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="period-to-date-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*日付*   
ランク付けする日付ディメンション。

*値*   
計算の基になっている集計指標。

*時間詳細度*   
計算に使用する日付の細かさ。たとえば、年初来。

## 計算の出力
<a name="period-to-date-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `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` – メトリクスフィールドによってフォーマットされた差の絶対値。

## 例
<a name="period-to-date-computation-example"></a>

**現在までの期間の計算を作成するには**

1. 変更する分析で、[**インサイトの追加**] を選択します。

1. [**計算タイプ**] で、[**現在までの期間の計算**]、[**選択**] の順に選択します。

1. 作成した新しいインサイトに、比較する時間ディメンションフィールドと値ディメンションフィールドを追加します。下のスクリーンショットでは、`Order Date` と `Sales (Sum)`がインサイトに追加されています。これら 2 つのフィールドを選択すると、Quick Sight は過去 1 か月の年初来の売上と、前月との差の割合を表示します。  
![\[alt text not found\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/images/periodOverPeriod1.png)

1. (オプション) インサイトをさらにカスタマイズするには、オンビジュアルメニューを開いて [**説明文のカスタマイズ**] を選択します。表示される [**説明文の編集**] ウィンドウで、必要なフィールドを [**計算**] リストからドラッグアンドドロップし、[**保存**] を選択します。

# 上位製品計算
<a name="top-movers-function"></a>

上位製品の計算では、自動説明文のデータセットの一番上にランク付けされている日付別の要求されたカテゴリ数をカウントします。たとえば、期間中の売上高で最上位製品を見つける計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="top-movers-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*カテゴリ*   
ランク付けするカテゴリのディメンション。

*値*   
計算の基になっている集計指標。

*結果の数*   
見つけたいと思うランキングの項目の数。

## 計算の出力
<a name="top-movers-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、下位製品の計算によって返されたの同じ出力パラメータです。
+ `timeField` – [**Time (時間)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `timeGranularity` – 時間フィールドの詳細度 (**DAY**、**YEAR** など)。
+ `categoryField` – [**Categories (カテゴリ)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
+ `metricField` [**Values (値)**] フィールドウェルから。
  + `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` – メトリクスフィールドによってフォーマットされた差の絶対値。

# 上位計算
<a name="top-ranked-function"></a>

上位の計算は、値によって上位のディメンションを見つけます。たとえば、売上高で上位 3 州を見つける計算を作成できます。

この関数を使用するには、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="top-ranked-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*カテゴリ*   
ランク付けするカテゴリのディメンション。

*値*   
計算の基になっている集計指標。

*結果の数*   
見つけたいと思うランキングの項目の数。

## 計算の出力
<a name="top-ranked-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。

**注記**  
これらは、下位の計算によって返されたの同じ出力パラメータです。
+ `categoryField` – [**Categories (カテゴリ)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
+ `metricField` [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `itemsCount` – この計算に含まれている項目の数。
+ `items`: 上位の項目。
  + `categoryField` – カテゴリフィールド。
    + `value` – カテゴリフィールドの値 (コンテンツ)。
    + `formattedValue` – カテゴリフィールドのフォーマットされた値 (コンテンツ)。このフィールドが null の場合は、"`NULL`" が表示されます。フィールドが空の場合は、"`(empty)`" が表示されます。
  + `metricValue` – メトリクスフィールド。
    + `value` – 未加工値。
    + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
    + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。

# 総集計計算
<a name="total-aggregation-function"></a>

総集計計算は、値の総計を作成します。たとえば、総収入を計算する計算を作成できます。

この関数を使用するには、[**Time (時間)**] フィールドウェルに 1 つ以上のディメンション、[**Value (値)**] フィールドウェルに 1 つ以上のメジャーが必要です。

## パラメータ
<a name="total-aggregation-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*値*   
計算の基になっている集計指標。

## 計算の出力
<a name="total-aggregation-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `categoryField` – カテゴリフィールド。
  + `name` カテゴリフィールドの表示名。
+ `metricField` – [**Values (値)**] フィールドウェルから。
  + `name` – フィールドのフォーマットされた表示名。
  + `aggregationFunction` – メトリクスに使用された集計 (**SUM**、**AVG** など)。
+ `totalAggregate` – メトリクス集計の合計値。
  + `value` – 未加工値。
  + `formattedValue` – メトリクスフィールドによってフォーマットされた値。
  + `formattedAbsoluteValue` – メトリクスフィールドによってフォーマットされた絶対値。

# 一意の値計算
<a name="unique-values-function"></a>

一意の値の計算は、カテゴリーフィールド内の一意の値をカウントします。たとえば、ある顧客の数など、ディメンション内の一意の値の数を数える計算を作成できます。

この関数を使用するには、[**Categories (カテゴリ)**] フィールドウェルに 1 つ以上のディメンションが必要です。

## パラメータ
<a name="unique-values-function-parameters"></a>

*[名前]*   
割り当てたり変更したりする固有のわかりやすい名前。独自の名前を作成しない場合、名前が割り当てられます。これは後で編集できます。

*カテゴリ*   
ランク付けするカテゴリのディメンション。

## 計算の出力
<a name="unique-values-computation-outputs"></a>

各関数が出力パラメータのセットを生成します。これらの出力を自動説明文に追加して、表示内容をカスタマイズできます。独自のカスタムテキストを追加することもできます。

出力パラメータを見つけるには、右側の [**Computations (計算)**] タブを開き、使用する計算を探します。計算名は、インサイトを作成するときに指定した名前に基づいて決定されます。1 回のみ出力パラメータをクリックして選択します。2 回クリックすると、同じ出力が 2 回追加されます。**太字**で表示された項目は、説明で使用できます。
+ `categoryField` – カテゴリフィールド。
  + `name` カテゴリフィールドの表示名。
+ `uniqueGroupValuesCount` – このコンピューティングに含まれる一意の値の数。