Struttura dell'esportazione dei dati standard

Questa pagina fornisce informazioni di riferimento per lo schema dei dati di costo di utilizzo standard di Cloud Billing esportati in ogni tabella di BigQuery.

Schema dei dati di costo per l'utilizzo standard

Nel set di dati BigQuery, il tuo ambiente Google Cloud i dati del costo di utilizzo vengono caricati in una tabella di dati denominata gcp_billing_export_v1_<BILLING_ACCOUNT_ID>.

Le seguenti informazioni descrivono lo schema dei dati di costo di utilizzo standard di Google Cloud esportati in BigQuery. Contiene informazioni standard sull'utilizzo dei costi dell'account di fatturazione Cloud, come ID account, data della fattura, servizi, SKU, progetti, etichette, località, costo, utilizzo, crediti, aggiustamenti e valuta.

Quando utilizzi i dati di costo per l'utilizzo standard in BigQuery, tieni presente che le seguenti:

  • Quando selezioni o crei un set di dati BigQuery per i dati di costo di utilizzo standard, puoi selezionare qualsiasi posizione del set di dati supportata per l'utilizzo con i dati della fatturazione Cloud.
  • Quando attivi l'esportazione dei dati di costo per l'utilizzo standard per la prima volta nella fatturazione Cloud, se selezioni un set di dati configurato per utilizzare località multiregionale (UE o USA), i dati di fatturazione Cloud saranno disponibili retroattivamente dall'inizio del mese precedente. I dati vengono esportati in ordine cronologico. Per il backfill iniziale dei dati esportati, potrebbero essere necessari fino a 5 giorni dei dati di fatturazione Cloud retroattivi per completare l'esportazione prima di iniziare visualizzare i dati sull'utilizzo più recenti.
  • Se attivi l'esportazione dei dati di costo di utilizzo standard e selezioni un set di dati configurato per utilizzare una località della regione supportata, i dati di fatturazione Cloud saranno disponibili a partire dalla data in cui hai attivato l'esportazione.
  • Se hai attivato, disattivato e successivamente riattivato l'esportazione dei dati di costo di utilizzo standard, i dati di fatturazione Cloud potrebbero non essere disponibili per il periodo in cui l'esportazione dei dati è stata disattivata esplicitamente.
  • Scopri di più sulla frequenza dei caricamenti dei dati nelle tabelle BigQuery.
  • I dati di costo per l'utilizzo standard non includono i costi a livello di risorsa ad esempio una macchina virtuale o un'unità SSD che genera l'utilizzo del servizio. Se ti interessa esportare i dati di costo a livello di risorsa in BigQuery per l'analisi, valuta la possibilità di abilitare l'esportazione dati dettagliati sui costi di utilizzo. I dati di costo di utilizzo dettagliati esportati includono tutti i campi e le informazioni contenuti nei dati di costo di utilizzo standard.
  • Vedi altro limitazioni che potrebbero influire sull'esportazione dei dati di fatturazione in BigQuery come i set di dati con chiavi di crittografia gestite dal cliente (CMEK).
Campo Tipo Descrizione
billing_account_id Stringa

L'ID account di fatturazione Cloud a cui è associato l'utilizzo.

Per i rivenditori: per i costi di utilizzo generati da un subaccount di fatturazione Cloud, si tratta dell'ID del subaccount, non dell'ID dell'account di fatturazione Cloud del rivenditore principale.
invoice.month Stringa

L'anno e il mese (AAAAMM) della fattura che include le voci relative ai costi. Ad esempio, "201901" equivale a gennaio 2019.

Puoi utilizzare questo campo per conoscere gli addebiti totali sulla fattura. Consulta Esempi di query per l'esportazione della fatturazione Cloud in BigQuery.
cost_type Stringa

Il tipo di costo rappresentato da questa voce: normale, fiscale, aggiustamento o di arrotondamento.
service.id Stringa L'ID del servizio a cui è associato l'utilizzo.
service.description Stringa Il servizio Google Cloud che ha registrato i dati di fatturazione Cloud.
sku.id Stringa L'ID della risorsa utilizzata dal servizio. Per l'elenco completo degli SKU, consulta SKU di Google Cloud.
sku.description Stringa Una descrizione del tipo di risorsa utilizzata dal servizio. Ad esempio, un il tipo di risorsa per Cloud Storage è Standard Storage US.
usage_start_time Timestamp L'ora di inizio dell'intervallo di utilizzo orario in cui è stato calcolato il costo specificato. L'utilizzo e i costi di tutti i servizi sono visualizzati con granularità oraria, il che significa che l'utilizzo dei servizi a lunga esecuzione è distribuito su più intervalli orari.

Per ulteriori informazioni, consulta la documentazione di BigQuery sui tipi di dati timestamp. Vedi anche Le differenze tra i dati esportati e le fatture riportate di seguito.
usage_end_time Timestamp L'ora di fine dell'intervallo di utilizzo orario in cui è stato calcolato il costo specificato. L'utilizzo e i costi di tutti i servizi sono visualizzati con granularità oraria, il che significa che l'utilizzo dei servizi a lunga esecuzione è distribuito su più intervalli orari.

Per ulteriori informazioni, consulta la documentazione di BigQuery sui tipi di dati timestamp. Vedi anche Le differenze tra i dati esportati e le fatture riportate di seguito.
project Struct project contiene campi che descrivono Progetto di fatturazione Cloud, ad esempio ID, numero, nome, numeri_antenati, ed etichette.
project.id Stringa L'ID del progetto Google Cloud che ha generato Dati di fatturazione Cloud.
project.number Stringa Un identificatore univoco e anonimizzato, generato internamente per il progetto Google Cloud che ha generato i dati di fatturazione Cloud. Nelle richieste di assistenza e in altre comunicazioni con i clienti, Google farà riferimento alle i tuoi progetti in base al numero di progetto.
project.name Stringa Il nome del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.ancestry_numbers Stringa I predecessori nella gerarchia di risorse del progetto identificati dal valore di project.id specificato (ad esempio, progetto-123).

Ad esempio: /ParentOrgNumber/ParentFolderNumber/. Scopri di più informazioni su Gerarchia delle risorse.
project.ancestors Struct

Questo campo descrive la struttura e il valore della gerarchia delle risorse di una voce di costo, inclusi progetti, cartelle e organizzazioni. I predecessori sono in ordine dal nodo alla radice (progetto, cartella, quindi organizzazione).

project.ancestors.resource_name Stringa Il nome della risorsa relativa per ogni antenato nel formato "resourceType/resourceNumber". L'utilizzo di project.ancestors.resource_name offre una visione più completa project.ancestry_numbers.
project.ancestors.display_name Stringa Il nome che hai creato per la risorsa nella console.
project.labels.key Stringa Se sono presenti etichette, la parte relativa alla chiave della coppia chiave-valore che comprende l'etichetta nel progetto Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'uso delle etichette, consulta Utilizzare le etichette.
project.labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta nel progetto Google Cloud in cui l'utilizzo si è verificato un errore. Per saperne di più sull'uso delle etichette, vedi Utilizzare le etichette.
labels.key Stringa Se sono presenti etichette, la parte relativa alla chiave della coppia chiave-valore che comprende l'etichetta nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni sull'uso delle etichette, vedi Utilizzo delle etichette.
labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per saperne di più sull'uso delle etichette, vedi Utilizzare le etichette.
system_labels.key Stringa Se sono presenti etichette di sistema, la parte relativa alla chiave della coppia chiave-valore che comprende l'etichetta generata dal sistema nella risorsa in cui si è verificato l'utilizzo. Vedi anche Etichette di sistema disponibili.
system_labels.value Stringa Se sono presenti etichette di sistema, la parte relativa al valore della coppia chiave-valore che comprende l'etichetta generata dal sistema nella risorsa in cui si è verificato l'utilizzo. Vedi anche Etichette di sistema disponibili.
location.location Stringa Località di utilizzo a livello di più regioni, paesi, regioni o zone. o global per che non hanno una località specifica. Per ulteriori informazioni, consulta Geografia e regioni e Località Google Cloud.
location.country Stringa Quando location.location è un paese, una regione o una zona, questo campo corrisponde al paese di utilizzo, ad esempio US. Per ulteriori informazioni, vedi Area geografica e regioni e delle località di Google Cloud.
location.region Stringa Se location.location è una regione o una zona, questo campo è la regione di utilizzo, ad esempio us-central1. Per ulteriori informazioni, consulta Geografia e regioni e Località Google Cloud.
location.zone Stringa Se location.location è una zona, questo campo è la zona di di utilizzo, ad esempio us-central1-a. Per ulteriori informazioni, vedi Area geografica e regioni e delle località di Google Cloud.
cost Numero in virgola mobile Il costo dell'utilizzo prima di applicare eventuali crediti, con una precisione massima di sei posizioni decimali. Per ottenere il costo totale inclusi i crediti, è necessario aggiungere credits.amount al costo. Per ulteriori informazioni, consulta questa query di esempio.
currency Stringa La valuta in cui viene addebitato il costo. Per ulteriori informazioni, consulta Valuta locale per fatturazione e pagamenti.
currency_conversion_rate Numero in virgola mobile Il tasso di cambio dai dollari statunitensi alla valuta locale. Vale a dire che cost ÷ currency_conversion_rate è il costo in dollari statunitensi.
usage.amount Numero in virgola mobile La quantità di usage.unit utilizzata.
usage.unit Stringa L'unità base in cui viene misurato l'utilizzo delle risorse. Ad esempio, la base per l'archiviazione standard è byte-secondi.
usage.amount_in_pricing_units Numero in virgola mobile La quantità di usage.pricing_unit utilizzata.
usage.pricing_unit Stringa L'unità in cui viene misurato l'utilizzo delle risorse in base all' API Cloud Billing Catalog.
credits Struct credits contiene campi che descrivono la struttura e valore dei crediti associati a Google Cloud e Google Maps SKU della piattaforma.
credits.id Stringa Se presente, indica che un credito è associato allo SKU prodotto. I valori credits.id sono un identificatore univoco alfanumerico (ad es. 12-b34-c56-d78) o una descrizione del tipo di credito (ad esempio Sconto per impegno di utilizzo: CPU).

Se il campo credits.id è vuoto, lo SKU prodotto non è associato a un credito.
credits.full_name Stringa Il nome del credito associato allo SKU prodotto. Si tratta di un descrizione leggibile di un credits.id alfanumerico. Alcuni esempi sono Credito per la prova gratuita o Sconto per impegno di utilizzo basato sulla spesa.

I valori credits.full_name sono presenti solo per gli SKU con uncredits.id alfanumerico. Se il valore del parametro credits.id indica il tipo di credito (ad esempio, Sconto per impegno di utilizzo: CPU), il valore Il campo credits.full_name sarà vuoto.

credits.type Stringa Questo campo descrive lo scopo o l'origine di credits.id. I tipi di credito includono:
  • COMMITTED_USAGE_DISCOUNT: Contratti per impegno di utilizzo basati sulle risorse acquistati per Compute Engine in cambio di prezzi molto scontati per le VM all'utilizzo delle risorse.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratti per impegno di utilizzo basati sulla spesa acquistati per servizi in cambio per l'impegno a spendere un importo minimo.
  • DISCOUNT: questo tipo di credito viene utilizzato per i crediti guadagnati al raggiungimento di una soglia di spesa contrattuale. Tieni presente che, nei report di fatturazione Cloud disponibili in console Google Cloud, il tipo di credito sconto è indicato come Sconti basati sulla spesa (contrattuali).
  • FREE_TIER: alcuni servizi offrono l'utilizzo senza costi delle risorse fino ai limiti specificati. Per questi servizi, vengono applicati per implementare l'utilizzo del livello gratuito.
  • PROMOTION: questo tipo di credito include una prova gratuita di Google Cloud e crediti per le campagne di marketing oppure altri contributi per l'utilizzo di Google Cloud. Se disponibili, i crediti promozionali sono considerate una forma di pagamento e vengono applicate automaticamente per ridurre l'importo totale della fattura.
  • RESELLER_MARGIN: se sei un rivenditore, rivenditore il tipo di credito margin indica gli sconti del Programma per rivenditori guadagnati per ogni elemento pubblicitario idoneo.
  • SUBSCRIPTION_BENEFIT: crediti guadagnati con l'acquisto abbonamenti a lungo termine a servizi in cambio di sconti.
  • SUSTAINED_USAGE_DISCOUNT: gli sconti per utilizzo sostenuto tipo di credito è uno sconto automatico che guadagni per l'esecuzione di le risorse di Compute Engine per una parte significativa mese di fatturazione.
credits.name Stringa Una descrizione del credito applicato all'account di fatturazione Cloud.
credits.amount Numero in virgola mobile L'importo del credito applicato all'utilizzo.
adjustment_info Struct adjustment_info contiene campi che descrivono la struttura e il valore di un aggiustamento alle voci di costo associate a un account di fatturazione Cloud.

I valori adjustment_info sono presenti solo se la voce di costo è stata generata in seguito a una modifica della fatturazione Cloud. Può verificarsi una modifica per motivi di correzione o non correzione. Il tipo adjustment_info contiene i dettagli sull'aggiustamento, se è stato emesso per correggere un errore o per altri motivi.

adjustment_info.id Stringa Se presente, indica che un aggiustamento è associato a una riga di costo. molto utile. adjustment_info.id è l'ID univoco per tutti gli aggiustamenti causati da un problema.
adjustment_info.description Stringa Una descrizione dell'aggiustamento e della relativa causa.
adjustment_info.type Stringa

Il tipo di aggiustamento.

I tipi includono:

  • USAGE_CORRECTION: una correzione dovuta a una segnalazione errata all'utilizzo delle risorse.
  • PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo scorrette.
  • METADATA_CORRECTION: una correzione per correggere i metadati senza modificare il costo.
  • GOODWILL: un credito emesso per il cliente per l'avviamento.
  • SALES_BASED_GOODWILL: un credito emesso per il cliente per l'avviamento nell'ambito di un contratto.
  • SLA_VIOLATION: un credito emesso per il cliente a causa di una violazione di un obiettivo del livello di servizio (SLO).
  • BALANCE_TRANSFER: un aggiustamento per trasferire fondi da un account pagamenti a un altro.
  • ACCOUNT_CLOSURE: un aggiustamento per rendere un account chiuso a un saldo pari a zero.
  • GENERAL_ADJUSTMENT: una modifica generale all'account di fatturazione.
adjustment_info.mode Stringa

Modalità di emissione dell'aggiustamento,

Le modalità includono:

  • PARTIAL_CORRECTION: la correzione annulla parzialmente l'utilizzo e il costo originali.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: la correzione annulla completamente l'utilizzo e il costo originali ed emette le voci corrette con utilizzo e costo aggiornati.
  • COMPLETE_NEGATION: la correzione annulla completamente il l'utilizzo e i costi originali e nessun ulteriore utilizzo viene rimonetizzato.
  • MANUAL_ADJUSTMENT: l'aggiustamento è assegnato al costo e utilizzo manuale.
export_time Timestamp Tempo di elaborazione associato a un'aggiunta di dati di fatturazione Cloud. Questo valore aumenterà sempre a ogni nuova esportazione.
Vedi anche Differenze tra i dati esportati e le fatture di seguito.
tags Struct

Campi che descrivono il tag, ad esempio chiave, valore e spazio dei nomi.
tags.key Stringa

Il nome breve o il nome visualizzato della chiave associata a questo determinato tag.
tags.value Stringa

Le risorse associate a un tags.key. In un determinato momento, a una risorsa per una determinata chiave può essere associato esattamente un valore.
tags.inherited Booleano

Indica se un'associazione di tag è ereditata (Tags Inherited = True) o diretta/non ereditata (Tags Inherited = False). Puoi creare un'associazione di tag a una risorsa principale nella gerarchia delle risorse.
tags.namespace Stringa

Rappresenta la gerarchia delle risorse che definisce le chiavi e i valori dei tag. Lo spazio dei nomi può essere combinato con i nomi brevi della chiave tag e del valore tag per creare un nome completamente qualificato univoco a livello globale per la chiave tag o il valore tag.
cost_at_list Numero in virgola mobile

I prezzi di listino associati a tutte le voci addebitate sul tuo account di fatturazione Cloud.
transaction_type Stringa

Il tipo di transazione del venditore. Il tipo di transazione può essere uno dei seguenti:

  • GOOGLE = 1: servizi venduti da Google Cloud.
  • THIRD_PARTY_RESELLER = 2: servizi di terze parti rivenduti da Google Cloud.
  • THIRD_PARTY_AGENCY = 3: servizi di terze parti venduti da un partner, con Google Cloud in qualità di agente.
seller_name Stringa

Il nome legale del venditore.

Informazioni sui dati dei costi di utilizzo standard e dettagliati

Le sezioni seguenti descrivono i dati standard e i dati dettagliati sul costo di utilizzo esportati in BigQuery.

Informazioni sulle etichette

I dati di costo per un'etichetta specifica mostrano solo l'utilizzo a partire dalla data a partire dalla data è stato applicato a una risorsa. Ad esempio, se aggiungi l'etichetta environment:dev a una VM Compute Engine il 15 gennaio 2024, qualsiasi analisi per environment:dev include solo l'utilizzo di quella VM dal 15 gennaio.

I dati delle etichette possono essere visualizzati in momenti diversi per servizi diversi, a seconda di quando viene fornito da ciascun servizio.

Etichette di sistema disponibili

Le etichette di sistema sono coppie chiave-valore per i metadati importanti relativi alla risorsa che ha generato l'utilizzo. Le seguenti etichette di sistema vengono incluse automaticamente per l'utilizzo applicabile.

system_labels.key Esempio system_labels.value Descrizione
compute.googleapis.com/machine_spec n1-standard-1, custom-2-2048 Configurazione della macchina virtuale. Consulta: Tipi di macchina per saperne di più.
compute.googleapis.com/cores per n1-standard-4 è 4; per custom-2-2048 è 2 Il numero di vCPU disponibili per la macchina virtuale.
compute.googleapis.com/memory per n1-standard-4 è 15360 (ovvero 15 GB * 1024 MB/GB); per custom-2-2048 è 2048 La quantità di memoria (in MB) disponibile per la macchina virtuale.
compute.googleapis.com/is_unused_reservation true; falso Indica l'utilizzo prenotato tramite Prenotazioni a livello di zona ma non in uso.
storage.googleapis.com/object_state live; noncurrent; soft_deleted; multipart Lo stato dell'oggetto di archiviazione di cui viene addebitato il costo.

Differenze tra dati esportati e fatture

I prodotti Google Cloud registrano i dati di utilizzo e di costo per i processi di fatturazione Cloud a intervalli variabili. Di conseguenza, potresti notare un ritardo tra l'utilizzo dei servizi Google Cloud e la visualizzazione dell'utilizzo e dei costi in Fatturazione Cloud. In genere, i costi sono disponibili entro un giorno, ma a volte possono essere necessarie più di 24 ore.

Alla fine di un mese di calendario, l'utilizzo segnalato in ritardo potrebbe non essere incluso nella fattura di quel mese, ma essere riportato nella fattura del mese successivo.

Quando esegui query sui costi utilizzando i campi timestamp, i dati restituiti potrebbero rilevare un utilizzo segnalato in ritardo che non era originariamente incluso nella fattura generato per lo stesso mese di utilizzo. Di conseguenza, il servizio di fatturazione Cloud i dati restituiti potrebbero non essere mappati direttamente a quella fattura.

I campi timestamp includono:

  • usage_start_time
  • usage_end_time
  • export_time

Per restituire i dati di fatturazione di Cloud che si mappano direttamente a una fattura, esegui una query su invoice.month invece che sui campi timestamp.

Imposte

A partire dal 1° settembre 2020, i dati del costo di utilizzo mostrano le tue imposte la responsabilità per ciascuno dei tuoi progetti, invece che come singola voce. Se hai query o visualizzazioni che dipendono dai dati fiscali, potresti dover aggiornare le query per tenere conto di queste modifiche.

Ad esempio, per i costi registrati prima del 1° settembre, i dati relativi al costo di utilizzo erano simili a quelli dell'esempio seguente, che mostra un'obbligazione fiscale totale di 10 $.

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 progetto-di-esempio Normale 60 $
123456-ABCDEF-123456 test-project Normale 40 $
123456-ABCDEF-123456 [vuota] Tasse 10 $

Per i costi registrati dopo il 1° settembre, i 10 $ sono suddivisi in 6 $ per example-project e 4 $ per test-project:

billing_account_id project.id cost_type cost
123456-ABCDEF-123456 progetto-di-esempio Normale 60 $
123456-ABCDEF-123456 test-project Normale 40 $
123456-ABCDEF-123456 progetto-di-esempio Tasse $ 6
123456-ABCDEF-123456 test-project Tasse 4 $

Errori e aggiustamenti

Nel raro caso in cui i dati di fatturazione Cloud contengano un errore o richiedano un aggiustamento, vengono aggiunti dati correttivi. Questi aggiustamenti rientrano in una di due categorie: modifiche o correzioni alla fatturazione.

Modifiche alla fatturazione

Le modifiche alla fatturazione vengono visualizzate come voci separate. Se hai ricevuto un addebito modifica, una nuova voce nell'esportazione della fatturazione Cloud BigQuery mostra la modifica. Gli aggiustamenti mostrati corrispondono le fatture, le note di credito e le note di debito disponibili in Area Documenti della sezione Fatturazione della console Google Cloud.

Per ulteriori informazioni sulle modifiche alla fatturazione e su come vengono applicate, consulta Informazioni su note e aggiustamenti.

Correzioni

Le correzioni vengono visualizzate come nuovi dati che annullano i dati errati negli SKU di origine. In alcuni casi, nuovi dati sostituiranno l'addebito errato. Tutte le colonne nell'esportazione dei dati di fatturazione corrisponderanno ai dati originali, ad eccezione delle seguenti colonne:

  • cost
  • credit
  • usage.amount
  • export_time

Ad esempio, immagina che ti vengano addebitati 10 $ per l'utilizzo di SKU A il 1° gennaio. Nella fattura di gennaio (rilasciata all'inizio di febbraio), vedrai un addebito di 10 $ per SKU A. Tuttavia, il 2 febbraio Google Cloud ha emesso una correzione per SKU A, riducendo il costo di utilizzo a 5 $. Riceverai altre due voci nella fattura di febbraio (emessa a inizio marzo):

  • -10 $ per l'utilizzo il 1° gennaio (escluso l'addebito originale)
  • 5 $ per l'utilizzo il 1° gennaio (che indica l'addebito previsto)

Questi nuovi elementi hanno una colonna adjustment_info nell'esportazione dei dati di fatturazione. La alla fattura originale di gennaio, che mostra l'addebito eccessivo, non verrà modificata. Per verificare gli addebiti nell'esportazione dei dati di fatturazione, visualizza costi per usage_start_time e il raggruppamento per Day. In queste visualizzazioni, eventuali correzioni o addebiti per l'utilizzo monetizzato in ritardo vengono e non è necessario preoccuparsi di dati temporaneamente errati.

Se desideri informazioni più dettagliate sulle tue correzioni, visualizza tutte addebiti in un mese di fatturazione e cerca gli addebiti in cui la data di utilizzo si sono verificate prima del mese di fatturazione. Questi addebiti sono il risultato di correzioni o utilizzo monetizzato in ritardo.

Il seguente esempio di codice mostra come creare una query di base che restituisce il token costo totale delle correzioni o utilizzo monetizzato in ritardo:

SELECT
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
      FROM   UNNEST(credits) c), 0))
    AS total
FROM `project.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE
  invoice.month = '202311' AND
  DATE(TIMESTAMP_TRUNC(usage_start_time, Day, 'US/Pacific')) < '2023-11-01';

Per un esempio di query che restituisce un'analisi dei costi per servizio per fattura addebiti in cui la data di utilizzo si è verificata prima del mese di fatturazione, consulta Esegui query sui dettagli dei costi per visualizzare le correzioni o l'utilizzo monetizzato in ritardo per servizio per un determinato mese di fatturazione in "Query di esempio per l'esportazione dei dati di fatturazione Cloud".

Informazioni sui crediti promozionali nei contratti con prezzi personalizzati

Se hai un contratto con prezzi personalizzati, potresti ricevere un offerta promozionale da utilizzare su Google Cloud nell'ambito del contratto. Ad esempio, potresti ricevere 1000 $ da utilizzare per le risorse Compute Engine. I crediti promozionali sono generalmente considerati una forma di pagamento. Se disponibili, I crediti promozionali vengono applicati automaticamente per ridurre il totale della fattura.

I termini del contratto specificano se i crediti promozionali si applicano al tuo calcolati al prezzo di listino di uno SKU o al prezzo netto (dopo sconti).

Se i crediti promozionali sono applicabili a costi calcolati nell'elenco [price], nel report sulla tabella dei costi, esiste un servizio chiamato Invoice, con uno SKU chiamato Contract billing adjustment. Questo SKU regola in modo che si applichino ai costi al prezzo di listino. Per vedere l'utilizzo a cui si riferisce l'aggiustamento, esegui una query sulle colonne system.labels. La chiave in system.labels.key è cloud-invoice.googleapis.com/sku_id e il valore in system.labels.value contiene l'ID SKU a cui sono stati applicati il credito e l'aggiustamento.

Informazioni sui tag

Tag sono risorse sotto forma di coppie chiave/valore che possono essere collegate alle risorse direttamente o tramite ereditarietà. Puoi utilizzare i tag per eseguire storni di addebito, controlli e altre analisi di allocazione dei costi. Puoi anche utilizzare i tag e l'applicazione condizionale dei criteri per avere un controllo granulare in tutta la gerarchia delle risorse.

I tag dispongono di un solido modello di autorizzazioni e possono supportare l'ereditarietà, gestione, standardizzazione della nomenclatura e integrazione del motore dei criteri, le etichette sono uno strumento separato che ti consente di annotare le risorse.

I dati dei tag vengono visualizzati nelle esportazioni di BigQuery per Risorse, Progetti, Fogli e Organizzazioni.

Tag disponibili

Le esportazioni Costi standard e Costi dettagliati per Risorse, Progetti, Raccolte e Organizzazioni includono questi campi per i dati dei tag: Chiave tag, Valore tag, Tag ereditati e Spazio dei nomi tag.

I tag a livello di risorsa nell'esportazione dei dati di fatturazione Cloud sono disponibili per le seguenti risorse:

  • Cluster, istanze e backup di AlloyDB per PostgreSQL
  • Repository Artifact Registry
  • Servizi e job di Cloud Run
  • Bucket Cloud Storage
  • Istanze di Compute Engine
  • Istanze Memorystore for Redis
  • Secret di Secret Manager
  • Istanze Spanner

Limitazioni dei tag

  • La propagazione dei tag in BigQuery può richiedere fino a un'ora . Se un tag è stato aggiunto o rimosso entro un'ora o se una risorsa ed esiste da meno di un'ora, potrebbe non apparire nell'esportazione.

Esempi di query sui costi di utilizzo standard

Questa sezione fornisce esempi di come eseguire query sui dati di costo di utilizzo standard della fatturazione Cloud esportati in BigQuery.

Specificare il nome tabella da utilizzare nelle query

In questi esempi, per eseguire query sui dati di fatturazione Cloud in BigQuery, devi specificare il nome della tabella nella clausola FROM. Il nome della tabella viene determinato utilizzando tre valori: project.dataset.BQ_table_name.

Valori comuni utilizzati nelle query sui costi standard di esempio

Gli esempi di query in questa sezione utilizzano il seguente valore per Nome tabella: project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX

Questi esempi di query funzionano anche con i dati dettagliati sui costi di utilizzo esportati in BigQuery, anche se non sono scritti per recuperare nessuna delle informazioni a livello di risorsa fornite con l'opzione di esportazione dettagliata dei costi di utilizzo.

Restituire i costi totali di una fattura

Le seguenti query mostrano due modi per visualizzare i valori di costo e credito utilizzando i dati di fatturazione esportati.

  • Il campo total somma direttamente i valori di costo e credito in virgola mobile, il che può comportare errori di arrotondamento in virgola mobile.
  • Il campo total_exact converte i costi e i valori del credito in micro prima del giorno somma, poi converte di nuovo in dollari dopo la somma, evitando errore di arrotondamento con rappresentazione in virgola mobile.

Esempio 1: somma di tutti i costi per fattura

Questa query mostra il totale delle fatture di ogni mese, come somma di costi, tasse, aggiustamenti ed errori di arrotondamento standard.

SQL standard

SELECT
  invoice.month,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1
ORDER BY 1 ASC
;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga mese totale total_exact
1 201901 1005,004832999999984 1005,00 $
2 201902 992,3101739999999717 992,31 $
3 201903 1220,761089999999642 $ 1220,76 $

Esempio 2: dettagli del reso per tipo di costo, per mese di fatturazione

Questa query mostra i totali per ogni cost_type per ogni mese. I tipi di costi includeono costi standard, tasse, aggiustamenti ed errori di arrotondamento.

SQL standard

SELECT
  invoice.month,
  cost_type,
  SUM(cost)
    + SUM(IFNULL((SELECT SUM(c.amount)
                  FROM   UNNEST(credits) c), 0))
    AS total,
  (SUM(CAST(cost * 1000000 AS int64))
    + SUM(IFNULL((SELECT SUM(CAST(c.amount * 1000000 as int64))
                  FROM UNNEST(credits) c), 0))) / 1000000
    AS total_exact
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY 1, 2
ORDER BY 1 ASC, 2 ASC
;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga mese cost_type totale total_exact
1 201901 regolare 1000,501209987994782 1000,50 $
2 201901 rounding_error -0,500489920049387 $ –0,50 $
3 201901 tasse 10,000329958477891 $ 10,00
4 201901 aggiustamento –$5,002572999387045 -5,00 $

Esempi di query con etichette

Gli esempi riportati di seguito mostrano altri modi per eseguire query sui dati con le etichette.

Per gli esempi in questa sezione, presupponiamo quanto segue:

  • Hai due app (grapefruit-squeezer e chocolate-masher).
  • Per ogni app, hai due ambienti (sviluppo e produzione).
  • L'ambiente di sviluppo ha una piccola istanza per app.
  • L'ambiente di produzione ha una piccola istanza nelle Americhe e una piccola in Asia.
  • Ogni istanza è etichettata con l'app e l'ambiente.
  • Hai una istanza senza etichette che usi per la sperimentazione.

Il tuo conto totale è di $ 24 con la seguente ripartizione:

Istanza Etichette Costo totale
Piccola istanza con una vCPU in esecuzione nelle Americhe Nessuna $ 4
Piccola istanza con una vCPU in esecuzione nelle Americhe app: chocolate-masher
environment: dev		 $ 2
Piccola istanza con una vCPU in esecuzione nelle Americhe app: grapefruit-squeezer
environment: dev		 $ 3
Piccola istanza con una vCPU in esecuzione nelle Americhe app: chocolate-masher
environment: prod		 $ 3,25
Piccola istanza con una vCPU in esecuzione in Asia app: chocolate-masher
environment: prod		 $ 3,75
Piccola istanza con una vCPU in esecuzione nelle Americhe app: grapefruit-squeezer
environment: prod		 $ 3,50
Piccola istanza con una vCPU in esecuzione in Asia app: spremiagrumi
ambiente: produzione		 $ 4,50

Esecuzione di query su ogni riga senza raggruppamento

La visualizzazione più granulare di questi costi si otterrebbe eseguendo una query su ogni riga senza raggruppamento. Supponi che tutti i campi, eccetto le etichette e la descrizione della SKU, siano gli stessi (progetto, servizio e così via).

SQL standard

SELECT
  sku.description,
  TO_JSON_STRING(labels) as labels,
 cost as cost
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`;

SQL precedente

TO_JSON_STRING not supported.
Riga sku.description etichette costo
1 Piccola istanza con una vCPU in esecuzione nelle Americhe [] $ 4
2 Piccola istanza con una vCPU in esecuzione nelle Americhe [{"key":"app","value":"chocolate-masher"},{"key":"environment","value":"dev"}] $ 2
3 Piccola istanza con una vCPU in esecuzione nelle Americhe [{"key":"app","value":"grapefruit-squeezer"},{"key":"environment","value":"dev"}] $ 3
4 Piccola istanza con una vCPU in esecuzione nelle Americhe [{"key":"app","value":"chocolate-masher"},{"key":"environment","value":"prod"}] $ 3,25
5 Piccola istanza con una vCPU in esecuzione in Asia [{"key":"app","value":"chocolate-masher"},{"key":"environment","value":"prod"}] $ 3,75
6 Piccola istanza con una vCPU in esecuzione nelle Americhe [{"key":"app","value":"grapefruit-squeezer"},{"key":"environment","value":"prod"}] $ 3,50
7 Piccola istanza con una vCPU in esecuzione in Asia [{"key":"app","value":"grapefruit-squeezer"},{"key":"environment","value":"prod"}] $ 4,50
TOTALE $ 24

Raggruppamento per mappa di etichetta sotto forma di stringa JSON

Questo è un modo rapido e semplice per ripartire i costi in base a ogni combinazione di etichette.

SQL standard

SELECT
  TO_JSON_STRING(labels) as labels,
  sum(cost) as cost
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
GROUP BY labels;

SQL precedente

TO_JSON_STRING not supported.
Riga etichette costo
1 [] $ 4
2 [{"key":"app","value":"chocolate-masher"},{"key":"environment","value":"dev"}] $ 2
3 [{"key":"app","value":"grapefruit-squeezer"},{"key":"environment","value":"dev"}] $ 3
4 [{"key":"app","value":"chocolate-masher"},{"key":"environment","value":"prod"}] $ 7
5 [{"key":"app","value":"grapefruit-squeezer"},{"key":"environment","value":"prod"}] $ 8
TOTALE $ 24

Raggruppamento per valore di etichetta per una chiave specifica

La ripartizione dei costi per i valori di una chiave di etichetta specifica è un caso d'uso comune. Se utilizzi un LEFT JOIN e inserisci il filtro per la chiave ("key") nella condizione JOIN (anziché WHERE), includi il costo che non contiene questa chiave, in modo da ottenere una visione completa del costo.

SQL standard

SELECT
  labels.value as environment,
  SUM(cost) as cost
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
LEFT JOIN UNNEST(labels) as labels
  ON labels.key = "environment"
GROUP BY environment;

SQL precedente

SELECT
  labels.value as environment,
  SUM(cost) as cost
FROM [project:dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX]
WHERE labels.key = "environment" OR labels.key IS NULL
GROUP BY environment;
Riga ambiente costo
1 prod $ 15
2 dev $ 5
3 null $ 4
TOTALE $ 24

Raggruppamento per coppie chiave/valore

Fai attenzione al momento di interpretare o esportare questi risultati. Una singola riga in questi esempi mostra una somma valida senza doppio conteggio, ma non dovrebbe essere combinata con altre righe, tranne eventualmente se la chiave è la stessa o se hai la certezza che le chiavi non verranno mai impostate sulla stessa risorsa.

SQL standard

SELECT
  labels.key as key,
  labels.value as value,
  SUM(cost) as cost
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
LEFT JOIN UNNEST(labels) as labels
GROUP BY key, value;

SQL precedente

SELECT
  labels.key as key,
  labels.value as value,
  SUM(cost)
FROM [project:dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX]
GROUP BY key, value;
Riga chiave valore costo
1 null null $ 4
2 app chocolate-masher $ 9
3 app grapefruit-squeezer $ 11
4 environment dev $ 5
5 environment prod $ 15
TOTALE $ 44

Nota come la somma totale sia maggiore dell'importo della tua fattura.

Query sullo sconto per impegno di utilizzo

Le seguenti query mostrano i modi per visualizzare le commissioni e i crediti associati agli sconti per impegno di utilizzo nei dati di fatturazione esportati. Per comprendere le tariffe e i crediti del tuo impegno sono attribuite al tuo account di fatturazione Cloud e ai tuoi progetti, consulta Attribuzione degli sconti per impegno di utilizzo.

Visualizzazione delle tariffe di impegno

Per visualizzare le commissioni di impegno per i sconti per utilizzo a livello di impegno nell'esportazione dei dati di fatturazione, utilizza la seguente query di esempio.

SQL standard

SELECT
    invoice.month AS invoice_month,
    SUM(cost) as commitment_fees
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
WHERE LOWER(sku.description) LIKE "commitment%"
GROUP BY 1

Visualizzazione dei crediti dell'impegno

Per visualizzare sconto per impegno di utilizzo nell'esportazione dei dati di fatturazione, utilizza la seguente query di esempio.

SQL standard

SELECT
    invoice.month AS invoice_month,
    SUM(credits.amount) as CUD_credits
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
LEFT JOIN UNNEST(credits) AS credits
WHERE LOWER(credits.name) LIKE "committed use discount%"
GROUP BY 1

Utilizza i filtri della gerarchia delle risorse per esaminare la discendenza

Puoi utilizzare i filtri della gerarchia delle risorse per aggregare i costi in base agli elementi della gerarchia, come progetti, cartelle e organizzazioni. Questi esempi di query mostrano metodi per sommare i costi filtrati in base agli elementi della gerarchia delle risorse e per visualizzare le ascendenze dei progetti.

Esempio 1: filtrare per nome risorsa

Questo esempio mostra query che raggruppano i costi in base all'ascendenza del progetto e filtrano solo i costi generati in un elemento della gerarchia specificato, identificato dal nome della risorsa relativa.

Metodo stringa

SELECT
    invoice.month AS invoice_month,
    TO_JSON_STRING(project.ancestors) as ancestors,
    SUM(cost)
        + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0))
        AS net_cost
  FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX` as bq
  WHERE TO_JSON_STRING(project.ancestors) like "%resource_name\":\"folders/1234"
  GROUP BY invoice_month, ancestors
  ORDER BY invoice_month, ancestors

Metodo UNNEST

SELECT
    invoice.month AS invoice_month,
    TO_JSON_STRING(project.ancestors) as ancestors,
    SUM(cost)
        + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0))
        AS net_cost
  FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX` as bq, UNNEST(project.ancestors) as ancestor
  WHERE ancestor.resource_name = "folders/1234"
  GROUP BY invoice_month, ancestors
  ORDER BY invoice_month, ancestors

Esempio 2: filtrare per nome visualizzato

Questo esempio mostra le query che raggruppano i costi in base all'ascendenza del progetto e filtrano solo i costi generati in un elemento della gerarchia specificato, identificato dal nome visualizzato fornito dall'utente.

Metodo di corrispondenza delle stringhe

SELECT
    invoice.month AS invoice_month,
    TO_JSON_STRING(project.ancestors) as ancestors,
    SUM(cost)
        + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0))
        AS net_cost
  FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX` as bq
  WHERE TO_JSON_STRING(project.ancestors) like "%display_name\":\"MyFolderName%"
  GROUP BY invoice_month, ancestors
  ORDER BY invoice_month, ancestors

Metodo UNNEST

SELECT
    invoice.month AS invoice_month,
    TO_JSON_STRING(project.ancestors) as ancestors,
    SUM(cost)
        + SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0))
        AS net_cost
  FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX` as bq, UNNEST(project.ancestors) as ancestor
  WHERE ancestor.display_name = "MyFolderName"
  GROUP BY invoice_month, ancestors
  ORDER BY invoice_month, ancestors

Esempi di query con tag

I seguenti esempi illustrano come eseguire query sui dati con i tag.

Calcolare i costi per mese di fatturazione con i tag

La seguente query mostra come utilizzare i costi di reso per mese di fatturazione per il tag cost_center.

SELECT
  invoice.month AS invoice_month,
  tag.value AS cost_center,
  ROUND((SUM(CAST(cost AS NUMERIC))
    + SUM(IFNULL((SELECT SUM (CAST(c.amount AS NUMERIC))
                  FROM UNNEST(credits) AS c), 0))), 2)
    AS net_cost
FROM `project-ID.dataset.gcp_billing_export_resource_v1_XXXXXX-XXXXXX-XXXXXX`, UNNEST(tags) AS tag
WHERE tag.key = "cost_center" AND tag.namespace = "821092389413"
GROUP BY invoice.month, tag.value
ORDER BY invoice.month, tag.value;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga invoice_month cost_center net_cost
1 202208 android_mobile_apps 9,93
2 202208 ios_mobile_apps 9,93
3 202209 android_mobile_apps 25,42
4 202209 ios_mobile_apps 25,4
5 202209 personalizzazione 16,08

Visualizzare i costi delle risorse non taggate

Questa query mostra il totale della fattura per le risorse senza tag, raggruppate per fattura mese.

SELECT
 invoice.month AS invoice_month,
 ROUND((SUM(CAST(cost AS NUMERIC))
   + SUM(IFNULL((SELECT SUM(CAST(c.amount AS NUMERIC))
                 FROM UNNEST(credits) AS c), 0))), 2)
   AS net_cost
FROM
 `project-ID.dataset.gcp_billing_export_v1_XXXXXX-XXXXXX-XXXXXX`
WHERE "color" NOT IN (SELECT key FROM UNNEST(tags))
GROUP BY invoice_month
ORDER BY invoice_month;

Ad esempio, il risultato della query precedente potrebbe essere:

Riga invoice_month net_cost
1 202202 0
2 202203 16,81
3 202204 54,09
4 202205 55,82
5 202206 54,09
6 202207 55,83
7 202208 31,49

Altri esempi di query

Esegui query sui costi e sui crediti per progetto per un mese di fatturazione specificato

Fornendo un mese di fatturazione specifico di giugno 2020 (nel formato AAAAMM), questa query restituirà una visualizzazione dei costi e dei crediti raggruppati per progetto, nonché le etichette dei progetti.

SQL standard

SELECT
  project.name,
  TO_JSON_STRING(project.labels) as project_labels,
  sum(cost) as total_cost,
  SUM(IFNULL((SELECT SUM(c.amount) FROM UNNEST(credits) c), 0)) as total_credits
FROM `project.dataset.gcp_billing_export_v1_XXXXXX_XXXXXX_XXXXXX`
WHERE invoice.month = "202006"
GROUP BY 1, 2
ORDER BY 1;

SQL precedente

TO_JSON_STRING not supported.
Riga name project_labels total_cost total_credits
1 CTG - Dev [{"key":"ctg_p_env","value":"dev"}] 79.140979 -4.763796
2 CTG - Prod [{"key":"ctg_p_env","value":"prod"},{"key":"ctg_team","value":"eng"}] 32.466272 -3.073356
3 CTG - Sandbox [{"key":"ctg_p_env","value":"dev"}] 0 0
4 CTG - Storage [{"key":"ctg_p_env","value":"prod"},{"key":"ctg_team","value":"data"}] 7.645793 -0.003761

Report su costi e prezzi disponibili nella console Google Cloud

Indietro
Informazioni sulle tabelle di dati di fatturazione in BigQuery
Avanti
Struttura dell'esportazione dei dati dettagliati