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

# Amazon SageMaker Experiments の統合
<a name="pipelines-experiments"></a>

Amazon SageMaker Pipelines は Amazon SageMaker Experiments と密接に統合されています。デフォルトでは、Pipelines がパイプラインを作成して実行する際、次の SageMaker Experiments エンティティがない場合は作成されます。
+ パイプラインの実験
+ パイプラインの実行ごとの実行グループ
+ パイプラインの実行ステップで作成された各 SageMaker AI ジョブの実行グループに追加される実行

SageMaker AI モデルトレーニング実験の複数の実行グループでメトリクスを比較するのと同じように、複数のパイプラインの実行でモデルトレーニングの精度などのメトリクスを比較できます。

以下のサンプルは、[Amazon SageMaker Python SDK](https://sagemaker.readthedocs.io/en/stable) の[Pipeline](https://github.com/aws/sagemaker-python-sdk/blob/v2.41.0/src/sagemaker/workflow/pipeline.py) に関連するパラメータを示しています。

```
Pipeline(
    name="MyPipeline",
    parameters=[...],
    pipeline_experiment_config=PipelineExperimentConfig(
      ExecutionVariables.PIPELINE_NAME,
      ExecutionVariables.PIPELINE_EXECUTION_ID
    ),
    steps=[...]
)
```

パイプラインの実験と実行グループを作成しない場合は、`pipeline_experiment_config` を `None` に設定します。

**注記**  
Experiments の統合は Amazon SageMaker Python SDK v2.41.0 で導入されました。

以下の命名規則は、`pipeline_experiment_config` の `ExperimentName` と `TrialName` のパラメータで指定した内容に基づいて適用されます。
+ `ExperimentName` を指定しない場合は、パイプライン `name` が実験名に使用されます。

  `ExperimentName` を指定する合は、それが実験名に使用されます。同じ名前の実験がある場合は、パイプラインで作成された実行グループが既存の実験に追加されます。同じ名前の実験がない場合は、新しい実験が作成されます。
+ `TrialName` を指定しない場合は、パイプラインの実行 ID が実行グループ名に使用されます。

  `TrialName` を指定する合は、それが実行グループ名に使用されます。同じ名前の実行グループがある場合は、パイプラインで作成された実行が既存の実行グループに追加されます。同じ名前の実行グループが存在しない場合、新しい実行グループが作成されます。

**注記**  
エンティティを作成したパイプラインが削除されても、実験エンティティは削除されません。SageMaker Experments API を使用すると、エンティティを削除できます。

パイプラインに関連付けられた SageMaker AI Experiment エンティティを表示する方法については、「[パイプラインから実験データにアクセスする](pipelines-studio-experiments.md)」を参照してください。SageMaker Experiments の詳細については、「[Studio Classic の Amazon SageMaker Experiments](experiments.md)」を参照してください。

以下のセクションでは、ここまでのルールのサンプルと、パイプライン定義ファイルでのルールの記述方法を紹介します。パイプライン定義ファイルの詳細については、「[Pipelines の概要](pipelines-overview.md)」を参照してください。

**Topics**
+ [デフォルトの動作](pipelines-experiments-default.md)
+ [Experiments の統合を無効にする](pipelines-experiments-none.md)
+ [カスタム実験名を指定する](pipelines-experiments-custom-experiment.md)
+ [カスタム実行グループ名を指定する](pipelines-experiments-custom-trial.md)