更新模型中繼資料
更新 BigQuery ML 模型中繼資料,有助於整理及管理機器學習資產的生命週期。您可以修改模型的說明、標籤和到期時間,以便識別資源、使用鍵/值組合追蹤用量,以及自動刪除過時的模型。所需權限
如要更新模型中繼資料,您必須具備資料集的 WRITER 角色,或具備包含 bigquery.models.updateMetadata 權限的專案層級 Identity and Access Management (IAM) 角色。如果您在專案層級獲得 bigquery.models.updateMetadata 權限,則可更新專案中任何資料集的模型中繼資料。下列預先定義的專案層級 IAM 角色包含 bigquery.models.updateMetadata 權限:
bigquery.dataEditorbigquery.dataOwnerbigquery.admin
如要進一步瞭解 BigQuery ML 的 IAM 角色和權限,請參閱「存取控管」。
更新模型說明
模型說明是用來識別模型的文字字串。
如何更新模型的說明:
控制台
前往 Google Cloud 控制台的「BigQuery」頁面。
點選左側窗格中的 「Explorer」。

如果沒有看到左側窗格,請按一下 「Expand left pane」(展開左側窗格),開啟窗格。
在「Explorer」窗格中展開專案,依序點選「Datasets」(資料集) 和資料集。
按一下「Models」(模型) 分頁標籤,然後點選模型名稱來選取模型。
點按「Details」(詳細資料) 分頁標籤。
如要更新模型說明,請按一下「Edit」(編輯) 。
在「Edit detail」(編輯詳細資料) 對話方塊中,更新說明,然後按一下「Save」(儲存)。
bq
如要更新模型說明,請發出 bq update 指令,並加上 --model 或 -m 旗標和 --description 旗標。
如要更新預設專案以外的模型,請按照下列格式,將專案 ID 新增至資料集:[PROJECT_ID]:[DATASET]。
bq update --model --description "[STRING]" PROJECT_ID:DATASET.MODEL
更改下列內容:
STRING是描述模型的文字字串 (置於引號之中)。PROJECT_ID是您的專案 ID。DATASET是資料集名稱。MODEL是模型的名稱。
指令輸出內容如下所示:
Model 'myproject.mydataset.mymodel' successfully updated.
您可以發出 bq show 指令來確認變更。詳情請參閱「取得模型中繼資料」。
範例:
輸入下列指令,更新預設專案中 mydataset 內 mymodel 的說明。
bq update --model --description "My updated description" \
mydataset.mymodel
輸入下列指令,更新 myotherproject 中 mydataset 的 mymodel 說明。
bq update --model --description "My updated description" \
myotherproject:mydataset.mymodel
API
如要使用 API 更新模型說明,請呼叫 models.patch 方法,並提供 projectId、datasetId 和 modelId。如要修改說明,請新增或更新模型資源的「description」屬性。
Go
在試用這個範例之前,請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Go 設定操作說明進行操作。詳情請參閱 BigQuery Go API 參考文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Java
在試用這個範例之前,請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Java 設定操作說明進行操作。詳情請參閱 BigQuery Java API 參考文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Node.js
在試用這個範例之前,請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Node.js 設定操作說明進行操作。詳情請參閱 BigQuery Node.js API 參考文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
Python
在試用這個範例之前,請先按照「使用用戶端程式庫的 BigQuery 快速入門導覽課程」中的 Python 設定操作說明進行操作。詳情請參閱 BigQuery Python API 參考文件。
如要向 BigQuery 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
更新模型標籤
標籤是您可以附加至資源的鍵/值組合。建立 BigQuery ML 資源時可以選擇是否要加入標籤。詳情請參閱「新增及使用標籤」。
如要更新模型標籤:
控制台
點選左側窗格中的 「Explorer」。

在「Explorer」窗格中展開專案,依序點選「Datasets」(資料集) 和資料集。
按一下「Models」(模型) 分頁標籤,然後點選模型名稱來選取模型。
點按「Details」(詳細資料) 分頁標籤。
如要更新模型的標籤,請按一下「Edit」(編輯) 。
在「Edit detail」(編輯詳細資料) 對話方塊中,新增、刪除或修改標籤,然後按一下「Save」(儲存)。
bq
如要更新模型的標籤,請發出 bq update 指令,並加上 --model 或 -m 旗標和 --set_label 旗標。重複使用 --set_label 旗標,即可新增或更新多個標籤。
如要更新預設專案以外的模型,請按照下列格式,將專案 ID 新增至資料集:[PROJECT_ID]:[DATASET]。
bq update --model --set_label KEY:VALUE \ PROJECT_ID:DATASET.MODEL
更改下列內容:
KEY:VALUE對應至要新增或更新的標籤鍵/值組合。如果您指定與現有標籤相同的鍵,該標籤的值就會更新。鍵不得重複。PROJECT_ID是您的專案 ID。DATASET是資料集名稱。MODEL是模型的名稱。
指令輸出內容如下所示:
Model 'myproject.mydataset.mymodel' successfully updated.
您可以發出 bq show 指令來確認變更。詳情請參閱「取得模型中繼資料」。
範例:
如要更新 mymodel 上的 department 標籤,請輸入 bq update 指令,並指定 department 做為標籤鍵。舉例來說,如要將 department:shipping 標籤更新為 department:logistics,請輸入下列指令。mydataset 位於 myotherproject,而非預設專案。
bq update --model --set_label department:logistics \
myotherproject:mydataset.mymodel
API
如要使用 API 更新模型的標籤,請呼叫 models.patch 方法,並提供 projectId、datasetId 和 modelId。如要修改標籤,請新增或更新模型資源的「labels」屬性。
更新模型的到期時間
模型的到期時間是一種時間戳記值,此值會決定刪除模型的時間。您可在使用 CLI、API 或用戶端程式庫時,設定模型的到期時間。您也可以在建立模型後,設定或更新模型的到期時間。模型的到期時間通常稱為「存留時間」或 TTL。
如果未設定模型的到期時間,模型就永不失效,您必須手動刪除模型。
到期時間的值會依該值的設定位置而有不同的表示方式。請使用可為您提供適當精細層級的方法:
- 在指令列工具中,到期時間會以目前 UTC 時間表示 (單位為秒)。一旦您在指令列指定到期時間,系統就會將您設定的整數值 (以秒為單位) 加至當下的 UTC 時間戳記。
- 在 API 中,到期時間會自訓練週期開始計算,並以毫秒為單位表示。如果您指定的到期值小於當下的時間戳記,則模型會立即到期。
如要更新模型的到期時間:
控制台
Google Cloud 控制台不支援設定或更新模型的到期時間。
bq
如要更新模型的到期時間,請發出 bq update 指令,並加上 --model 或 -m 旗標和 --expiration 旗標。
如要更新預設專案以外的模型,請按照下列格式,將專案 ID 新增至資料集:[PROJECT_ID]:[DATASET]。
bq update --model --expiration INTEGER \ PROJECT_ID:DATASET.MODEL
更改下列內容:
INTEGER是模型的生命週期 (單位為秒)。最小值是 3600 秒 (1 小時)。到期時間為目前世界標準時間加整數值。PROJECT_ID是您的專案 ID。DATASET是資料集名稱。MODEL是模型的名稱。
指令輸出內容如下所示:
Model 'myproject.mydataset.mymodel' successfully updated.
您可以發出 bq show 指令來確認變更。詳情請參閱「取得模型中繼資料」。
範例:
輸入下列指令,將 mydataset 中的 mymodel 到期時間更新為 5 天 (432000 秒)。mydataset 位於您的預設專案中。
bq update --model --expiration 432000 mydataset.mymodel
輸入下列指令,將 mydataset 中的 mymodel 到期時間更新為 5 天 (432000 秒)。mydataset 在 myotherproject 中,而不是您的預設專案中。
bq update --model --expiration 432000 myotherproject:mydataset.mymodel
API
如要使用 API 更新模型的到期時間,請呼叫 models.patch 方法,並提供 projectId、datasetId 和 modelId。如要修改到期時間,請新增或更新模型資源的「expirationTime」屬性。「expirationTime」以毫秒為單位,自 Epoch 紀元時間起算。
後續步驟
- 如需 BigQuery ML 的總覽,請參閱 BigQuery ML 簡介。
- 如要開始使用 BigQuery ML,請參閱「在 BigQuery ML 中建立機器學習模型」。
- 如要進一步瞭解如何使用模型,請參閱: