Visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Per richiedere assistenza o feedback per questa funzione, invia un'email a bq-recommendations+feedback@google.com.

La vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION contiene i dati su tutti i consigli di BigQuery per tutti i progetti dell'organizzazione corrente.

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION supporta i seguenti consigli:

Questa visualizzazione dello schema è disponibile solo per gli utenti con organizzazioni Google Cloud definite.

Autorizzazioni obbligatorie

Per visualizzare i consigli con INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, devi avere le autorizzazioni necessarie per il motore per suggerimenti corrispondente. La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION restituisce solo i consigli per i quali hai l'autorizzazione di visualizzazione. Se disponi delle autorizzazioni richieste per l'organizzazione, puoi visualizzare i consigli per tutti i progetti al suo interno, indipendentemente dalle autorizzazioni che disponi per il progetto stesso.

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

Schema

La vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION ha lo schema seguente:

Nome colonna Tipo di dati Valore
recommendation_id STRING ID codificato Base64 che contiene il RecommendationID e il motore per suggerimenti.
recommender STRING Il tipo di suggerimento. Ad esempio, google.bigquery.table.PartitionClusterRecommender per suggerimenti su 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 suggerimento.
last_updated_time TIMESTAMP Questo campo indica la data e l'ora dell'ultima creazione del consiglio.
target_resources STRING Nomi completi delle risorse di destinazione del suggerimento.
state STRING Lo stato del suggerimento. Per un elenco dei possibili valori, vedi Stato.
primary_impact RECORD L'impatto che questo suggerimento può avere quando si cerca di ottimizzare la categoria principale. Contiene i seguenti campi:
  • category: la categoria che questo consiglio sta cercando di ottimizzare. Per un elenco dei possibili valori, consulta la sezione Categoria.
  • cost_projection: questo valore può essere inserito se il consiglio può prevedere il risparmio sui costi. 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 possibili valori, consulta Priorità.
associated_insight_ids STRING Nomi di insight completi associati al suggerimento.Il nome di insight è la rappresentazione codificata in Base64 del nome del tipo di insight e l'ID insight. Può essere utilizzata per eseguire query sulla vista Approfondimenti.
additional_details RECORD Ulteriori dettagli sul consiglio.
  • overview: panoramica del suggerimento in formato JSON. I contenuti di questo campo potrebbero cambiare in base al motore per suggerimenti.
  • state_metadata: metadati sullo stato del suggerimento nelle coppie chiave-valore.
  • operations: elenco delle operazioni che l'utente può eseguire sulle risorse di destinazione. Questo file 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 consiglio. Verrà sempre compilato.
    • resource_type: il tipo di risorsa cloud.
    • resource: nome completo della risorsa.
    • path: percorso del campo target rispetto alla risorsa.
    • value: valore del campo del percorso.

Ambito e sintassi

Le query relative a questa vista 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 della regione
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_ORGANIZATION] Livello progetto REGION
Sostituisci quanto segue:

  • Facoltativo: PROJECT_ID: l'ID del tuo progetto Google Cloud. Se non viene specificato, viene utilizzato il progetto predefinito.

Esempio

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

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

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

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

Visualizza suggerimenti sulle viste materializzate nell'organizzazione

L'esempio seguente restituisce i consigli sulle viste materializzate nell'organizzazione:

SELECT
  project_id,
  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_ORGANIZATION
WHERE
  recommender = 'google.bigquery.materializedview.Recommender'
LIMIT 3;

Il risultato è simile al seguente:

+-------------------------------+----------------------------------------------------------------------+
|          project_id           | est_gb_saved_monthly| slot_hours_saved_monthly |  last_updated_time  |
+-------------------------------+----------------------------------------------------------------------+
| project1                      |   4689.071544663957 |       2682.1816833333337 | 2024-07-01 13:00:31 |
| project2                      |   137.5052567309467 |        9613.139166666666 | 2024-07-01 13:00:31 |
| project3                      |  146.83722260318973 |        7093.014316666667 | 2024-07-01 13:00:31 |
+-------------------------------+----------------------------------------------------------------------+