本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# REPLACE\_OUTLIERS
<a name="recipe-actions.REPLACE_OUTLIERS"></a>

根據參數中的設定，更新分類為極端值的資料點值。

**Parameters**
+ `sourceColumn` – 指定可能包含極端值的現有數值資料欄的名稱。
+ `outlierStrategy` – 指定用於偵測極端值的方法。有效值包括下列項目：
  + `Z_SCORE` – 當值偏離平均值超過標準差閾值時，將值識別為極端值。
  + `MODIFIED_Z_SCORE` – 當值偏離中位數超過中位數絕對偏差閾值時，將值識別為極端值。
  + `IQR` – 當值超過欄資料的第一分位數和最後一分位數時，將值識別為極端值。四分位數範圍 (IQR) 測量資料點中間 50% 的位置。
+ `threshold` – 指定偵測極端值時要使用的閾值。如果以 計算的分數`outlierStrategy`超過此數字，則`sourceColumn`值會識別為極端值。預設為 3。
+ `replaceType` – 指定取代極端值時要使用的方法。有效值包括下列項目：
  + `WINSORIZE_VALUES` – 指定使用最小和最大百分位數來限制值。
  + `REPLACE_WITH_CUSTOM` 
  + `REPLACE_WITH_EMPTY` 
  + `REPLACE_WITH_NULL`
  + `REPLACE_WITH_MODE`
  + `REPLACE_WITH_AVERAGE`
  + `REPLACE_WITH_MEDIAN`
  + `REPLACE_WITH_SUM`
  + `REPLACE_WITH_MAX`
+ `modeType` – 指出當 `replaceType`為 時要使用的模態函數類型`REPLACE_WITH_MODE`。有效值包括下列項目：`MIN`、 `MAX`和 `AVERAGE`。
+ `minValue` – 指出`trimValue`使用 時要套用的極端值範圍的最小百分位數值。有效範圍為 0–100。
+ `maxValue` – 指出`trimValue`使用 時要套用的極端值範圍的最大百分位數值。有效範圍為 0–100。
+ `value` – 指定使用 時要插入的值`REPLACE_WITH_CUSTOM`。
+  `trimValue` – 指定要移除所有或部分極端值。當 `replaceType` 為 `REPLACE_WITH_NULL`、 或 `TRUE`時`REPLACE_WITH_MODE`，此布林值會設為 `WINSORIZE_VALUES`。對於所有其他`FALSE`項目，其預設為 。
  + `FALSE` – 移除所有極端值
  +  `TRUE` –移除超出 `minValue`和 中指定之百分位數上限閾值的極端值`maxValue`。

下列範例顯示單一[https://docs.aws.amazon.com/databrew/latest/dg/API_RecipeAction.html](https://docs.aws.amazon.com/databrew/latest/dg/API_RecipeAction.html)操作的語法。*配方*至少包含一個[https://docs.aws.amazon.com/databrew/latest/dg/API_RecipeStep.html](https://docs.aws.amazon.com/databrew/latest/dg/API_RecipeStep.html)操作，而配方步驟至少包含一個配方動作。*配方動作*會執行您指定的資料轉換。一組配方動作會依序執行，以建立最終資料集。

------
#### [ JSON ]

以下顯示使用 JSON 語法做為 `RecipeStep` DataBrew [Recipe](https://docs.aws.amazon.com/databrew/latest/dg/API_Recipe.html) 範例`RecipeAction`成員的範例。如需顯示配方動作清單的語法範例，請參閱 [定義配方結構](recipes.md#recipes.structure)。

**Example JSON 中的範例**  

```
{
    "Action": {
        "Operation": "REPLACE_OUTLIERS",
        "Parameters": {
            "maxValue": "{{95}}",
            "minValue": "{{5}}",
            "modeType": "{{AVERAGE}}",
            "outlierStrategy": "{{Z_SCORE}}",
            "replaceType": "{{REPLACE_WITH_MODE}}",
            "sourceColumn": "{{name-of-existing-column}}",
            "threshold": "{{3}}",
            "trimValue": "{{TRUE}}"
        }
    }
}
```

如需在 API 操作中使用此配方動作的詳細資訊，請參閱 [https://docs.aws.amazon.com/databrew/latest/dg/API_CreateRecipe.html](https://docs.aws.amazon.com/databrew/latest/dg/API_CreateRecipe.html)或 [https://docs.aws.amazon.com/databrew/latest/dg/API_UpdateRecipe.html](https://docs.aws.amazon.com/databrew/latest/dg/API_UpdateRecipe.html)。您可以在自己的程式碼中使用這些 和其他 API 操作。

------
#### [ YAML ]

以下顯示使用 YAML 語法做為 `RecipeStep` DataBrew [Recipe](https://docs.aws.amazon.com/databrew/latest/dg/API_Recipe.html) 範例`RecipeAction`成員的範例。如需顯示配方動作清單的語法範例，請參閱 [定義配方結構](recipes.md#recipes.structure)。

**Example YAML 中的範例**  

```
- Action:
  Operation: REMOVE_OUTLIERS
  Parameters:
    sourceColumn: {{name-of-existing-column}}
    outlierStrategy: {{Z_SCORE}}
    threshold: '{{3}}'
    replaceType: {{REPLACE_WITH_MODE}}
    modeType: {{AVERAGE}}
    minValue: '{{5}}'
    maxValue: '{{95}}'
    trimValue: '{{TRUE}}'
```

如需在 API 操作中使用此配方動作的詳細資訊，請參閱 [https://docs.aws.amazon.com/databrew/latest/dg/API_CreateRecipe.html](https://docs.aws.amazon.com/databrew/latest/dg/API_CreateRecipe.html)或 [https://docs.aws.amazon.com/databrew/latest/dg/API_UpdateRecipe.html](https://docs.aws.amazon.com/databrew/latest/dg/API_UpdateRecipe.html)。您可以在自己的程式碼中使用這些 和其他 API 操作。

------