Vista 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 suggerimenti:

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 solo visualizzazione restituisce solo gli approfondimenti dei suggerimenti per i quali disponi dell'autorizzazione di visualizzazione.

Chiedi all'amministratore di concedere l'accesso per visualizzare gli approfondimenti. Per visualizzare le autorizzazioni richieste per ogni motore per suggerimenti, 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 approfondimento e l'ID approfondimento
insight_type STRING Il tipo di insight. 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 suggerimento.
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 delle risorse 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.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema delle informazioni anziché utilizzare un carattere jolly (SELECT *). L'elenco esplicito delle colonne impedisce l'interruzione delle query se lo schema sottostante cambia.

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

Il seguente esempio unisce la visualizzazione degli approfondimenti con la visualizzazione 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 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+