Visualizzazione INFORMATION_SCHEMA.INSIGHTS

Per richiedere 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 insight per tutti i tipi di insight di BigQuery dall'hub di consigli e li presenta in questa visualizzazione. Gli insight di BigQuery sono sempre associati a un consiglio.

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 consigli per i quali hai l'autorizzazione di visualizzazione.

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

Schema

La vista INFORMATION_SCHEMA.INSIGHTS ha lo schema seguente:

Nome colonna Tipo di dati Valore
insight_id STRING ID codificato in Base64 contenente il tipo di informazione e l'ID informazione
insight_type STRING Il tipo di approfondimento. Ad esempio, google.bigquery.materializedview.Insight.
subtype STRING Il sottotipo dell'approfondimento.
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 indica l'ora dell'ultimo aggiornamento dell'approfondimento.
category STRING La categoria di ottimizzazione dell'impatto.
target_resources STRING Nomi completi delle risorse di destinazione dell'approfondimento.
state STRING Lo stato dell'approfondimento. Per un elenco dei valori possibili, consulta Valore.
severity STRING La gravità dell'informazione. Per un elenco dei possibili valori, consulta Gravità.
associated_recommendation_ids STRING I nomi completi dei consigli a cui è associato questo insight. Il nome del consiglio è la rappresentazione codificata Base64 del tipo di consiglio e dell'ID dei consigli.
additional_details RECORD Ulteriori dettagli sull'approfondimento.
  • content: contenuti degli approfondimenti in formato JSON.
  • state_metadata: metadati relativi allo stato dell'approfondimento. Contiene coppie chiave-valore.
  • observation_period_seconds: periodo di osservazione per la generazione dell'approfondimento.

Ambito e sintassi

Le query su questa visualizzazione devono includere un qualificatore regione. Un 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 progetto Google Cloud. 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.

    Visualizza approfondimenti attivi con risparmi sui costi

    L'esempio seguente 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 |
    +---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+