创建或删除实验

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

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

创建具有 TensorBoard 实例的实验

Python 版 Vertex AI SDK

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

Python

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 控制台中，前往实验页面。
   <a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="V3Ae1hvcBOij4KvUNiRrMltigmNHgUGOXn/QVSGplOhBlpxunv8WHL3F/z3VuS9rwbZOYpOQCXa+v4aZ0dt03w==" target="console" track-name="consoleLink" track-type="tasks" }="">转到实验</a{:>
2. 确保您位于要在其中创建实验的项目。
   
3. 点击 创建以打开实验窗格。此时会显示创建实验窗格。
4. 在实验名称字段中，提供一个可唯一标识您的实验的名称。
5. 可选。在 TensorBoard 实例字段中，从下拉列表中选择一个实例或为新的 TensorBoard 实例提供名称。
6. 点击创建以创建实验。

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

Python 版 Vertex AI SDK

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

Python

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

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 控制台中，转到实验页面。
   <a{: class="button button-primary" l10n-attrs-original-order="href,target,class,track-name,track-type" l10n-encrypted-href="V3Ae1hvcBOij4KvUNiRrMltigmNHgUGOXn/QVSGplOhBlpxunv8WHL3F/z3VuS9rwbZOYpOQCXa+v4aZ0dt03w==" target="console" track-name="consoleLink" track-type="tasks" }="">转到实验 </a{:>
2. 选中要删除的实验所关联的复选框。系统会显示删除选项。
3. 点击删除。
   • 或者，您也可以转到与实验位于同一行的 选项菜单，然后选择删除。

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

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

   转到“实验”页面

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

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

后续步骤

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

相关笔记本示例

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