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 abgedeckter Google Cloud Dienste für das ausgewählte Rechnungskonto.

Nach dem Konfigurieren eines Exports werden Ihnen die BigQuery-Ressourcen in Rechnung gestellt, die zum Speichern und Abfragen der exportierten Daten verwendet werden.

Hinweis

Zum Erstellen eines Carbon Footprint-Exports empfehlen wir die folgenden IAM-Rollen:

• Projektinhaber oder Projektbearbeiter für das Google Cloud Projekt, in das exportiert werden soll.
• Betrachter der CO₂-Bilanz oder Betrachter des Rechnungskontos für das Rechnungskonto, dessen CO₂-Daten exportiert werden.

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

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

Und die folgende IAM-Berechtigung für das Rechnungskonto:

• billing.accounts.getCarbonInformation

VPC Service Controls verwenden

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

Für Ihre Regel für eingehenden Traffic:

• Legen Sie die Quelle im Abschnitt „Von“ auf „Alle Quellen zulassen“ fest.
• Gewähren Sie der Identität [e-mail] die Berechtigung.

Carbon Footprint-Export nach BigQuery konfigurieren

CO₂-Bilanzdaten werden über den BigQuery Data Transfer Service exportiert. Bei der Datenübertragung wird im ausgewählten BigQuery-Dataset eine monatlich partitionierte Tabelle mit dem Namen carbon_footprint erstellt.

Carbon Footprint-Exporte enthalten die Daten des jeweiligen Monats am 15. des Folgemonats. Beispiel: Die CO₂-Daten für September 2022 werden am 15. Oktober 2022 exportiert.

Sobald eine Übertragungskonfiguration für Carbon Footprint erstellt wurde, werden zukünftige CO₂-Berichte automatisch am 15. jedes Monats exportiert. Sie können auch einen Backfill ausführen, um Verlaufsdaten bis Januar 2021 anzufordern.

Console

Führen Sie die folgenden Schritte aus, um den Export zu starten:

1. Rufen Sie Carbon Footprint auf.
2. Wählen Sie im Menü Rechnungskonto das Cloud-Rechnungskonto aus, aus dem Sie 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 Exporte“ 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 erstellen möchten, in dem die exportierte Tabelle gehostet werden soll. Alternativ können Sie ein vorhandenes BigQuery-Dataset auswählen.
   4. Bestätigen 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 bq mk --transfer_config Befehl 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: „CO₂-Bericht für Unternehmen“.
• 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 bigquery_data_transfer_config Terraform-Ressource, 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: „CO₂-Bericht für Unternehmen“.

• 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 jetzt erstellt und exportiert Daten am 15. jedes zukünftigen Monats.

Hinweis: Wenn Sie eine andere Methode als die Console zum Exportieren der Daten verwenden, wird die Datenquelle nicht automatisch in Ihrem Projekt registriert. Verwenden Sie daher die Enroll Data Sources API , um die Datenquelle in Ihrem Projekt zu registrieren, bevor Sie den Exportvorgang ausführen.

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

Console

Führen Sie die folgenden Schritte aus, um den Daten-Backfill zu planen:

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. Beachten Sie, dass der Export für den 15. Februar 2021 die Daten vom Januar 2021 enthält und daher der früheste Monat ist, für den Daten angefordert werden können.
5. Klicken Sie auf OK , um den Daten-Backfill anzufordern.

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

bq

Verwenden Sie den bq mk --transfer_run Befehl 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 Zeitraums angibt, für den ein Backfill durchgeführt werden soll. Beispiel: 2021-02-15T00:00:00Z. Der 15. Februar 2021 ist das früheste Datum, das Sie hier angeben können, da es die Daten vom Januar 2021 enthält.
• END_TIME ist ein Zeitstempel der die Endzeit des Zeitraums angibt, für den ein Backfill durchgeführt werden soll. Beispiel: 2022-09-15T00:00:00Z. Sie können das aktuelle Datum verwenden.
• TRANSFER_CONFIG ist die ID der im vorherigen Schritt erstellten Übertragung. Beispiel: projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000.

Nachdem die Daten exportiert wurden, können Sie sie in BigQuery ansehen und abfragen. Daten ansehen 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“ detaillierte Zugriffsrechte auf Dataset- oder Tabellenebene gewähren.

CO₂-Bilanz-Exporte verwalten

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

Sie können dann jeden Carbon Footprint-Export verwalten, indem Sie auf den Namen der Übertragung klicken, um den BigQuery Data Transfer Service aufzurufen, oder auf den Namen des Datasets, um das Ziel-Dataset zu sehen. Weitere Informationen zum Arbeiten mit Übertragungen.

Hinweis:In einigen Fällen ist die Liste der Exporte aus den folgenden Gründen möglicherweise nicht vollständig:

• Berechtigungen: Der Export wurde in einem Projekt konfiguriert, für das Sie keine Berechtigung zum Ansehen haben.
• Leistungsoptimierung: Um die Leistung zu optimieren und Latenzen zu vermeiden, wenn Sie Zugriff auf eine sehr große Anzahl von Projekten haben, werden bei der Suche möglicherweise nicht Exporte in allen Projekten angezeigt.

In Google Sheets oder CSV exportieren

Nachdem Sie den Export Ihrer 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 CO₂-Bilanzdaten enthält.
3. Klicken Sie auf Abfrage.
4. Geben Sie eine Abfrage ein, um die Daten zurückzugeben, die Sie exportieren möchten. Ein Beispiel finden Sie unten.
5. Klicken Sie nach dem Ausführen 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

• Informationen zum im Export verwendeten Datenschema.
• Brutto-CO₂-Bilanz in der Google Cloud Console ansehen.
• Benutzerdefinierte Dashboards mit den exportierten Daten erstellen.
• Informationen zur Methodik von Carbon Footprint.