Visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per richiedere feedback o assistenza per questa funzionalità, invia un'email a [e-mail].

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS contiene dati su tutti i suggerimenti di BigQuery nel progetto corrente. BigQuery recupera i suggerimenti per tutti i suggeritori di BigQuery da Active Assist e li presenta in questa visualizzazione.

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS supporta i seguenti suggerimenti:

• Suggerimenti per partizioni e cluster
• Suggerimenti per le viste materializzate
• Suggerimenti sui ruoli per i set di dati BigQuery

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS mostra solo i suggerimenti relativi a BigQuery. Puoi visualizzare Google Cloud i suggerimenti in Active Assist.

Autorizzazione obbligatoria

Per visualizzare i suggerimenti con la visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS, devi disporre delle autorizzazioni necessarie per il suggeritore 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 suggerimenti. Per visualizzare le autorizzazioni richieste per ogni suggeritore, consulta quanto segue:

• Autorizzazioni del motore per suggerimenti per partizioni e cluster
• Autorizzazioni per i suggerimenti sulle viste materializzate
• Autorizzazioni per i suggerimenti sui ruoli per i set di dati

Schema

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS ha il seguente schema:

Nome colonna	Tipo di dati	Valore
recommendation_id	STRING	ID con codifica Base64 che contiene RecommendationID e motore per suggerimenti.
recommender	STRING	Il tipo di suggerimento. Ad esempio, google.bigquery.table.PartitionClusterRecommender per i suggerimenti per partizionamento e clustering.
subtype	STRING	Il sottotipo del suggerimento.
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'ultima volta in cui è stato creato il suggerimento.
target_resources	STRING	Nomi completi delle risorse a cui è destinato questo suggerimento.
state	STRING	Lo stato del suggerimento. Per un elenco dei valori possibili, consulta Stato.
primary_impact	RECORD	L'impatto che questo suggerimento 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, consulta Categoria. cost_projection: questo valore può essere compilato se il suggerimento può proiettare 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 suggerimento. Per un elenco dei valori possibili, consulta Priorità.
associated_insight_ids	STRING	Nomi completi degli insight associati al suggerimento. Il nome dell'insight è la rappresentazione con codifica Base64 del nome del tipo di approfondimento e dell'ID dell'insight. Può essere utilizzato per eseguire query sulla visualizzazione Insight.
additional_details	RECORD	Dettagli aggiuntivi sul suggerimento. overview: panoramica del suggerimento in formato JSON. Il contenuto di questo campo potrebbe variare in base al suggeritore. 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ò essere un testo libero impostato dal sistema durante la generazione del suggerimento. Verrà sempre compilato. resource_type: il tipo di risorsa cloud. resource: nome completo della risorsa. path: percorso del campo di destinazione relativo alla risorsa. value: valore del campo del percorso.

Per garantire la stabilità, ti consigliamo di elencare esplicitamente le colonne nelle query dello schema informativo 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. 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.RECOMMENDATIONS[_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 di regione del set di dati. Ad esempio, `region-us`.
  Nota: devi utilizzare un qualificatore di regione per eseguire query sulle visualizzazioni INFORMATION_SCHEMA. La località di esecuzione della query deve corrispondere alla regione della visualizzazione INFORMATION_SCHEMA.

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 tuo progetto.

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

Visualizzare i principali suggerimenti per il risparmio sui costi

Il seguente esempio restituisce i primi tre suggerimenti della categoria COST in base a slot_hours_saved_monthly previsto:

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;

Nota: INFORMATION_SCHEMA i nomi delle visualizzazioni sono sensibili alle maiuscole.

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