Visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

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

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:

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

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

Autorizzazioni obbligatorie

Per visualizzare i consigli con la visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, devi disporre delle autorizzazioni necessarie per il recommender 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 di cui 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:

• Autorizzazioni del recommender per partizioni e cluster
• Autorizzazioni per i suggerimenti sulle viste materializzate
• Consigli sui ruoli per le autorizzazioni dei set di dati

Schema

La vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION ha lo schema seguente:

Nome colonna	Tipo di dati	Valore
recommendation_id	STRING	ID con codifica Base64 che contiene RecommendationID e il recommender.
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 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 consiglio. Per un elenco dei possibili valori, consulta 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 consiglio sta cercando di ottimizzare. Per un elenco dei valori possibili, consulta 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 completi degli approfondimenti associati al consiglio.Il nome dell'approfondimento è la rappresentazione con codifica Base64 del nome del tipo di approfondimento e dell'ID approfondimento. Può essere utilizzato per eseguire query sulla visualizzazione Approfondimenti.
additional_details	RECORD	Ulteriori dettagli sul consiglio. overview: panoramica del consiglio in formato JSON. I contenuti di questo campo potrebbero variare in base al recommender. state_metadata: metadati relativi allo stato del consiglio in coppie chiave/valore. operations: elenco delle operazioni che l'utente può eseguire sulle risorse target. che 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 risorsa completo. path: percorso del campo target rispetto alla risorsa. value: valore del campo percorso.

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

REGION: qualsiasi nome della regione del set di dati. Ad esempio: `region-us`.

Nota: per eseguire query sulle visualizzazioni INFORMATION_SCHEMA, devi utilizzare un qualificatore di regione. La posizione dell'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_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.

Visualizzare i suggerimenti sulle viste materializzate nell'organizzazione

L'esempio seguente restituisce i consigli sulle vista materializzata 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;

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

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