Exporte a sua pegada de carbono
Pode exportar os seus dados da Pegada de carbono para o BigQuery para realizar a análise de dados ou criar painéis de controlo e relatórios personalizados.
A exportação da pegada de carbono capta as emissões de gases de efeito estufa estimadas associadas à utilização dos serviços cobertos Google Cloud para a conta de faturação selecionada.
Após configurar uma exportação, são-lhe cobrados os recursos do BigQuery usados para armazenar e consultar os dados exportados.
Antes de começar
Para criar uma exportação da pegada de carbono, recomendamos que tenha as seguintes funções do IAM:
- Proprietário do projeto ou Editor do projeto no Google Cloud projeto para o qual quer exportar.
- Visualizador da pegada de carbono ou Visualizador da conta de faturação na conta de faturação cujos dados de carbono vão ser exportados.
Mais precisamente, tem de ter as seguintes autorizações de IAM no Google Cloud projeto:
resourcemanager.projects.update
serviceusage.services.enable
bigquery.transfers.update
E a seguinte autorização do IAM na conta de faturação:
billing.accounts.getCarbonInformation
Se usar os VPC Service Controls
Se a sua organização estiver a usar os VPC Service Controls, tem de definir uma regra de entrada para a API BigQuery e a API BigQuery Data Transfer Service.
Para a regra da política de entrada:
- Defina a origem na secção "De" como "Permitir todas as origens".
- Conceda autorização à identidade
els-da-carbon@gcp-carbon-footprint-exports.iam.gserviceaccount.com
.
Configurar uma exportação de pegada de carbono para o BigQuery
Os dados da pegada de carbono são exportados através do
Serviço de transferência de dados do BigQuery.
A transferência de dados cria uma
tabela particionada mensalmente
denominada carbon_footprint
no conjunto de dados do BigQuery à sua escolha.
As exportações da pegada de carbono exportam os dados de cada mês no dia 15 do mês seguinte. Por exemplo, os dados de carbono de setembro de 2022 vão ser exportados a 15 de outubro de 2022.
Depois de criar uma configuração de transferência da pegada de carbono, esta exporta automaticamente os futuros relatórios de carbono no dia 15 de cada mês. Também pode executar um preenchimento para pedir dados do histórico até janeiro de 2021.
Consola
Siga os passos abaixo para iniciar a exportação:
- Aceda à pegada de carbono
- Selecione a conta do Cloud Billing a partir da qual quer exportar no menu Conta de faturação.
- Clique em Exportação de dados para abrir o painel lateral de configuração da exportação.
- Selecione um projeto para a exportação de dados da sua pegada de carbono e, de seguida, clique em Criar exportação.
- Na página Serviço de transferência de dados do BigQuery:
- Certifique-se de que a opção Origem está definida como "Google Cloud Emissão de carbono Exportações".
- Em Nome da configuração de transferência, introduza um nome a apresentar.
- Em Definições de destino, clique no campo ID do conjunto de dados e, de seguida, selecione Criar novo conjunto de dados se quiser criar um novo conjunto de dados do BigQuery para alojar a tabela exportada; em alternativa, selecione um conjunto de dados do BigQuery existente.
- Em Detalhes da origem de dados, confirme o ID da conta de faturação do Google Cloud que quer exportar. Opcionalmente, adicione IDs de contas adicionais como uma lista separada por vírgulas. Todos os IDs das contas de faturação devem estar no formato
XXXXXX-XXXXXX-XXXXXX
.
- Clique em Guardar.
- Na janela de pedido de acesso, clique em Permitir.
bq
Use o comando bq mk --transfer_config
para iniciar a exportação:
bq mk \ --transfer_config \ --target_dataset=DATASET \ --display_name=NAME \ --params='{"billing_accounts":"BILLING_ACCOUNT_IDS"}' \ --data_source='61cede5a-0000-2440-ad42-883d24f8f7b8'
Onde:
- DATASET é o conjunto de dados de destino para a configuração de transferência.
- NAME é o nome a apresentar da configuração de transferência. Por exemplo: "Relatório de carbono da empresa".
- BILLING_ACCOUNT_IDS é o ID da conta de faturação ou uma lista de IDs de contas de faturação separados por vírgulas. Por exemplo:
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
Terraform
Use o recurso do Terraform bigquery_data_transfer_config
para criar uma exportação:
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" } }
Onde:
- RESOURCE_NAME é o nome do recurso do Terraform.
Por exemplo:
carbon_export
. - NAME é o nome a apresentar da configuração de transferência. Por exemplo: "Relatório de carbono da empresa".
DATASET é o nome do recurso do
google_bigquery_dataset
Terraform a usar como o conjunto de dados de destino para a exportação.BILLING_ACCOUNT_IDS é o ID da conta de faturação ou uma lista de IDs de contas de faturação separados por vírgulas. Por exemplo:
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
A configuração de transferência foi criada e vai exportar dados no dia 15 de cada mês futuro.
A configuração de transferência não exporta automaticamente dados do histórico. Para pedir dados do histórico desde janeiro de 2021, agende um preenchimento de dados através dos seguintes passos.
Consola
Siga os passos seguintes para agendar o preenchimento de dados:
- Aceda aos detalhes da transferência que acabou de criar.
- Clique em Agendar preenchimento.
- Selecione Executar para um intervalo de datas.
- Selecione 15 de fevereiro de 2021 como a data de início e a data atual como a data de fim. Tenha em atenção que a exportação de 15 de fevereiro de 2021 contém os dados de janeiro de 2021 e, por isso, é o mês mais antigo disponível para pedido.
- Clique em OK para pedir o preenchimento de dados.
Os preenchimentos de dados vão ser criados para o intervalo selecionado, exportando dados mensais do histórico para o conjunto de dados de destino.
bq
Use o comando bq mk --transfer_run
para criar um preenchimento:
bq mk \ --transfer_run \ --start_time=START_TIME \ --end_time=END_TIME \ CONFIG
Onde:
- START_TIME é uma indicação de tempo
que especifica a hora de início do intervalo a preencher.
Por exemplo:
2021-02-15T00:00:00Z
. Tenha em atenção que 15 de fevereiro de 2021 é a data mais antiga que pode especificar aqui, uma vez que contém os dados de janeiro de 2021. - END_TIME é uma data/hora
que especifica a hora de fim do intervalo a preencher.
Por exemplo:
2022-09-15T00:00:00Z
. Pode usar a data atual. - TRANSFER_CONFIG é o identificador da transferência criada no passo anterior.
Por exemplo:
projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000
.
Depois de exportados, pode usar o BigQuery para ver e consultar os dados. Leia mais acerca do esquema de dados.
Pode partilhar os dados exportados com outras pessoas na sua organização concedendo-lhes a função do IAM de utilizador do BigQuery no projeto selecionado anteriormente. Em alternativa, pode conceder acesso detalhado ao nível do conjunto de dados ou da tabela através da função de IAM Visualizador de dados do BigQuery.
Gerir exportações da pegada de carbono
Pode ver todas as exportações de pegada de carbono existentes clicando em Exportação de dados e abrindo o painel lateral.
Em seguida, pode gerir cada exportação de pegada de carbono clicando no nome da transferência para visitar o Serviço de transferência de dados do BigQuery ou no nome do conjunto de dados para ver o conjunto de dados de destino. Saiba mais sobre como trabalhar com transferências.
Exportar para o Google Sheets ou CSV
Depois de configurar a exportação da pegada de carbono para o BigQuery e a exportação agendada estiver concluída, pode exportar esses dados do BigQuery para o Google Sheets ou CSV.
- Aceda ao BigQuery
- No painel Explorador, expanda o projeto e o conjunto de dados e, de seguida, selecione a tabela que contém os dados da pegada de carbono exportados.
- Clique em Consulta.
- Introduza uma consulta para devolver os dados que quer exportar. Veja abaixo um exemplo.
- Depois de executar a consulta, em Resultados da consulta, clique em Guardar resultados.
- Selecione o formato pretendido e clique em Guardar.
A seguinte consulta permite-lhe guardar todo o conteúdo da tabela exportada:
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
O que se segue?
- Leia acerca do esquema de dados usado na exportação.
- Explore a sua pegada de carbono bruta na Google Cloud consola.
- Crie painéis de controlo personalizados com os dados exportados.
- Compreenda a metodologia por detrás da Pegada de carbono.