可刪除模型

本頁說明如何刪除 BigQuery ML 模型。您可透過以下方式刪除模型：

• 使用 Google Cloud 控制台
• 使用 bq 指令列工具的 bq rm 指令或 bq query 指令
• 呼叫 models.delete API 方法或 jobs.query 方法
• 使用用戶端程式庫

一次只能刪除一個模型。刪除模型時，也會刪除模型中的所有資料。

如要在指定時間過後自動刪除模型，您可在使用 bq 指令列工具、API 或用戶端程式庫時，設定模型的到期時間。如您在建立模型時未設定到期，則可更新模型的到期時間。

刪除模型的限制

刪除模型有下列限制：

• 您無法同時刪除多個模型，您必須個別刪除這些資源。
• 已刪除的模型無法還原。

所需權限

如要刪除資料集中的模型，您必須取得資料集的 WRITER 角色，或取得包含 bigquery.models.delete 權限的專案層級身分與存取權管理 (IAM) 角色。如您已取得專案層級的 bigquery.models.delete 權限，則可刪除專案內任何資料集中的模型。下列專案層級身分與存取權管理角色包含 bigquery.models.delete 權限：

• bigquery.dataEditor
• bigquery.dataOwner
• bigquery.admin

如要進一步瞭解 BigQuery ML 中的身分與存取權管理角色和權限，請參閱存取權控管。

刪除模型

如要刪除模型，請按照下列步驟操作：

控制台

您可使用 Google Cloud console 中的「Delete Model」選項，或是執行內含 DROP MODEL | DROP MODEL IF EXISTS DDL 陳述式的查詢，以刪除模型。

選項一：使用「Delete Model」(刪除模型) 選項。

1. 點選左側窗格中的 「Explorer」：

   

   如果沒有看到左側窗格，請按一下「展開左側窗格」圖示 開啟窗格。

2. 在「Explorer」窗格中展開專案，按一下「Datasets」(資料集)，然後按一下資料集。

3. 按一下「模型」分頁標籤，然後按一下模型名稱選取模型。

4. 按一下模型選項圖示 ，然後點選「刪除」。

5. 在「Delete Model」(刪除模型) 對話方塊中，輸入 delete，然後點選「Delete」(刪除)。

選項二：使用 DDL 陳述式。

1. 前往 Google Cloud 控制台的「BigQuery」頁面。

   前往 BigQuery 頁面

2. 按一下 [Compose new query] (撰寫新查詢)。

3. 在「Query editor」(查詢編輯器) 的文字區域中輸入 DDL 陳述式。

    DROP MODEL mydataset.mymodel

4. 按一下「執行」。當查詢完成時，就會從導覽窗格中移除模型。

bq

您可使用 bq 指令列工具輸入以下指令來刪除模型：

• bq rm 指令，並加上 --model 或 -m 旗標
• bq query 指令，並提供 DDL 陳述式做為查詢參數

如要刪除非預設專案中的模型，請使用下列格式將專案 ID 新增至資料集：[PROJECT_ID]:[DATASET].[MODEL]。

選項一：輸入 bq rm 指令

當您使用 bq rm 指令移除模型時，必須確認該操作。您可以使用 --force flag (或 -f 捷徑) 來略過確認程序。

bq rm -f --model PROJECT_ID:DATASET.MODEL

更改下列內容：

• PROJECT_ID 是您的專案 ID。
• DATASET 是資料集名稱。
• MODEL 是模型的名稱。

rm 指令不會產生任何輸出。

範例：

輸入下列指令從 mydataset 刪除 mymodel。mydataset 在您的預設專案中。

bq rm --model mydataset.mymodel

輸入下列指令從 mydataset 刪除 mymodel。mydataset 在 myotherproject 中，而不是您的預設專案中。

bq rm --model myotherproject:mydataset.mymodel

輸入下列指令從 mydataset 刪除 mymodel。mydataset 在您的預設專案中。這個指令使用 -f 捷徑略過確認程序。

bq rm -f --model mydataset.mymodel

您可以發出 bq ls 指令，確認模型已刪除。 詳情請參閱「列出模型」。

選項二：輸入 bq query 指令

如要使用 bq query 指令刪除模型，請在查詢參數中提供 DROP MODEL 陳述式，並提供 --use_legacy_sql=false 標記以指定 GoogleSQL 查詢語法。

範例：

輸入下列指令從 mydataset 刪除 mymodel。mydataset 在您的預設專案中。

bq query --use_legacy_sql=false 'DROP MODEL mydataset.mymodel'

輸入下列指令從 mydataset 刪除 mymodel。mydataset 在 myotherproject 中，而不是您的預設專案中。

bq query --use_legacy_sql=false \
'DROP MODEL myotherproject:mydataset.mymodel'

API

選項一：呼叫 models.delete 方法

如要刪除模型，請呼叫 models.delete 方法，並提供 projectId、datasetId 和 modelId。

選項二：呼叫 jobs.query 方法

如要刪除模型，請呼叫 jobs.query 方法，並在要求主體的 query 屬性中提供 DROP MODEL DDL 陳述式。

Go

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Go 設定操作說明進行操作。詳情請參閱 BigQuery Go API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// deleteModel demonstrates deletion of BigQuery ML model.
func deleteModel(projectID, datasetID, modelID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// modelID := "mymodel"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %w", err)
	}
	defer client.Close()

	model := client.Dataset(datasetID).Model(modelID)
	if err := model.Delete(ctx); err != nil {
		return fmt.Errorf("couldn't delete model: %w", err)
	}
	return nil
}

Java

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Java 設定操作說明進行操作。詳情請參閱 BigQuery Java API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.ModelId;

// Sample to delete a model
public class DeleteModel {

  public static void main(String[] args) {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String modelName = "MY_MODEL_NAME";
    deleteModel(datasetName, modelName);
  }

  public static void deleteModel(String datasetName, String modelName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();
      boolean success = bigquery.delete(ModelId.of(datasetName, modelName));
      if (success) {
        System.out.println("Model deleted successfully");
      } else {
        System.out.println("Model was not found");
      }
    } catch (BigQueryException e) {
      System.out.println("Model was not deleted. \n" + e.toString());
    }
  }
}

Node.js

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Node.js 設定操作說明進行操作。詳情請參閱 BigQuery Node.js API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function deleteModel() {
  // Deletes a model named "my_model" from "my_dataset".

  /**
   * TODO(developer): Uncomment the following lines before running the sample
   */
  // const datasetId = "my_dataset";
  // const modelId = "my_model";

  const dataset = bigquery.dataset(datasetId);
  const model = dataset.model(modelId);
  await model.delete();

  console.log(`Model ${modelId} deleted.`);
}

Python

在試用這個範例之前，請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Python 設定操作說明進行操作。詳情請參閱 BigQuery Python API 參考說明文件。

如要向 BigQuery 進行驗證，請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。

from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set model_id to the ID of the model to fetch.
# model_id = 'your-project.your_dataset.your_model'

client.delete_model(model_id)  # Make an API request.

print("Deleted model '{}'.".format(model_id))

還原已刪除的模型

已刪除的模型無法還原。

後續步驟

• 如需 BigQuery ML 的總覽，請參閱 BigQuery ML 簡介。
• 如要開始使用 BigQuery ML，請參閱在 BigQuery ML 中建立機器學習模型。
• 如要進一步瞭解模型的使用方式，請參閱以下說明：
  • 取得模型中繼資料
  • 列出模型
  • 更新模型中繼資料
  • 管理模型