Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Wenn Sie Feedback oder Unterstützung für dieses Feature benötigen, senden Sie eine E-Mail an bq-recommendations+feedback@google.com.

Die Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION enthält Daten zu allen BigQuery-Empfehlungen für alle Projekte in der aktuellen Organisation.

Die Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION unterstützt die folgenden Empfehlungen:

Diese Schemaansicht ist nur für Nutzer mit definierten Google Cloud-Organisationen verfügbar.

Erforderliche Berechtigungen

Wenn Sie Empfehlungen in der INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION-Ansicht aufrufen möchten, benötigen Sie die erforderlichen Berechtigungen für den entsprechenden Recommender. In der Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION werden nur Empfehlungen zurückgegeben, für die Sie die Berechtigung zum Ansehen haben. Wenn Sie die erforderlichen Berechtigungen für die Organisation haben, können Sie sich Empfehlungen für alle Projekte innerhalb dieser Organisation ansehen, unabhängig von Ihren Berechtigungen für das Projekt selbst.

Bitten Sie Ihren Administrator, Ihnen Zugriff zu gewähren, damit Sie die Empfehlungen sehen können. Informationen zu den erforderlichen Berechtigungen für die einzelnen Recommender finden Sie unter den folgenden Links:

Schema

Die Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION hat das folgende Schema:

Spaltenname Datentyp Wert
recommendation_id STRING Base64-codierte ID, die die Empfehlungs-ID und den Empfehlungsgeber enthält.
recommender STRING Der Empfehlungstyp. Beispiel: google.bigquery.table.PartitionClusterRecommender für Partitionierungs- und Clustering-Empfehlungen.
subtype STRING Der Untertyp der Empfehlung.
project_id STRING Die ID des Projekts.
project_number STRING Die Nummer des Projekts.
description STRING Die Beschreibung der Empfehlung.
last_updated_time TIMESTAMP Dieses Feld gibt an, wann die Empfehlung zuletzt erstellt wurde.
target_resources STRING Vollständig qualifizierte Ressourcennamen, auf die diese Empfehlung ausgerichtet ist.
state STRING Der Status der Empfehlung. Eine Liste der möglichen Werte finden Sie unter Status.
primary_impact RECORD Die Auswirkungen dieser Empfehlung bei der Optimierung der Hauptkategorie. Enthält die folgenden Felder:
  • category: Die Kategorie, die mit dieser Empfehlung optimiert werden soll. Eine Liste möglicher Werte finden Sie unter Kategorie.
  • cost_projection: Dieser Wert kann angegeben werden, wenn die Empfehlung die Kosteneinsparungen durch diese Empfehlung projizieren kann. Nur vorhanden, wenn die Kategorie COST ist.
  • security_projection: Kann vorhanden sein, wenn die Kategorie SECURITY ist.
priority STRING Die Priorität der Empfehlung. Eine Liste der möglichen Werte finden Sie unter Priorität.
associated_insight_ids STRING Vollständige Statistiknamen, die mit der Empfehlung verknüpft sind.Der Statistikname ist die Base64-codierte Darstellung des Namens des Statistiktyps und der Statistik-ID. Damit können Sie die Statistikansicht abfragen.
additional_details RECORD Weitere Informationen zur Empfehlung.
  • overview: Übersicht über die Empfehlung im JSON-Format. Der Inhalt dieses Felds kann je nach Empfehlungsquelle variieren.
  • state_metadata: Metadaten zum Status der Empfehlung in Schlüssel/Wert-Paaren.
  • operations: Liste der Vorgänge, die der Nutzer an den Zielressourcen ausführen kann. Sie enthält die folgenden Felder:
    • action: Die Art der Aktion, die der Nutzer ausführen muss. Dies kann ein Freitext sein, der vom System beim Generieren der Empfehlung festgelegt wurde. Wird immer ausgefüllt.
    • resource_type: Der Cloud-Ressourcentyp.
    • resource: Vollständig qualifizierter Ressourcenname.
    • path: Pfad des Zielfelds relativ zur Ressource.
    • value: Wert des Pfadfelds.

Bereich und Syntax

Für Abfragen dieser Ansicht muss ein Regions-Qualifier verwendet werden. Die Projekt-ID ist optional. Wenn keine Projekt-ID angegeben ist, wird das Projekt verwendet, in dem die Abfrage ausgeführt wird.

Ansichtsname Ressourcenbereich Regionsbereich
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_ORGANIZATION] Projektebene REGION
Ersetzen Sie Folgendes:

  • Optional: PROJECT_ID: die ID Ihres Google Cloud-Projekts. Wenn keine Angabe erfolgt, wird das Standardprojekt verwendet.

  • REGION: ist ein beliebiger Dataset-Regionsname. Beispiel: `region-us`

    • Beispiel

    Wenn Sie die Abfrage für ein anderes Projekt als Ihr Standardprojekt ausführen möchten, fügen Sie die Projekt-ID im folgenden Format hinzu: 

    `PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
     Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts.
    • REGION_NAME: Region für Ihr Projekt

    Beispiel: `myproject`.`region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION.

    Empfehlungen für materialisierte Ansichten in der Organisation ansehen

    Im folgenden Beispiel werden Empfehlungen für materialisierte Ansichten in der Organisation zurückgegeben:

    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;

    Das Ergebnis sieht etwa so aus:

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