Vista INFORMATION_SCHEMA.INSIGHTS

Para pedir feedback ou apoio técnico para esta funcionalidade, envie um email para bq-recommendations+feedback@google.com.

A vista INFORMATION_SCHEMA.INSIGHTS contém estatísticas sobre todas as recomendações do BigQuery no projeto atual. O BigQuery obtém estatísticas para todos os tipos de estatísticas do BigQuery a partir do centro de recomendações e apresenta-as nesta vista. As estatísticas do BigQuery estão sempre associadas a uma recomendação.

A vista INFORMATION_SCHEMA.INSIGHTS suporta as seguintes recomendações:

Autorização necessária

Para ver estatísticas com a vista INFORMATION_SCHEMA.INSIGHTS, tem de ter as autorizações necessárias para o recomendador correspondente. A INFORMATION_SCHEMA.INSIGHTS vista só devolve estatísticas de recomendações que tem autorização para ver.

Peça ao administrador para conceder acesso à visualização de estatísticas. Para ver as autorizações necessárias para cada motor de recomendações, consulte o seguinte:

Esquema

A vista INFORMATION_SCHEMA.INSIGHTS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
insight_id STRING ID codificado em Base64 que contém o tipo de estatística e o ID da estatística
insight_type STRING O tipo de estatísticas. Por exemplo, google.bigquery.materializedview.Insight.
subtype STRING O subtipo da estatística.
project_id STRING O ID do projeto.
project_number STRING O número do projeto.
description STRING A descrição sobre a recomendação.
last_updated_time TIMESTAMP Este campo representa a hora em que a estatística foi atualizada pela última vez.
category STRING A categoria de otimização do impacto.
target_resources STRING Nomes de recursos totalmente qualificados que esta estatística está a segmentar.
state STRING O estado da estatística. Para ver uma lista de valores possíveis, consulte Valor.
severity STRING A gravidade da estatística. Para ver uma lista de valores possíveis, consulte Gravidade.
associated_recommendation_ids STRING Nomes completos das recomendações às quais estas estatísticas estão associadas. O nome da recomendação é a representação codificada em Base64 do tipo de recomendador e do ID das recomendações.
additional_details RECORD Detalhes adicionais sobre a estatística.
  • content: conteúdo de estatísticas no formato JSON.
  • state_metadata: metadados sobre o estado da estatística. Contém pares de chave-valor.
  • observation_period_seconds: período de observação para gerar a estatística.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Um ID do projeto é opcional. Se não for especificado um ID do projeto, é usado o projeto no qual a consulta é executada.

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.INSIGHTS[_BY_PROJECT] Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto no seguinte formato: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.INSIGHTS
 Substitua o seguinte:

  • PROJECT_ID: o ID do projeto.
  • REGION_NAME: a região do seu projeto.

Por exemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.INSIGHTS.

Veja estatísticas ativas com poupanças de custos

O exemplo seguinte junta a vista de estatísticas com a vista de recomendações para devolver 3 recomendações para as estatísticas que estão ATIVAS na categoria COST:

WITH 
 insights as (SELECT * FROM `region-us`.INFORMATION_SCHEMA.INSIGHTS),
 recs as (SELECT recommender, recommendation_id, additional_details FROM `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS)

SELECT  
   recommender,
   target_resources,
   LAX_INT64(recs.additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
   LAX_INT64(recs.additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
   insights.additional_details.observation_period_seconds / 86400 as observation_period_days,
   last_updated_time
FROM 
  insights 
JOIN recs 
ON 
  recommendation_id in UNNEST(associated_recommendation_ids) 
WHERE 
  state = 'ACTIVE' 
AND
  category = 'COST'
LIMIT 3;

O resultado é semelhante ao seguinte:

+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
|                    recommender                    |   target_resource   |  gb_saved_monthly  | slot_hours_saved_monthly | observation_period_days |  last_updated_time  |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
| google.bigquery.table.PartitionClusterRecommender | ["table_resource1"] |   3934.07264107652 |       10.499466666666667 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.table.PartitionClusterRecommender | ["table_resource2"] | 4393.7416711859405 |        56.61476777777777 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.materializedview.Recommender      | ["project_resource"]| 140805.38289248943 |        9613.139166666666 |                     2.0 | 2024-07-01 13:00:31 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+