Visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS

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

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS contiene dati su tutti i consigli di BigQuery nel progetto corrente. BigQuery recupera i suggerimenti per tutti i recommender BigQuery da Recommendation Hub e li presenta in questa visualizzazione.

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS supporta i seguenti consigli:

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS mostra solo i suggerimenti correlati a BigQuery. Puoi visualizzare i Trusted Cloud by S3NS suggerimenti nell'hub dei suggerimenti.

Autorizzazione obbligatoria

Per visualizzare i suggerimenti con la visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS, devi disporre delle autorizzazioni necessarie per il recommender corrispondente. La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS restituisce solo i suggerimenti che hai l'autorizzazione a visualizzare.

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

Schema

La vista INFORMATION_SCHEMA.RECOMMENDATIONS ha lo schema seguente:

Nome colonna Tipo di dati Valore
recommendation_id STRING ID con codifica Base64 che contiene RecommendationID e il sistema di raccomandazione.
recommender STRING Il tipo di consiglio. Ad esempio, google.bigquery.table.PartitionClusterRecommender per i suggerimenti di partizionamento e clustering.
subtype STRING Il sottotipo del consiglio.
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 in cui è stata creata l'ultima raccomandazione.
target_resources STRING Nomi delle risorse completi a cui è destinato questo suggerimento.
state STRING Lo stato del suggerimento. Per un elenco dei valori possibili, vedi Stato.
primary_impact RECORD L'impatto che questo consiglio può avere quando si tenta di ottimizzare la categoria principale. Contiene i seguenti campi:
  • category: la categoria che questo suggerimento sta cercando di ottimizzare. Per un elenco dei valori possibili, vedi Categoria.
  • cost_projection: questo valore può essere compilato se il suggerimento può prevedere il risparmio sui costi derivante da questo suggerimento. Presente solo quando la categoria è COST.
  • security_projection: potrebbe essere presente quando la categoria è SECURITY.
priority STRING La priorità del consiglio. Per un elenco dei valori possibili, vedi Priorità.
associated_insight_ids STRING Nomi completi degli insight associati al consiglio.Il nome dell'insight è la rappresentazione con codifica Base64 del nome del tipo di insight e dell'ID insight. Può essere utilizzato per eseguire query sulla visualizzazione Insights.
additional_details RECORD Ulteriori dettagli sul consiglio.
  • overview: Panoramica del consiglio in formato JSON. Il contenuto di questo campo potrebbe variare in base al sistema di raccomandazione.
  • state_metadata: Metadati sullo stato del suggerimento in coppie chiave-valore.
  • operations: Elenco delle operazioni che l'utente può eseguire sulle risorse di destinazione. Contiene i seguenti campi:
    • action: il tipo di azione che l'utente deve eseguire. Può trattarsi di un testo libero impostato dal sistema durante la generazione del consiglio. Verrà sempre compilato.
    • resource_type: il tipo di risorsa cloud.
    • resource: il nome risorsa completo.
    • path: il percorso del campo di destinazione rispetto alla risorsa.
    • value: Valore del campo percorso.

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.RECOMMENDATIONS[_BY_PROJECT] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Trusted 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.RECOMMENDATIONS
Sostituisci quanto segue:

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

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

Visualizzare i principali consigli per risparmiare sui costi

L'esempio seguente restituisce i primi tre suggerimenti per la categoria COST in base alla slot_hours_saved_monthly prevista:

SELECT 
   recommender,
   target_resources,
   LAX_INT64(additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
    LAX_INT64(additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
  last_updated_time
FROM 
  `region-us`.
   INFORMATION_SCHEMA.RECOMMENDATIONS_BY_PROJECT
WHERE 
   primary_impact.category = 'COST'
AND
   state = 'ACTIVE'
ORDER by 
   slot_hours_saved_monthly DESC 
LIMIT 3;

Il risultato è simile al seguente:

+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|                    recommender                    |   target_resources      | est_gb_saved_monthly | slot_hours_saved_monthly |  last_updated_time
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
| google.bigquery.materializedview.Recommender      | ["project_resource"]    | 140805.38289248943   |        9613.139166666666 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_1"]    | 4393.7416711859405   |        56.61476777777777 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_2"]    |   3934.07264107652   |       10.499466666666667 |  2024-07-01 13:00:00
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+