建立及管理實驗執行作業

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

Python 適用的 Vertex AI SDK

以下範例使用 aiplatform Package 函式中的 initstart_runend_run 方法,以及 ExperimentClass 中的 delete 方法。

建立並開始執行

Python 適用的 Vertex AI SDK

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:選填。用於啟用及儲存使用 log_time_series_metrics 記錄至此實驗執行作業的時間序列指標的基礎 TensorBoard 資源。
  • project:您的專案 ID。您可以在 Google Cloud 控制台的「歡迎」頁面中找到這些 ID。
  • location:請參閱可用位置清單

結束執行

Python 適用的 Vertex AI SDK

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:您的專案 ID。您可以在 Google Cloud 控制台的「歡迎」頁面找到這些資訊。
  • location:請參閱「可用位置清單

繼續執行

Python 適用的 Vertex AI SDK

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:您的專案 ID。您可以在 Google Cloud 控制台的「歡迎」頁面找到這些資訊。
  • location:請參閱可用位置清單

刪除執行作業

Python 適用的 Vertex AI SDK

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:您的專案 ID。您可以在 Google Cloud 控制台的「歡迎」頁面找到這些資訊。
  • location:請參閱可用位置清單
  • delete_backing_tensorboard_run:是否要刪除用於儲存此執行作業時間序列指標的 Vertex AI TensorBoard 執行作業。

管理狀態

Python 適用的 Vertex AI SDK

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:您的專案 ID。您可以在 Google Cloud 控制台的「歡迎」頁面中找到這些專案 ID。
  • location:請參閱可用位置清單
  • statestate 的可能值會在 Google Cloud 控制台中顯示為「status」,包括:
    • 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. 在「Experiment details」(實驗詳細資料) 頁面中,按一下與要刪除的實驗執行作業相關聯的實驗名稱。「實驗執行」頁面隨即顯示,並列出該實驗的所有實驗執行作業。
  3. 選取要刪除的執行作業相關聯的核取方塊。 系統會顯示「Delete」按鈕。
  4. 按一下「刪除」
    • 或者,您也可以前往與實驗執行作業位於同一列的 選項選單,然後選取「刪除」

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

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

後續步驟