管理工作負載承諾使用合約

BigQuery Reservation API 可讓您購買專用運算單元 (稱為「承諾使用合約」)、建立運算單元集區 (稱為「預留項目」)，以及將專案、資料夾和組織指派給這些預留項目。

「承諾使用合約」是指購買 BigQuery 運算資源，但有最短承諾使用期。使用版本建立預留項目時，不一定要購買運算資源承諾使用合約，但可以節省費用。

承諾是區域資源。在某個區域或多區域購買的承諾無法用於其他區域或多區域。承諾使用合約無法在區域之間，或區域與多區域之間移動。承諾使用合約無法在專案之間轉移。

啟用 Reservations API

BigQuery Reservation API 與現有的 BigQuery API 不同，必須單獨啟用。詳情請參閱「啟用及停用 API」。

  • API 名稱為「BigQuery Reservations API」
  • BigQuery Reservation API 的端點為 bigqueryreservation.googleapis.com。

啟用 API。

購買承諾使用合約

如要預留容量一段時間，可以購買承諾使用容量。這項優惠可節省費用。如要進一步瞭解特定費用，請參閱「BigQuery 定價」。

所需權限

如要建立運算資源承諾使用合約，您必須具備下列 Identity and Access Management (IAM) 權限：

  • bigquery.capacityCommitments.create，位於維護承諾使用合約擁有權的管理專案。

下列每個預先定義的 IAM 角色都包含這項權限：

  • BigQuery Admin
  • BigQuery Resource Admin

如要進一步瞭解 BigQuery 的 IAM 角色，請參閱「預先定義的角色和權限」。

建立容量承諾

承諾是區域資源。在某個區域或多區域購買的使用承諾，無法用於其他區域或多區域。承諾使用合約無法在區域之間，或區域與多區域之間移動。承諾使用合約無法在專案之間移動。

控制台

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

    前往「BigQuery」

  2. 在導覽選單中，按一下「Workload management」(工作負載管理)。

  3. 按一下「建立承諾」。

  4. 在「設定」下方：

    1. 選取位置。
    2. 在「容量模型」部分，選取容量模型。
    3. 如果選取「自動調度資源 (版本)」選項：
      1. 從「Edition」(版本) 清單中選取版本。容量承諾使用合約僅適用於 Enterprise 和 Enterprise Plus 版本。
    4. 選取「Commitment duration」(承諾使用時間長度)，指定承諾使用方案。

    5. 如果您購買年約，請選取合約到期後要生效的續訂方案：

      1. 每年續約。年約到期後，會自動續約一年。

      詳情請參閱「運算單元承諾使用合約」。

    6. 輸入要購買的運算單元數量。

    7. 點選「下一步」。

  5. 查看購買交易的費用估算。

  6. 在「確認並提交」下方：

    1. 輸入「CONFIRM」確認購買。
    2. 點按「購買」即可購買運算單元。

  7. 如要查看承諾使用合約，請按一下「View slot commitments」(查看運算單元使用承諾)。佈建完成後，要求的容量承諾使用合約會顯示綠色狀態。

首次購買容量時，系統會建立 default 預留項目。

SQL

如要建立容量承諾，請使用 CREATE CAPACITY DDL 陳述式。

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

    前往「BigQuery」

  2. 在查詢編輯器中輸入下列陳述式：

    CREATE CAPACITY
  `ADMIN_PROJECT_ID.region-LOCATION.COMMITMENT_ID`
OPTIONS (
  slot_count = NUMBER_OF_SLOTS,
  edition = EDITION,
  plan = 'PLAN_TYPE',
  renewal_plan = 'RENEWAL_PLAN_TYPE');

    替換下列內容：

    • ADMIN_PROJECT_ID：管理專案的專案 ID，該專案將保留這項承諾的使用權
    • LOCATION：承諾的位置

    • COMMITMENT_ID：承諾使用合約的 ID

      專案和位置中的名稱均不得重複。開頭和結尾必須是小寫英文字母或數字，且只能包含小寫英文字母、數字和破折號。

    • NUMBER_OF_SLOTS：要購買的運算單元數量
    • EDITION：與運算能力承諾使用合約相關聯的版本。您只能透過 Enterprise 或 Enterprise Plus 版本建立容量承諾。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
    • PLAN_TYPE：方案類型。選項為 ANNUAL 或 THREE_YEAR。
    • RENEWAL_PLAN_TYPE：續約方案類型。選項包括 NONE、ANNUAL 或 THREE_YEAR。

  3. 按一下「 執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

使用 bq mk 指令和 --capacity_commitment 旗標購買運算單元。

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --capacity_commitment=true \
    --edition=EDITION \
    --plan=PLAN_TYPE \
    --renewal_plan=RENEWAL_PLAN_TYPE \
    --slots=NUMBER_OF_SLOTS

更改下列內容：

  • ADMIN_PROJECT_ID：管理專案的專案 ID，該專案將保留這項承諾的使用權
  • LOCATION：承諾使用合約的位置
  • EDITION：與容量承諾相關聯的版本。您只能透過 Enterprise 或 Enterprise Plus 版本建立容量承諾。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
  • PLAN_TYPE：方案類型。選項為 ANNUAL 或 THREE_YEAR。
  • RENEWAL_PLAN_TYPE：續約方案類型。選項包括 NONE、ANNUAL 或 THREE_YEAR。
  • NUMBER_OF_SLOTS：要購買的運算單元數量。

查看容量承諾

以下各節說明如何查看現有的容量承諾。

所需權限

如要查看約定，您必須具備下列 Identity and Access Management (IAM) 權限：

  • bigquery.capacityCommitments.list，位於維護承諾使用合約擁有權的管理專案。

下列每個預先定義的 IAM 角色都包含這項權限：

  • BigQuery Admin
  • BigQuery Resource Admin
  • BigQuery Resource Editor
  • BigQuery Resource Viewer
  • BigQuery User

如要進一步瞭解 BigQuery 的 IAM 角色，請參閱「預先定義的角色和權限」。

依專案查看運算資源承諾使用合約

如要依專案查看運算資源承諾使用合約，請按照下列步驟操作：

控制台

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

    前往「BigQuery」

  2. 在導覽選單中，按一下「Workload management」(工作負載管理)。

  3. 按一下「運算單元使用承諾」分頁標籤。承諾使用容量會列在「承諾」下方的表格中。

SQL

如要查看管理專案的承諾使用合約，請查詢 INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT 檢視表。

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

    前往「BigQuery」

  2. 在查詢編輯器中輸入下列陳述式：

    SELECT
  capacity_commitment_id
FROM
  `region-LOCATION`.INFORMATION_SCHEMA.CAPACITY_COMMITMENTS_BY_PROJECT
WHERE
  project_id = 'ADMIN_PROJECT_ID'
  AND slot_count = 100;

    替換下列內容：

    • LOCATION：承諾使用合約的位置
    • ADMIN_PROJECT_ID：擁有承諾使用合約的管理專案 ID

  3. 按一下「 執行」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」。

bq

使用 bq ls 指令和 --capacity_commitment 旗標，列出管理專案的使用承諾。

bq ls \
    --capacity_commitment=true \
    --location=LOCATION \
    --project_id=ADMIN_PROJECT_ID

更改下列內容：

  • LOCATION：承諾使用合約的位置
  • ADMIN_PROJECT_ID：擁有承諾的管理專案專案 ID

可更新容量使用承諾

您可以對容量承諾使用合約進行下列更新：

  • 更新承諾使用合約的續約方案
  • 將承諾使用合約轉換為效期較長的承諾使用合約。
  • 將承諾使用合約分割為兩份。
  • 將兩份承諾使用合約合併為一份。

所需權限

如要更新運算資源承諾使用合約，您必須具備下列 Identity and Access Management (IAM) 權限：

  • bigquery.capacityCommitments.update，位於維護承諾使用合約擁有權的管理專案。

下列每個預先定義的 IAM 角色都包含這項權限：

  • BigQuery Admin
  • BigQuery Resource Admin

如要進一步瞭解 BigQuery 的 IAM 角色，請參閱「預先定義的角色和權限」。

續約

年約有續約方案，您可以在建立或轉換為年約時指定。您可以在承諾期限結束前，隨時變更年約方案的續訂方案。

控制台

您可以按照下列步驟，變更年約方案的續約方案：

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

    前往「BigQuery」

  2. 按一下導覽選單中的「Workload management」(工作負載管理)。

  3. 按一下 [Slot commitments] (運算單元使用承諾) 分頁標籤。

  4. 找出要編輯的約定。

  5. 按一下 「Actions」(動作)，然後選取「Edit renewal plan」(編輯續約方案) 選項。

  6. 選取新的續約方案。

bq

如要變更年約方案的續約方案選項，請使用 bq update 指令，並加上 --capacity_commitment 旗標和 --renewal_plan 旗標。

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --renewal_plan=PLAN_TYPE \
    --capacity_commitment=true \
    COMMITMENT_ID

更改下列內容：

將承諾使用合約轉換為更長期限

您隨時可以選擇將承諾轉換為承諾時間較長的類型。即使您想從舊版方案轉換為版本，也適用這項功能。

更新承諾後，系統會按照新方案的費率收費，並重設結束日期。

如要轉換約定，請使用 bq update 指令，並加上 --plan 旗標。

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --plan=PLAN_TYPE \
    --renewal_plan=RENEWAL_PLAN \
    --capacity_commitment=true \
    COMMITMENT_ID

更改下列內容：

  • ADMIN_PROJECT_ID：專案 ID
  • LOCATION：承諾使用合約的位置
  • PLAN_TYPE：方案類型，例如 ANNUAL 或 THREE_YEAR。

  • RENEWAL_PLAN：續訂方案

    只有在 PLAN_TYPE 為 ANNUAL 時，這項設定才會生效。

  • COMMITMENT_ID：承諾 ID

    如要取得 ID，請參閱「查看已購買的承諾使用合約」。

拆分承諾使用合約

您可以將承諾使用合約拆分為兩份，如果您想續訂部分約期，這項功能就非常實用。舉例來說，如果您有 1,000 個運算單元的年約承諾使用合約，可以將 300 個運算單元分割成新的承諾使用合約，原有的承諾使用合約則保留 700 個運算單元。然後以年費率續訂 700 個位置，並將 300 個位置轉換為三年期合約。承諾可分割的運算單元數量須為 50 的倍數。

分割承諾使用合約時，新合約的方案和結束日期會與原始合約相同。

控制台

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

    前往「BigQuery」

  2. 在導覽選單中，按一下「Workload management」(工作負載管理)。

  3. 按一下 [Slot commitments] (運算單元使用承諾) 分頁標籤。

  4. 選取要拆分的約定。

  5. 按一下「分割」。

  6. 在「Split commitment」(拆分承諾使用合約) 頁面中，使用「Configure split」(設定拆分) 滑桿，選取要拆分多少個運算單元 (以 50 個運算單元為單位遞增)。

  7. 按一下「Split」(分割) 即可分割承諾使用合約。新承諾使用合約會列在「運算單元承諾使用合約」分頁中。

bq

如要分割承諾使用合約，請使用 bq update 指令。

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --split \
    --slots=SLOTS_TO_SPLIT \
    --capacity_commitment=true \
    COMMITMENT_ID

更改下列內容：

  • ADMIN_PROJECT_ID：專案 ID
  • LOCATION：承諾使用合約的位置
  • SLOTS_TO_SPLIT：要從原始承諾使用合約分割到新承諾使用合約的運算單元數量

  • COMMITMENT_ID：承諾使用合約的 ID

    如要取得 ID，請參閱「查看已購買的承諾使用合約」。

合併兩份承諾使用合約

您可以將多個年約合併為一個年約。合併的承諾必須屬於相同類型 (ANNUAL 或 THREE_YEAR)。合併承諾的結束日期為原始承諾的最晚結束日期。如果任何承諾使用合約的結束日期較早，系統會將結束日期延後，並按比例收取這些運算單元的費用。

控制台

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

    前往「BigQuery」

  2. 在導覽選單中，按一下「Workload management」(工作負載管理)。

  3. 按一下 [Slot commitments] (運算單元使用承諾) 分頁標籤。

  4. 選取要合併的承諾。

  5. 按一下 [Merge] (合併)。

  6. 在「Merge commitments」(合併承諾使用合約) 頁面中，查看合併作業的詳細資料，然後按一下「Merge」(合併)。新的合併承諾使用合約會列在「Slot commitments」(運算單元承諾使用合約) 分頁中。

bq

如要將兩項承諾使用合約合併為一項，請使用 bq update 指令：

bq update \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --merge=true \
    --capacity_commitment=true \
    COMMITMENT1,COMMITMENT2

更改下列內容：

  • ADMIN_PROJECT_ID：專案 ID
  • LOCATION：承諾使用合約的位置
  • COMMITMENT1：要合併的第一個合約
  • COMMITMENT2：要合併的第二個承諾使用合約

將承諾使用合約升級至新版本

您無法直接將合約升級至新版本。舉例來說，您無法將 Enterprise 版本的約期授權升級至 Enterprise Plus 版本。請改為按照下列步驟升級約期：

  1. 建立新的承諾使用合約。選擇適當的升級版本。請注意，這項新合約的結束日期與現有合約不同。

  2. 如要取消現有承諾使用合約，請聯絡支援團隊。

承諾使用合約到期

承諾會在期限結束時失效。您無法刪除仍有效的承諾使用合約。如果續訂方案設為NONE，系統會自動刪除承諾。否則，系統會根據續約方案，以一年或三年約期續約。如要將續約方案變更為 NONE，請按照「續約承諾使用合約」中的步驟操作。

續約承諾使用合約後，「Start time」(開始時間) 的值不會變更。這是指原始承諾的開始時間。「End time」(結束時間) 的值是續約承諾使用合約的到期時間。舉例來說，假設您在 2022 年 12 月 13 日建立一項年約，並在 2023 年 12 月 13 日續約。如果您在 2023 年 12 月 14 日查看承諾使用合約詳細資料，「Start time」(開始時間) 的值會是 2022 年 12 月 13 日，「End time」(結束時間) 的值會是 2024 年 12 月 12 日。

基準運算單元一律會產生費用。如果容量承諾使用合約到期，您可能需要手動調整預留項目中的基準運算單元數量，以免產生不必要的費用。舉例來說，假設您有 1 年期方案，其中包含 100 個運算單元，且預訂了 100 個基本運算單元。合約到期，且沒有續約方案。合約到期後，您將按照即付即用費率支付 100 個基準運算單元的費用。

控管運算資源承諾使用合約的建立作業

您可以透過 IAM 拒絕政策，進一步控管可建立容量承諾的使用者。

您可以為一組或所有使用者建立拒絕政策，並設定例外狀況和條件。

舉例來說，下列政策會拒絕所有使用者建立運算資源承諾使用合約的權限，但主體「lucian@example.com」除外：

{
  "deniedPrincipals": [
    "principalSet://goog/public:all"
  ],
  "deniedPermissions": [
    "bigquery.googleapis.com/capacityCommitments.create"
  ],
  "exceptionPrincipals": [
    "principal://goog/subject/lucian@example.com"
  ]
}

接著，您可以將這項政策附加至組織，控管哪些人可以建立承諾使用合約。

請注意，這些政策的優先順序高於 IAM 角色，因此即使使用者具有 bigquery.admin 角色，除非刪除或修改政策，否則也無法建立承諾。

詳情請參閱「拒絕資源存取權」。

疑難排解承諾使用容量問題

本節說明疑難排解步驟，協助您解決 BigQuery 容量承諾相關問題。

購買的運算單元尚待處理

運算單元是依據可用容量而定。如果您購買了運算單元承諾使用合約，並透過 BigQuery 進行分配，「狀態」欄會顯示勾號。如果 BigQuery 無法立即分配要求的運算單元，「狀態」欄會持續顯示待處理狀態。您可能必須等待數小時，直到有可用的運算單元釋出。如果需要盡快取得運算單元，請嘗試下列做法：

  1. 刪除待處理的承諾使用合約。
  2. 購買新的承諾使用合約，減少運算單元數量。視容量而定，較小的承諾使用合約可能會立即生效。
  3. 以另一項承諾使用合約購買剩餘的運算單元。這些運算單元在「Status」(狀態) 欄中可能會顯示為待處理，但通常會在幾小時內啟用。
  4. 選用：兩項承諾使用合約都生效後，如果位於相同區域、版本和承諾使用合約方案，即可合併為單一承諾使用合約。

如果運算單元承諾使用合約失敗或需要很長時間才能完成，請考慮暫時使用隨選計價。您可以採用這項解決方案，在未指派給任何預留項目的其他專案中執行重要查詢、將專案指派給 None，或完全移除專案指派項目。