建立及管理實驗執行作業

使用 Python 適用的 Vertex AI SDK 建立及管理實驗執行作業。您可以使用 Google Cloud 控制台刪除實驗執行作業。

Python 適用的 Vertex AI SDK

下列範例使用 aiplatform 套件函式中的 init、start_run 和 end_run 方法，以及 ExperimentClass 中的 delete。

建立並啟動執行作業

Python

from typing import Optional, Union

from google.cloud import aiplatform


def create_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    experiment_run_tensorboard: Optional[Union[str, aiplatform.Tensorboard]],
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, tensorboard=experiment_run_tensorboard)
  • experiment_name：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取「實驗」部分導覽。
  • run_name：指定要與目前工作階段建立關聯的執行作業名稱。請參閱 Vertex AI SDK 參考資料說明文件中的 start_run。
  • experiment_run_tensorboard： 選用。後端 TensorBoard 資源，可啟用及儲存使用 log_time_series_metrics 記錄到這項實驗執行的時間序列指標。
  • project：。您可以在 Google Cloud 控制台 歡迎頁面中找到這些 ID。
  • location：請參閱「支援的地區清單」

結束跑步

Python

from google.cloud import aiplatform


def end_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, resume=True)

    aiplatform.end_run()
  • experiment_name：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取「實驗」部分導覽。
  • run_name：指定執行名稱。
  • project：。您可以在 Google Cloud 控制台 歡迎頁面中找到這些資訊。
  • location：請參閱「支援的地點清單」

繼續執行

Python

from google.cloud import aiplatform


def resume_experiment_run_sample(
    experiment_name: str,
    run_name: str,
    project: str,
    location: str,
):
    aiplatform.init(experiment=experiment_name, project=project, location=location)

    aiplatform.start_run(run=run_name, resume=True)
  • experiment_name：提供實驗名稱。 如要查看實驗清單，請在 Google Cloud 控制台選取「實驗」部分導覽。
  • run_name：指定要繼續執行的執行名稱。
  • project：。您可以在 Google Cloud 控制台 歡迎頁面中找到這些資訊。
  • location：請參閱「支援的地點清單」

刪除執行作業

Python

from typing import Union

from google.cloud import aiplatform


def delete_experiment_run_sample(
    run_name: str,
    experiment: Union[str, aiplatform.Experiment],
    project: str,
    location: str,
    delete_backing_tensorboard_run: bool = False,
):
    experiment_run = aiplatform.ExperimentRun(
        run_name=run_name, experiment=experiment, project=project, location=location
    )

    experiment_run.delete(delete_backing_tensorboard_run=delete_backing_tensorboard_run)
  • experiment：這項實驗的名稱或執行個體。如要查看實驗清單，請在控制台的區段導覽中選取「實驗」 Google Cloud 。
  • run_name：指定要刪除的執行作業名稱。
  • project：。您可以在 Google Cloud 控制台 歡迎頁面中找到這些資訊。
  • location：請參閱「支援的地點清單」
  • delete_backing_tensorboard_run：是否要刪除儲存此執行個體時間序列指標的支援 Vertex AI TensorBoard 執行個體。

管理狀態

Python

from typing import Union

from google.cloud import aiplatform


def update_experiment_run_state_sample(
    run_name: str,
    experiment: Union[str, aiplatform.Experiment],
    project: str,
    location: str,
    state: aiplatform.gapic.Execution.State,
) -> None:
    experiment_run = aiplatform.ExperimentRun(
        run_name=run_name,
        experiment=experiment,
        project=project,
        location=location,
    )

    experiment_run.update_state(state)
  • run_name：與實驗相關聯的執行名稱
  • experiment_name：實驗名稱。如要查看實驗清單，請在 Google Cloud 控制台選取區段導覽中的「實驗」。
  • project：。您可以在 Google Cloud 控制台歡迎頁面中找到這些專案 ID。
  • location：請參閱「支援的地區清單」
  • state：state 的可能值，在 Google Cloud 控制台中會顯示為「狀態」：
    • aiplatform.gapic.Execution.State.CACHED
    • aiplatform.gapic.Execution.State.CANCELLED
    • aiplatform.gapic.Execution.State.COMPLETE
    • aiplatform.gapic.Execution.State.FAILED
    • aiplatform.gapic.Execution.State.NEW
    • aiplatform.gapic.Execution.State.RUNNING

Google Cloud 控制台

請按照下列步驟刪除實驗執行。
  1. 前往 Google Cloud 控制台的「Experiments」頁面。
    前往「實驗」
  2. 在實驗詳細資料頁面中，按一下與要刪除的實驗執行相關聯的實驗名稱。系統會顯示「實驗執行」頁面，列出該實驗的所有實驗執行作業。
  3. 選取要刪除的執行作業相關聯的核取方塊。 系統會隨即顯示「刪除」按鈕。
  4. 按一下「刪除」
    • 或者，您也可以前往實驗執行所在的資料列，開啟 選單，然後選取「刪除」。

查看實驗執行作業清單和執行作業詳細資料

Google Cloud 控制台會以視覺化方式呈現與這些執行作業相關聯的資料。

後續步驟