创建或删除实验

您可以使用 Vertex AI SDK for Python 或 Google Cloud 控制台创建或删除实验。SDK 是一个 Python 代码库，可用于以编程方式创建和管理实验。控制台是一个基于网页的界面，可用于直观地创建和管理实验。

首次使用 Google Cloud 控制台创建实验时，请确保有一个 default Metadata Store。如需查看此信息，请转到 Google Cloud 控制台中您的项目的元数据页面。请参阅配置项目的元数据存储区

创建具有 TensorBoard 实例的实验

Python 版 Vertex AI SDK

使用 Vertex AI SDK for Python 创建实验并（可选）关联 Vertex AI TensorBoard 实例。为实验添加说明，以记录其用途。请参阅 Vertex AI SDK 参考文档中的 init。

Python

from typing import Optional, Union

from google.cloud import aiplatform


def create_experiment_sample(
    experiment_name: str,
    experiment_description: str,
    experiment_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=experiment_tensorboard,
        project=project,
        location=location,
    )

• experiment_name：提供实验的名称。
• experiment_description：提供实验的说明。
• experiment_tensorboard：可选。Vertex TensorBoard 实例用作所提供实验的后备 TensorBoard。 如果未提供 experiment_tensorboard，则会创建并使用默认的 TB 实例进行此实验。注意：如果需要将 CMEK（加密密钥）与 TensorBoard 实例相关联，则 experiment_tensorboard 不再是可选项。
• project：您的项目 ID。 您可以在 Google Cloud 控制台的欢迎页面中找到这些 ID。
  
• location：请参阅可用位置列表。如果要创建 TensorBoard 实例，请务必使用支持 TensorBoard 的区域。

Google Cloud 控制台

按照以下说明创建实验。

1. 在 Google Cloud 控制台中，前往实验页面。
   前往“实验”
2. 确保您位于要在其中创建实验的项目。
   
3. 点击 创建以打开实验窗格。此时会显示创建实验窗格。
4. 在实验名称字段中，提供一个可唯一标识您的实验的名称。
5. 可选。在 TensorBoard 实例字段中，从下拉列表中选择一个实例或为新的 TensorBoard 实例提供名称。
6. 点击创建以创建实验。

创建没有默认 TensorBoard 实例的实验

Python 版 Vertex AI SDK

创建实验。 为实验添加说明，以记录其用途。请参阅 Vertex AI SDK 参考文档中的 init。

Python

from google.cloud import aiplatform


def create_experiment_without_default_tensorboard_sample(
    experiment_name: str,
    experiment_description: str,
    project: str,
    location: str,
):
    aiplatform.init(
        experiment=experiment_name,
        experiment_description=experiment_description,
        experiment_tensorboard=False,
        project=project,
        location=location,
    )

• experiment_name：提供实验的名称。
• experiment_description：提供实验的说明。
• project：您的项目 ID。 您可以在 Google Cloud 控制台的欢迎页面中找到这些 ID。
  
• location：请参阅可用位置列表。如果要创建 TensorBoard 实例，请务必使用支持 TensorBoard 的区域。

删除实验

删除一个实验会删除该实验以及与该实验关联的所有实验运行作业。与实验关联的 Vertex AI TensorBoard 实验不会被删除。如需删除 TensorBoard 实验，请参阅删除过时的 Vertex AI TensorBoard 实验。

此外，与已删除的实验关联的任何流水线运行作业、工件和执行作业都不会移除。您可以在 Google Cloud 控制台中找到这些信息。对于工件和执行，Vertex ML Metadata 服务每月每 GB 收取 10 美元费用。

Python 版 Vertex AI SDK

以下示例使用 ExperimentClass 中的 delete 方法。

Python

from google.cloud import aiplatform


def delete_experiment_sample(
    experiment_name: str,
    project: str,
    location: str,
    delete_backing_tensorboard_runs: bool = False,
):
    experiment = aiplatform.Experiment(
        experiment_name=experiment_name, project=project, location=location
    )

    experiment.delete(delete_backing_tensorboard_runs=delete_backing_tensorboard_runs)

• experiment_name：提供实验的名称。
• project：您的项目 ID。 您可以在 Google Cloud 控制台的欢迎页面中找到这些 ID。
• location：请参阅可用位置列表。
• delete_backing_tensorboard_runs：如果 True 还会删除与此实验（我们用于存储时间序列指标）下的实验运行关联的 Vertex AI TensorBoard 运行。

控制台

按照以下说明删除实验。

1. 在 Google Cloud 控制台中，转到实验页面。
   前往“实验”
2. 选中要删除的实验所关联的复选框。系统会显示删除选项。
3. 点击删除。
   • 或者，您也可以转到与实验位于同一行的 选项菜单，然后选择删除。

在 Google Cloud 控制台中查看实验列表

1. 在 Google Cloud 控制台的 Vertex AI 部分中，转到实验页面。

   转到“实验”页面

2. 确保您位于正确的项目中。

3. 实验跟踪视图中会显示您的项目的实验列表。
   如果您将 Vertex AI TensorBoard 实例与实验相关联，它会在列表中显示为“your-experiment Backing Tensorboard Experiment”。

后续步骤

• 创建和管理实验运行
• 删除过时的 Vertex AI TensorBoard 实验

相关笔记本示例

• 使用预构建的数据预处理代码进行模型训练