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

# Pipeline のパラメータ
<a name="build-and-manage-parameters"></a>

パラメータを使用すると、パイプライン定義に変数を導入できます。定義したパラメータは、パイプライン定義全体で参照できます。パラメータはデフォルト値を持ちますが、パイプラインの実行の開始時にパラメータ値を指定することによってオーバーライドできます。デフォルト値は、パラメータタイプに一致するインスタンスでなければなりません。ステップ定義で使用されるすべてのパラメータは、パイプライン定義で定義する必要があります。このトピックでは、定義できるパラメータとその実装方法について説明します。

Amazon SageMaker Pipelines では、以下のパラメータタイプをサポートしています。
+  `ParameterString` — 文字列パラメータを表します。
+  `ParameterInteger` — 整数パラメータを表します。
+  `ParameterFloat` — float パラメータを表します。
+  `ParameterBoolean` — Python ブール型を表します。

パラメータは、次の形式になります。

```
<parameter> = <parameter_type>(
    name="<parameter_name>",
    default_value=<default_value>
)
```

パラメータの実装例は次のとおりです。

```
from sagemaker.workflow.parameters import (
    ParameterInteger,
    ParameterString,
    ParameterFloat,
    ParameterBoolean
)

processing_instance_count = ParameterInteger(
    name="ProcessingInstanceCount",
    default_value=1
)
```

パラメータは、次の例に示すようにパイプラインの作成時に渡します。

```
pipeline = Pipeline(
    name=pipeline_name,
    parameters=[
        processing_instance_count
    ],
    steps=[step_process]
)
```

次の例に示すように、デフォルト値とは異なるパラメータ値をパイプラインの実行に渡すこともできます。

```
execution = pipeline.start(
    parameters=dict(
        ProcessingInstanceCount="2",
        ModelApprovalStatus="Approved"
    )
)
```

パラメータは、`[ sagemaker.workflow.functions.Join](https://sagemaker.readthedocs.io/en/stable/workflows/pipelines/sagemaker.workflow.pipelines.html#sagemaker.workflow.functions.Join)` などの SageMaker Python SDK 関数を使用して操作できます。パラメータの詳細については、「[SageMaker パイプラインのパラメータ](https://sagemaker.readthedocs.io/en/stable/workflows/pipelines/sagemaker.workflow.pipelines.html#parameters)」を参照してください。

パイプラインパラメータの既知の制限については、「[Amazon SageMaker Python SDK](https://sagemaker.readthedocs.io/en/stable)」の「*[Limitations - Parameterization](https://sagemaker.readthedocs.io/en/stable/amazon_sagemaker_model_building_pipeline.html#parameterization)*」を参照してください。