Stay organized with collectionsSave and categorize content based on your preferences.
This document provides reference information for the schema of
Cloud Billing committed use discount (CUD) metadata that's exported
daily to each table in BigQuery. This export provides a daily
snapshot of yourspend-based CUDscommitment metadata to a BigQuery table,
which you can join with other billing data exports for better CUD management
and reporting.
Schema of the CUD export data
In your BigQuery dataset, your Cloud Billing account
CUD data is loaded into a data table namedcud_subscriptions_export.
The following information describes the schema of the data that's exported to
BigQuery.
state
String
The state of the commitment, for exampleActiveorExpired.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Structure of CUD metadata export\n\n\u003cbr /\u003e\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis document provides reference information for the schema of\nCloud Billing committed use discount (CUD) metadata that's exported\ndaily to each table in BigQuery. This export provides a daily\nsnapshot of your\n[*spend-based CUDs*](/docs/cuds-spend-based)\ncommitment metadata to a BigQuery table,\nwhich you can join with other billing data exports for better CUD management\nand reporting.\n\nSchema of the CUD export data\n-----------------------------\n\nIn your BigQuery dataset, your Cloud Billing account\nCUD data is loaded into a data table named `cud_subscriptions_export`.\n\nThe following information describes the schema of the data that's exported to\nBigQuery.\n\nRelated topics\n--------------\n\n### Topics related to exported Cloud Billing data\n\n- [Set up Cloud Billing data export to BigQuery](/billing/docs/how-to/export-data-bigquery-setup)\n- [Example queries for Cloud Billing data export to BigQuery](/billing/docs/how-to/bq-examples)\n- [Visualize spend over time with Looker Studio](/billing/docs/how-to/visualize-data)\n\n### Cost and pricing reports available in the Google Cloud console\n\n- [View your Cloud Billing reports and cost trends](/billing/docs/how-to/reports)\n- [View and download the cost details of your invoice or statement](/billing/docs/how-to/cost-table)\n- [View and download prices for Google's cloud services](/billing/docs/how-to/pricing-table)\n- [Understand your savings with cost breakdown reports](/billing/docs/how-to/cost-breakdown)\n- [Analyze the effectiveness of your committed use discounts](/billing/docs/how-to/cud-analysis)\n- [View your cost and payment history](/billing/docs/how-to/view-history)"]]
