Visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

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

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

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION supporta i seguenti suggerimenti:

Questa visualizzazione dello schema è disponibile solo per gli utenti con organizzazioni definite Cloud de Confiance by S3NS organizzazioni.

Autorizzazioni obbligatorie

Per visualizzare i suggerimenti con la visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, devi disporre delle autorizzazioni richieste per il recommender corrispondente. La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION restituisce solo i suggerimenti che hai l'autorizzazione a visualizzare. Se disponi delle autorizzazioni richieste per l'organizzazione, puoi visualizzare i suggerimenti per tutti i progetti all'interno di quell'organizzazione, indipendentemente dalle tue autorizzazioni sul progetto stesso.

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

Schema

La visualizzazione INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION ha il seguente schema:

Nome colonna Tipo di dati Valore
recommendation_id STRING ID con codifica Base64 che contiene RecommendationID e recommender.
recommender STRING Il tipo di suggerimento. Ad esempio, google.bigquery.table.PartitionClusterRecommender per i suggerimenti di 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 di risorse completi 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 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 insight. Può essere utilizzato per eseguire query sulla visualizzazione Insights.
additional_details RECORD Dettagli aggiuntivi sul suggerimento.
  • overview: panoramica del suggerimento in formato JSON. Il contenuto di questo campo potrebbe variare in base al recommender.
  • 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 insieme di testo libero impostato dal sistema durante la generazione del suggerimento. Verrà sempre compilato.
    • resource_type: il tipo di risorsa cloud.
    • resource: nome risorsa completo.
    • 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_ORGANIZATION] Livello progetto REGION
Sostituisci quanto segue:
  • (Facoltativo) PROJECT_ID: l'ID del tuo Cloud de Confiance progetto. Se non specificato, viene utilizzato il progetto predefinito.
  • REGION: qualsiasi nome di 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_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

Il seguente esempio restituisce i suggerimenti 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;

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