設定將 Cloud Billing 資料匯出至 BigQuery

本文說明設定 Cloud Billing 資料匯出至 BigQuery 的必要步驟，適用於下列類型的帳單匯出作業：

  • 標準使用費用
  • 使用費用詳細資料
  • 價格資料
  • 承諾使用折扣 (CUD) 中繼資料

如要設定匯出 FOCUS 使用費，請參閱「設定將 FOCUS Cloud Billing 資料匯出至 BigQuery」。

如要將 Cloud Billing 資料匯出至 BigQuery，請按照下列步驟操作：

  • 建立專案來儲存 Cloud Billing 資料，並為專案啟用計費功能 (如果尚未啟用)。
  • 設定專案和 Cloud Billing 帳戶的權限。
  • 啟用 BigQuery 資料移轉服務 API (匯出價格資料時必須啟用)。
  • 建立 BigQuery 資料集來儲存資料。
  • 啟用 Cloud Billing 匯出功能，將費用資料和價格資料寫入資料集。

這份文件將詳細說明每個步驟。

關於 Google Cloud 控制台

Google Cloud 控制台 (請參閱說明文件、開啟控制台) 是一個網頁版 UI，可用於佈建、設定、管理和監控使用Google Cloud 產品的系統。您可以使用 Google Cloud 控制台設定及管理 Google Cloud Cloud Billing 資源。

這項工作需要的權限

如要啟用及設定將 Google Cloud 帳單用量費用資料匯出至 BigQuery 資料集的功能，您必須具備下列權限：

  • 如要使用 Cloud Billing，您必須在目標 Cloud Billing 帳戶中，具備「帳單帳戶費用管理員」或「帳單帳戶管理員」角色。
  • 如果是 BigQuery，您需要 Google Cloud 專案的 BigQuery 使用者角色，其中包含用於儲存 Cloud Billing 資料的 BigQuery 資料集。

如要啟用及設定 Cloud Billing 定價資料和 CUD 中繼資料的匯出作業，您必須具備下列權限：

  • 如要使用 Cloud Billing，您必須具備目標 Cloud Billing 帳戶的帳單帳戶管理員角色。
  • 如果是 BigQuery，您需要 Google Cloud 專案的 BigQuery 管理員角色，其中包含用於儲存 Cloud Billing 價格資料的 BigQuery 資料集。
  • 如要存取含有目標資料集的 Google Cloud 專案，您需要resourcemanager.projects.update權限。roles/editor 角色包含這項權限。

您可能也需要其他專案權限。如果您是Google Cloud 機構的成員，則須具備該機構或資料夾的專案建立者角色，才能建立新的專案。如要建立新專案，您必須具備下列權限：

  • resourcemanager.organizations.get
  • resourcemanager.projects.create

如要進一步瞭解 Google Cloud 權限，請參閱：

啟用將 Cloud Billing 資料匯出至 BigQuery 的功能

完成本節中的五個步驟，即可啟用將 Cloud Billing 資料匯出至 BigQuery 的功能。

如要快速瞭解如何啟用帳單資料匯出功能，以及在 BigQuery 中執行 Cloud Billing 資料的範例查詢，請參閱這篇帳單資料匯出互動式教學課程。

如果您是經銷商，可以使用 Partner Sales Console，設定經銷商專屬的匯出作業，匯出 Channel Services 帳單資料。如要這麼做，請按照本頁面的步驟 1 到 4 建立專案和 BigQuery 資料集。然後參閱「將 Channel Services 資料匯出至 BigQuery」一文，啟用匯出功能。

1. 選取或建立專案

匯出至 BigQuery 的 Cloud Billing 資料會存放在 BigQuery 資料集中。資料集會存放在您指定的Google Cloud 專案中。

建議您建立及使用 Google Cloud 專案，保存 Cloud Billing 帳戶的所有 FinOps 和帳單管理必要元件，包括匯出的 Cloud Billing 資料。進一步瞭解使用以 FinOps 為主的專案，對帳單管理用途有何好處。

在 Google Cloud 控制台的專案選擇器頁面中，選取或建立 Google Cloud 專案。

選取或建立專案所需的角色

  • 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
  • 建立專案：如要建立專案，您需要「專案建立者」角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

前往專案選取器

進一步瞭解如何建立及管理專案。

2. 確認已啟用計費功能

請務必確認您選取用來存放資料集的 Google Cloud 專案已啟用帳單功能，且該 Google Cloud 專案連結至同一個 Cloud Billing 帳戶，其中包含您打算匯出至 BigQuery 資料集的資料。

3. 啟用 BigQuery 資料移轉服務 API

如果您打算將 Cloud Billing 定價資料匯出至 BigQuery，請啟用 BigQuery 資料移轉服務 API。如果您不打算匯出 Cloud Billing 定價資料，請跳至 步驟 4：建立 BigQuery 資料集。

您應在用於存放 BigQuery 資料集的 Google Cloud 專案中，啟用 BigQuery Data Transfer Service API。如果您已按照專案部分的建議操作，這個專案就是您的 FinOps 或帳單管理 Google Cloud 專案。

如要啟用 BigQuery 資料移轉服務 API，請按照下列步驟操作：

  1. 登入 Google Cloud 控制台，然後前往 API 頁面。

    前往 BigQuery 資料移轉服務 API 頁面

  2. 選取頁面左上方的專案。您必須在用於存放 BigQuery 資料集的專案中，啟用 BigQuery 資料移轉服務 API。如果您已按照專案部分的建議操作，這個專案就是您的 FinOps 或帳單管理 Google Cloud 專案。

  3. 在「BigQuery 資料移轉服務 API」頁面上，按一下「啟用」，在所選專案中啟用 API。

如要進一步瞭解如何啟用 API，請參閱服務使用情形說明文件。

4. 建立 BigQuery 資料集

啟用 Cloud Billing 資料匯出至 BigQuery 前，您必須建立至少一個 BigQuery 資料集，以便管理匯出的資料。您可以使用同一個資料集，存放標準使用費用資料、詳細使用費用資料和定價資料。

資料集會包含在您指定的 Google Cloud 專案中。資料集是頂層容器，可用來整理及控管資料表和檢視表的存取權。資料表或檢視表必須屬於資料集，因此您需要建立至少一個資料集，才能將資料載入 BigQuery。

如果您使用現有資料集，請查看限制，瞭解可能影響帳單資料匯出至 BigQuery 的因素，例如無法將資料匯出至設為使用客戶管理金鑰加密的資料集，或是無法使用設為不支援區域位置的資料集。

如要建立 BigQuery 資料集，請按照下列步驟操作：

  1. 登入 Google Cloud 控制台，然後前往「BigQuery」BigQuery頁面。

    前往 BigQuery 頁面

  2. 在 Google Cloud 控制台頁面頂端的「project」下拉式清單 (「My Project」) 中，選取您設定的專案，其中包含您的資料集。請記下專案 ID，您會在後續步驟中使用該 ID。

  3. 在「Explorer」面板的「pinned projects」(已釘選的專案) 區段中，按一下「your-project-ID」展開專案，即可查看現有資料集和已儲存的查詢。

  4. 點選專案 ID 旁的「查看動作」選單 ()，然後點選「建立資料集」。「建立資料集」面板隨即開啟。

    1. 輸入資料集 ID。建議使用跨專案的 ID，例如 all_billing_data，而非專案專屬 ID。

    2. 選取「資料位置」。資料位置會指定儲存資料的多區域或區域。這個資料集內的所有資料表都會儲存於這個位置。

      建議選取多區域位置 (歐盟或美國)。匯出標準使用費用和詳細使用費用資料時，選取的位置可能會影響上個月的資料是否會追溯新增至資料集。如要進一步瞭解資料集位置和資料可用性，請參閱限制。

      Cloud 帳單匯出功能支援所有 多區域位置 (歐盟或美國)。不過，只有部分資料集區域位置支援將 Cloud 帳單匯出至 BigQuery。如要進一步瞭解資料集位置，請參閱限制。

      建立資料集後，無法變更位置。 進一步瞭解地點。

    3. 確認已取消勾選「Enable table expiration」(啟用資料表到期時間) 選項。

      如果啟用資料表到期時間並輸入天數，系統就會在資料表建立後經過指定天數時，自動刪除該資料集內建立的所有新資料表。

    4. 在「Advanced options」(進階選項) 區段中，選取「Encryption」(加密) 設定。

      預設選項為 Google-managed encryption key。

      如要使用客戶自行管理的加密金鑰，請選取「客戶自行管理的加密金鑰 (CMEK)」，然後選擇加密金鑰。

      進一步瞭解將 Cloud Billing 資料匯出至 BigQuery 時，資料集加密的限制。

    5. 如要儲存，請按一下「建立資料集」。

請參閱限制，瞭解可能影響帳單資料匯出至 BigQuery 的因素。

如果您是經銷商，可以重複使用剛才建立的專案和資料集，啟用經銷商專用的 Channel Services 帳單資料匯出功能。

5. 啟用 Cloud Billing 資料匯出至 BigQuery 資料集

您可以在 Google Cloud 控制台的 Cloud Billing 專區啟用 Cloud Billing 資料匯出功能。您可以啟用匯出下列類型的資料：

  • FOCUS 使用費用資料 (搶先版) - 使用 Google 提供的不可變更 BigQuery 資料集，內含根據 FinOps 開放成本與使用規格 (FOCUS) 標準正規化的詳細使用費用資料。如要啟用 FOCUS 使用費用匯出功能，請按照「設定 FOCUS Cloud Billing 資料匯出至 BigQuery」一文中的指引操作。

  • 標準使用費用資料 - 包含標準 Cloud Billing 帳戶費用使用資訊，例如帳戶 ID、月結單日期、服務、SKU、專案、標籤、位置、費用、用量、抵免額、調整項和幣別。

    使用標準用量匯出功能，分析費用資料的廣泛趨勢。

  • 詳細用量費用資料 - 包含詳細的 Cloud Billing 帳戶費用用量資訊。 包含標準使用費用資料中的所有項目，以及資源層級的費用資料，例如產生服務用量的虛擬機器或 SSD。

    您可以使用詳細資料匯出功能，分析資源層級的費用，並找出可能增加費用的特定資源。

    詳細匯出內容會自動納入 Compute Engine 的資源層級資訊。如要在詳細資料匯出內容中查看 Google Kubernetes Engine (GKE) 叢集費用的明細，您也必須啟用 GKE 的費用分配功能。

  • 價格資料 - 包含 Cloud Billing 帳戶價格資訊，例如帳戶 ID、服務、SKU、產品、地理位置中繼資料、價格單位、幣別、匯總和層級。

  • 承諾使用折扣 (CUD) 中繼資料 (預先發布版) - 內含 Cloud Billing CUD 中繼資料資訊，例如帳單帳戶 ID、CUD 產品 ID、CUD 產品類型、計費模式 ID 和說明、訂閱執行個體 ID、訂閱授權範圍、承諾使用金額和期限。如需匯出欄位清單，請參閱「CUD 中繼資料匯出結構」。

    才能順利啟用 CUD 中繼資料匯出功能。

如要啟用將 Cloud Billing 資料匯出至 BigQuery 的功能，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「帳單匯出」頁面。

    前往「匯出帳單」頁面

  2. 在系統提示時選擇要匯出帳單資料的 Cloud Billing 帳戶。系統會開啟所選帳單帳戶的「匯出帳單」頁面。

  3. 在「BigQuery 匯出」分頁中，針對要匯出的每種資料類型，按一下「啟用『[資料類型]』匯出功能」。每種資料匯出類型都必須個別設定。

  4. 在「專案」清單中，選取您設定的專案，該專案包含BigQuery 資料集。

    您選取的專案會用於在 BigQuery 資料集中儲存匯出的資料。

    匯出標準和詳細使用費用資料時，Cloud Billing 資料會包含所有 Google Cloud 由相同 Cloud Billing 帳戶支付費用的專案使用和費用資料。

    如要匯出定價資料，Cloud Billing 資料只會包含與所選資料集專案連結的 Cloud Billing 帳戶專屬定價資料。

    如要匯出 CUD 中繼資料，匯出的資料會包含與帳單帳戶連結的所有專案中，購買的所有 CUD 中繼資料。

    才能順利啟用 CUD 中繼資料匯出功能。

  5. 從「資料集 ID」欄位中，選取您設定的資料集，以納入匯出的 Cloud Billing 資料。

    將所有類型的 Cloud Billing 資料匯出至 BigQuery 時，適用下列事項：

    • 您必須啟用 BigQuery API，才能將資料匯出至 BigQuery。如果所選專案未啟用 BigQuery API，系統會提示您啟用。按一下「啟用 BigQuery API」即可啟用。
    • 如果所選專案不含任何 BigQuery 資料集，系統會提示您建立資料集。視需要按照下列步驟建立新資料集。
    • 如果使用現有資料集，請查看限制，瞭解可能影響帳單資料匯出至 BigQuery 的因素，例如無法將資料匯出至設定為不支援區域位置的資料集。

    如要匯出定價資料，必須使用 BigQuery 資料移轉服務 API 將資料匯出至 BigQuery。如果所選專案未啟用 BigQuery 資料移轉服務 API，系統會提示您啟用。如有需要，請按照這些步驟啟用 API。

  6. 按一下 [儲存]。

更新要匯出的 Cloud Billing 資料

啟用將 Cloud Billing 資料匯出至 BigQuery 的功能後，您就可以變更各種資料匯出設定，例如：

  • 如要變更匯出帳單資料的儲存位置，請編輯匯出設定。
  • 如要變更匯出的帳單資料類型，請停用或啟用不同類型。

更新帳單資料的儲存專案或資料集，或停用任何資料匯出作業前，請先參閱限制和資料可用性指南，瞭解這些更新對匯出至 BigQuery 的帳單資料有何影響。

停用特定類型的帳單資料匯出功能

如要停用將某類 Cloud Billing 資料匯出至 BigQuery 的功能，請按照下列步驟操作：

  1. 視情況選取「停用標準匯出功能」、「停用詳細匯出功能」、「停用定價匯出功能」或「停用 CUD 匯出功能」。
  2. 選取「確認」即可儲存所選項目。

啟用某種帳單資料匯出功能

如要重新啟用已停用的 Cloud Billing 資料匯出至 BigQuery 功能，請參閱「啟用將 Cloud Billing 資料匯出至 BigQuery 的功能」。

變更帳單資料匯出作業的專案或資料集

如要更新儲存匯出帳單資料的專案或資料集，請按照下列步驟操作：

  1. 針對要更新的匯出作業，選取「啟用『[資料類型]』匯出功能」。
  2. 在「BigQuery 匯出設定」頁面中，選擇其他專案或資料集。
  3. 選取「儲存」，確認更新。

關於資料集權限

將 Cloud Billing 資料匯出至 BigQuery 後，系統會透過服務帳戶管理資料集權限。

在您設定好將 Cloud Billing 資料匯出至 BigQuery 後，Google 會自動新增服務帳戶並指派為所選資料集的擁有者。服務帳戶如下所示：

  • 針對 FOCUS、標準和詳細使用費用資料集： billing-export-bigquery@system.gserviceaccount.com
  • 價格資料集： cloud-account-pricing@cloud-account-pricing.iam.gserviceaccount.com

這些服務帳戶由 Google 擁有及管理，並會提供必要權限，以便在離線程序中建立資料表並寫入 Cloud Billing 記錄。

請參閱限制，瞭解可能影響帳單資料匯出至 BigQuery 的因素。

帳單資料表

啟用 Cloud Billing 匯出至 BigQuery 功能後不久，系統就會在 BigQuery 資料集中自動建立帳單資料表。如要進一步瞭解這些 BigQuery 資料表和資料表結構定義，請參閱「瞭解 BigQuery 中自動建立的資料表」。

資料載入頻率

  • FOCUS
  • 首次啟用「價格」匯出至 BigQuery 功能後，您可能需要等待最多 48 小時，才會開始看到 Google Cloud 價格資料。

進一步瞭解資料載入 BigQuery 資料表的頻率。

限制

將 Cloud Billing 資料匯出至 BigQuery 時，會受到下列限制。

Cloud Billing 資料匯出的資料表結構定義

任何 Cloud Billing 資料匯出的資料表結構定義都可能變更。

如果資料表結構定義有所變更 (例如為 Cloud Billing 資料匯出新增 BigQuery 資料表結構定義的欄位)，任何直接參照匯出欄位的查詢都可能會失敗。為解決這個問題，建議您建立 BigQuery 檢視區塊，查詢匯出的資料表，並以偏好的結構呈現資訊。

接著，您可以調整提供報表和資訊主頁資料的查詢，從檢視畫面而非匯出的資料表擷取資料。使用檢視區塊，即可將查詢和資訊主頁中使用的資料結構標準化。

您建立的檢視區塊應將資料正規化，讓所有相關資料表都向查詢呈現相同的結構定義。這樣一來，您就不會受到日後結構定義變更的影響，並可在資料結構定義變更時，修改檢視區塊的基礎查詢。

FOCUS 匯出和資料保留

以 Google 提供的 FOCUS 格式匯出至 BigQuery 的帳單資料適用 2 年存留時間 (TTL) 政策，超過 2 年的資料會自動從 BigQuery 資料集提供的 FOCUS 匯出資料表中刪除。如要將 FOCUS 帳單資料記錄保留超過 2 年，請將 FOCUS 資料複製到您擁有的長期儲存資料表。

BigQuery 資料集位置和資料可用性

可搭配 Cloud Billing 資料使用的 BigQuery 資料集位置：

BigQuery 資料集會設定為使用位置，可以是多區域位置 (歐盟或美國)，也可以是區域位置。資料集位置是在建立時設定，建立後就無法變更。

Cloud Billing 資料匯出功能支援所有多區域位置 (歐盟或美國)，但僅支援部分區域位置。設定 Cloud Billing 匯出設定時，如果建立或選取的資料集設定為使用不支援的區域位置，嘗試儲存匯出設定時，系統會顯示「無效的資料集區域」錯誤。

下表列出支援用於含有 Cloud Billing 資料的 BigQuery 資料集的多區域位置，以及區域位置。

美洲 亞太地區 歐洲 中東

多區域：美國

區域：

  • northamerica-northeast1 (蒙特婁)
  • southamerica-east1 (聖保羅)
  • us-central1 (愛荷華州)
  • us-east1 (南卡羅來納州)
  • us-east4 (北維吉尼亞州)
  • us-west1 (奧勒岡州)
  • us-west2 (洛杉磯)
  • us-west3 (鹽湖城)
  • us-west4 (拉斯維加斯)

區域：

  • asia-east1 (台灣)
  • asia-east2 (香港)
  • asia-northeast1 (東京)
  • asia-northeast2 (大阪)
  • asia-northeast3 (首爾)
  • asia-south1 (孟買)
  • asia-southeast1 (新加坡)
  • asia-southeast2 (雅加達)
  • australia-southeast1 (雪梨)

多區域：歐盟

區域：

  • europe-central2 (華沙)
  • europe-north1 (芬蘭)
  • europe-west1 (比利時)
  • europe-west2 (倫敦)
  • europe-west3 (法蘭克福)
  • europe-west4 (荷蘭)
  • europe-west6 (蘇黎世)

區域：

  • me-central1 (杜哈)
  • me-central2 (達曼)
  • me-west1 (特拉維夫)

地點和資料可用性：

  • 對於包含 FOCUS 用量費用資料、標準用量費用資料或詳細用量費用資料的 BigQuery 資料集，您在資料集上設定的位置類型會影響時間，也就是 Google Cloud 帳單資料 Google Cloud 匯出至資料集的時間：

    • 如果您將資料集設定為使用多區域位置 (歐盟或美國)，資料集會包含 Google Cloud 從您首次啟用匯出功能起，上個月初產生的帳單資料，除非您重新啟用匯出功能。也就是說，Google Cloud 系統會追溯新增目前和上個月的帳單資料。首次回填匯出資料時，系統可能需要最多五天才能完成追溯匯出 Cloud Billing 資料，之後您才會開始看到目前的用量資料。

    • 如果資料集設定為使用支援的區域位置，則FOCUS 費用資料、標準費用資料和詳細費用資料只會反映 Google Cloud 您啟用 Cloud Billing 匯出功能當日起的帳單資料。也就是說， Google Cloud 系統不會追溯新增非多區域資料集位置的帳單資料，因此您不會看到啟用匯出功能前的 Cloud Billing 資料。

    • 詳情請參閱「資料可用性」。

  • 包含定價資料的 BigQuery 資料集只會收集您設定 Cloud Billing 匯出功能當日起的帳單資料。也就是說，Google Cloud 系統不會溯及過往的定價資料，因此您不會看到啟用匯出功能之前的 Cloud Billing 定價資料。詳情請參閱「資料可用性」。 Google Cloud

停用、重新啟用或編輯匯出設定

如果您停用、重新啟用或編輯匯出設定，更新匯出帳單資料的儲存專案或資料集，系統不會將先前匯出的帳單資料回填至新資料集。如要納入切換至其他專案或資料集前匯出的帳單資訊，請務必手動將新資料集與先前的資料集合併。詳情請參閱彙整作業。

資料集加密

BigQuery 資料集設定為使用靜態資料加密，方法是在建立資料集時設定加密金鑰選項，也就是 Google-owned and Google-managed encryption key或客戶自行管理的加密金鑰 (CMEK)。資料集加密選項只能在建立時設定。 資料集建立後，就無法變更加密設定。

如果您已啟用 Cloud Billing 資料匯出至 BigQuery 的功能，且資料集已設定為使用Google-managed encryption key，則可以使用 bq 指令列工具，在資料集中的每個資料表上啟用 CMEK。除非您另行設定，否則 BigQuery 會自動使用資料集預設金鑰保護匯出資料表。

瞭解如何為 BigQuery 資料表啟用 CMEK。

資料列層級安全防護機制

如要在包含匯出資料的資料表上使用 BigQuery 資料列層級安全性，請使用 BigQuery TRUE 篩選器，授予 Cloud Billing 匯出服務帳戶 billing-export-bigquery@system.gserviceaccount.com 該資料表的完整存取權。下列指令會授予 Cloud Billing 服務帳戶存取權：

CREATE ROW ACCESS POLICY cloud_billing_export_policy
ON `__project_id__.__dataset_id__.__table_id__`
GRANT TO ('serviceAccount:billing-export-bigquery@system.gserviceaccount.com')
FILTER USING (TRUE);

採用 FOCUS 格式或詳細的費用資料和 GKE

匯出 FOCUS 使用費用資料或使用費用詳細資料時，匯出內容會自動納入 Compute Engine 和其他服務的資源層級資訊。不過，如要查看 FOCUS 或詳細資料匯出內容中 GKE 叢集費用的明細，您也必須啟用 GKE 的費用分配功能。

資源層級標記

資源層級標記最多可能需要一小時，才會傳播至 BigQuery 匯出作業。如果標記是在一小時內新增或移除，或是資源存在時間未滿一小時，可能不會顯示在匯出檔案中。

在標準使用費用匯出和詳細使用費用匯出中，有幾項資源提供資源層級標記。

上一頁
將帳單資料匯出至 BigQuery 總覽
下一頁
設定將 FOCUS 匯出至 BigQuery