CO2-Bilanz exportieren

Sie können Ihre CO₂-Bilanzdaten nach BigQuery exportieren, um Datenanalysen durchzuführen oder benutzerdefinierte Dashboards und Berichte zu erstellen.

Der Export der CO₂-Bilanz erfasst die geschätzten Treibhausgasemissionen im Zusammenhang mit der Nutzung von abgedeckten Google Cloud Diensten für das ausgewählte Rechnungskonto.

Nachdem Sie einen Export konfiguriert haben, werden Ihnen die BigQuery-Ressourcen in Rechnung gestellt, die zum Speichern und Abfragen der exportierten Daten verwendet werden.

Hinweise

Zum Erstellen eines CO₂-Bilanzexports empfehlen wir die folgenden IAM-Rollen:

Genauer gesagt benötigen Sie die folgenden IAM-Berechtigungen für das Google Cloud -Projekt:

  • resourcemanager.projects.update
  • serviceusage.services.enable
  • bigquery.transfers.update

Außerdem benötigen Sie die folgende IAM-Berechtigung für das Rechnungskonto:

  • billing.accounts.getCarbonInformation

VPC Service Controls verwenden

Wenn Ihre Organisation VPC Service Controls verwendet, muss eine Ingress-Regel für die BigQuery API und die BigQuery Data Transfer Service API definiert werden.

Für Ihre Regel für eingehenden Traffic:

  • Legen Sie im Bereich „Von“ die Quelle auf „Alle Quellen zulassen“ fest.
  • Erteilen Sie der Identität els-da-carbon@gcp-carbon-footprint-exports.iam.gserviceaccount.com die Berechtigung.

Carbon Footprint-Export nach BigQuery konfigurieren

Die Daten zu Carbon Footprint werden über den BigQuery Data Transfer Service exportiert. Bei der Datenübertragung wird eine monatlich partitionierte Tabelle mit dem Namen carbon_footprint im BigQuery-Dataset Ihrer Wahl erstellt.

Beim Export der Carbon Footprint werden die Daten des jeweiligen Monats am 15. des Folgemonats exportiert. So werden beispielsweise CO₂-Daten für September 2022 am 15. Oktober 2022 exportiert.

Nachdem eine Konfiguration für die Übertragung der Carbon Footprint erstellt wurde, werden zukünftige CO₂-Berichte automatisch am 15. eines jeden Monats exportiert. Sie können auch einen Backfill ausführen, um Verlaufsdaten bis Januar 2021 anzufordern.

Console

So starten Sie den Export:

  1. Zur CO₂-Bilanz
  2. Wählen Sie im Menü Rechnungskonto das Cloud-Rechnungskonto aus, aus dem Sie Daten exportieren möchten.
  3. Klicken Sie auf Datenexport, um die Seitenleiste zum Konfigurieren des Exports zu öffnen.
  4. Wählen Sie ein Projekt für den Export Ihrer CO₂-Bilanzdaten aus und klicken Sie dann auf Export erstellen.
  5. Auf der Seite „BigQuery Data Transfer Service“:
    1. Achten Sie darauf, dass Quelle auf „Google Cloud Carbon Footprint Exports“ festgelegt ist.
    2. Geben Sie unter Konfigurationsname für Übertragung einen Anzeigenamen ein.
    3. Klicken Sie unter Zieleinstellungen auf das Feld Dataset-ID und wählen Sie dann Neues Dataset erstellen aus, wenn Sie ein neues BigQuery-Dataset für die exportierte Tabelle erstellen möchten. Alternativ können Sie ein vorhandenes BigQuery-Dataset auswählen.
    4. Prüfen Sie unter Details zur Datenquelle die Cloud-Rechnungskonto-ID, die exportiert werden soll. Optional können Sie weitere Konto-IDs als durch Kommas getrennte Liste hinzufügen. Alle Rechnungskonto-IDs müssen das Format XXXXXX-XXXXXX-XXXXXX haben.
  6. Klicken Sie auf Speichern.
  7. Klicken Sie im Fenster mit der Zugriffsanfrage auf Zulassen.

bq

Verwenden Sie den Befehl bq mk --transfer_config, um den Export zu starten:

bq mk \
--transfer_config \
--target_dataset=DATASET \
--display_name=NAME \
--params='{"billing_accounts":"BILLING_ACCOUNT_IDS"}' \
--data_source='61cede5a-0000-2440-ad42-883d24f8f7b8'

Wobei:

  • DATASET ist das Ziel-Dataset für die Übertragungskonfiguration.
  • NAME ist der Anzeigename für die Übertragungskonfiguration. Beispiel: „Company Carbon Report“ (CO2-Bericht des Unternehmens).
  • BILLING_ACCOUNT_IDS ist Ihre Rechnungskonto-ID oder eine durch Kommas getrennte Liste von Rechnungskonto-IDs. Beispiel: XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX

Terraform

Verwenden Sie die Terraform-Ressource bigquery_data_transfer_config, um einen Export zu erstellen:

resource "google_bigquery_data_transfer_config" "RESOURCE_NAME" {
  display_name           = "NAME"
  data_source_id         = "61cede5a-0000-2440-ad42-883d24f8f7b8"
  destination_dataset_id = google_bigquery_dataset.DATASET.dataset_id
  params = {
    billing_accounts     = "BILLING_ACCOUNT_IDS"
  }
}

Wobei:

  • RESOURCE_NAME ist der Name der Terraform-Ressource. Beispiel: carbon_export
  • NAME ist der Anzeigename für die Übertragungskonfiguration. Beispiel: „Company Carbon Report“ (CO2-Bericht des Unternehmens).
  • DATASET ist der Name der google_bigquery_dataset-Terraform-Ressource, die als Ziel-Dataset für den Export verwendet werden soll.

  • BILLING_ACCOUNT_IDS ist Ihre Rechnungskonto-ID oder eine durch Kommas getrennte Liste von Rechnungskonto-IDs. Beispiel: XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX

Die Übertragungskonfiguration wurde erstellt und exportiert ab dem 15. des aktuellen Monats Daten.

Mit der Übertragungskonfiguration werden keine Verlaufsdaten automatisch exportiert. Wenn Sie Verlaufsdaten ab Januar 2021 anfordern möchten, planen Sie mit den folgenden Schritten einen Data Backfill.

Console

So planen Sie den Daten-Backfill:

  1. Rufen Sie die Details der gerade erstellten Übertragung auf.
  2. Klicken Sie auf Backfill planen.
  3. Wählen Sie Für einen Zeitraum ausführen aus.
  4. Wählen Sie den 15. Februar 2021 als Startdatum und das heutige Datum als Enddatum aus. Der Export für den 15. Februar 2021 enthält die Daten für Januar 2021. Das ist also der früheste Monat, für den ein Export angefordert werden kann.
  5. Klicken Sie auf OK, um den Backfill der Daten anzufordern.

Für den ausgewählten Zeitraum werden Daten-Backfills erstellt und historische monatliche Daten in das Ziel-Dataset exportiert.

bq

Verwenden Sie den Befehl bq mk --transfer_run, um einen Backfill zu erstellen:

bq mk \
--transfer_run \
--start_time=START_TIME \
--end_time=END_TIME \
CONFIG

Wobei:

  • START_TIME ist ein Zeitstempel, der die Startzeit des zu füllenden Bereichs angibt. Beispiel: 2021-02-15T00:00:00Z. Das früheste Datum, das Sie hier angeben können, ist der 15. Februar 2021, da es die Daten für Januar 2021 enthält.
  • END_TIME ist ein Zeitstempel, der die Endzeit des zu füllenden Bereichs angibt. Beispiel: 2022-09-15T00:00:00Z. Sie können das aktuelle Datum verwenden.
  • TRANSFER_CONFIG ist die Kennung der Übertragung, die im vorherigen Schritt erstellt wurde. Beispiel: projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000

Nach dem Export der Daten können Sie sie mit BigQuery anzeigen und abfragen. Weitere Informationen zum Datenschema

Sie können die exportierten Daten für andere Nutzer in Ihrer Organisation freigeben, indem Sie ihnen die IAM-Rolle „BigQuery-Nutzer“ für das zuvor ausgewählte Projekt gewähren. Alternativ können Sie mit der IAM-Rolle „BigQuery Data Viewer“ detaillierten Zugriff auf Dataset- oder Tabellenebene gewähren.

Exporte der CO₂-Bilanz verwalten

Wenn Sie auf Datenexport klicken und die Seitenleiste öffnen, sehen Sie alle vorhandenen Carbon Footprint-Exporte.

Sie können dann jeden Carbon Footprint-Export verwalten, indem Sie auf den Übertragungsnamen klicken, um den BigQuery Data Transfer Service aufzurufen, oder auf den Dataset-Namen, um den Zieldatensatz aufzurufen. Weitere Informationen zum Arbeiten mit Übertragungen

Exportieren nach Google Sheets oder CSV

Nachdem Sie den Export der CO₂-Bilanz nach BigQuery konfiguriert haben und der geplante Export abgeschlossen ist, können Sie die Daten aus BigQuery in Google Sheets oder CSV exportieren.

  1. BigQuery aufrufen
  2. Maximieren Sie im Bereich Explorer Ihr Projekt und das Dataset und wählen Sie dann die Tabelle aus, die die exportierten Daten zur CO₂-Bilanz enthält.
  3. Klicken Sie auf Abfrage.
  4. Geben Sie eine Abfrage ein, um die Daten zurückzugeben, die Sie exportieren möchten. Unten finden Sie ein Beispiel.
  5. Klicken Sie nach der Ausführung der Abfrage unter Abfrageergebnisse auf Ergebnisse speichern.
  6. Wählen Sie das gewünschte Format aus und klicken Sie auf Speichern.

Mit der folgenden Abfrage können Sie den gesamten Inhalt der exportierten Tabelle speichern:

SELECT
  usage_month,
  billing_account_id,
  project.number AS project_number,
  project.id AS project_id,
  service.id AS service_id,
  service.description AS service_description,
  location.location AS location,
  location.region AS region,
  carbon_model_version,
  carbon_footprint_kgCO2e.scope1 AS carbon_footprint_scope1,
  carbon_footprint_kgCO2e.scope2.location_based AS carbon_footprint_scope2_location_based,
  carbon_footprint_kgCO2e.scope3 AS carbon_footprint_scope3,
  carbon_footprint_total_kgCO2e.location_based AS carbon_footprint_total_location_based
FROM
  `PROJECT.DATASET.carbon_footprint`
ORDER BY
  usage_month DESC,
  carbon_footprint_total_location_based DESC

Nächste Schritte