Visualizzazione INFORMATION_SCHEMA.INSIGHTS

Per richiedere un feedback o assistenza per questa funzionalità, invia un'email all'indirizzo bq-recommendations+feedback@google.com.

La visualizzazione INFORMATION_SCHEMA.INSIGHTS contiene approfondimenti su tutti i suggerimenti di BigQuery nel progetto corrente. BigQuery recupera gli approfondimenti per tutti i tipi di approfondimenti BigQuery da Active Assist e li presenta in questa visualizzazione. Gli insight di BigQuery sono sempre associati a un suggerimento.

La visualizzazione INFORMATION_SCHEMA.INSIGHTS supporta i seguenti consigli:

Autorizzazione obbligatoria

Per visualizzare gli approfondimenti con la visualizzazione INFORMATION_SCHEMA.INSIGHTS, devi disporre delle autorizzazioni richieste per il recommender corrispondente. La visualizzazione INFORMATION_SCHEMA.INSIGHTS restituisce solo gli approfondimenti dei suggerimenti che hai l'autorizzazione a visualizzare.

Chiedi all'amministratore di concedere l'accesso per visualizzare gli approfondimenti. Per visualizzare le autorizzazioni richieste per ogni sistema di raccomandazione, consulta quanto segue:

Schema

La vista INFORMATION_SCHEMA.INSIGHTS ha lo schema seguente:

Nome colonna Tipo di dati Valore
insight_id STRING ID con codifica Base64 che contiene il tipo di insight e l'ID insight
insight_type STRING Il tipo di approfondimento. Ad esempio, google.bigquery.materializedview.Insight.
subtype STRING Il sottotipo dell'insight.
project_id STRING L'ID del progetto.
project_number STRING Il numero del progetto.
description STRING La descrizione del consiglio.
last_updated_time TIMESTAMP Questo campo rappresenta l'ora dell'ultimo aggiornamento dell'approfondimento.
category STRING La categoria di ottimizzazione dell'impatto.
target_resources STRING Nomi risorsa completi a cui è destinato questo approfondimento.
state STRING Lo stato dell'approfondimento. Per un elenco dei valori possibili, vedi Valore.
severity STRING La gravità dell'approfondimento. Per un elenco dei valori possibili, vedi Gravità.
associated_recommendation_ids STRING I nomi completi dei suggerimenti a cui è associato questo insight. Il nome del suggerimento è la rappresentazione con codifica Base64 del tipo di motore per suggerimenti e dell'ID dei suggerimenti.
additional_details RECORD Ulteriori dettagli sull'insight.
  • content: contenuti dell'approfondimento in formato JSON.
  • state_metadata: Metadati sullo stato dell'insight. Contiene coppie chiave-valore.
  • observation_period_seconds: il periodo di osservazione per la generazione dell'insight.

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore di regione. L'ID progetto è facoltativo. Se non viene specificato alcun ID progetto, viene utilizzato il progetto in cui viene eseguita la query.

Nome vista Ambito risorsa Ambito regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.INSIGHTS[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Google Cloud progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Esempio

Per eseguire la query su un progetto diverso da quello predefinito, aggiungi l'ID progetto nel seguente formato: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.INSIGHTS
 Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • REGION_NAME: la regione del progetto.

Ad esempio, `myproject`.`region-us`.INFORMATION_SCHEMA.INSIGHTS.

Visualizzare gli approfondimenti attivi con risparmi sui costi

L'esempio seguente unisce la visualizzazione degli approfondimenti a quella dei consigli per restituire tre consigli per gli approfondimenti ATTIVI nella categoria COSTO:

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;

Il risultato è simile al seguente:

+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
|                    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 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+