Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn Sie Feedback oder Unterstützung für dieses Feature benötigen, senden Sie eine E-Mail an [e-mail].

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:

• Partitions- und Clusterempfehlungen
• Empfehlungen für materialisierte Ansichten
• Rollenempfehlungen für BigQuery-Datasets

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

Erforderliche Berechtigungen

Wenn Sie Empfehlungen mit der Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION 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, Zugriff zu gewähren, um die Empfehlungen sehen zu können. Hier finden Sie die erforderlichen Berechtigungen für jeden Recommender:

• Recommender-Empfehlungen für Berechtigungen für Partitionen und Cluster
• Empfehlungen für Berechtigungen für materialisierte Ansichten
• Rollenempfehlungen für Berechtigungen für Datasets

Schema

Die Ansicht INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION hat das folgende Schema:

Spaltenname	Datentyp	Wert
recommendation_id	STRING	Base64-codierte ID, die die RecommendationID und den Recommender 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 diese Empfehlung optimieren möchte. Eine Liste möglicher Werte finden Sie unter Kategorie. cost_projection: Dieser Wert kann ausgefüllt werden, wenn die Empfehlung die Kosteneinsparungen aus dieser Empfehlung prognostizieren 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. Kann zum Abfragen der Insight-Ansicht verwendet werden.
additional_details	RECORD	Weitere Informationen zur Empfehlung. overview: Übersicht über die Empfehlung im JSON-Format. Der Inhalt dieses Felds kann sich je nach Recommender ändern. state_metadata: Metadaten zum Status der Empfehlung in Schlüssel/Wert-Paaren. operations: Liste der Vorgänge, die der Nutzer für die Zielressourcen ausführen kann. Dieser umfasst 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 wird. 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: beliebiger Dataset-Regionsname. Beispiel: region-us

Hinweis: Zum Abfragen von INFORMATION_SCHEMA-Ansichten müssen Sie einen Regions-Qualifier verwenden. Der Ort der Abfrageausführung muss mit der Region der Ansicht INFORMATION_SCHEMA übereinstimmen.

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

. Dabei gilt:

• 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;

Hinweis: Bei Ansichtsnamen vom Typ INFORMATION_SCHEMA wird zwischen Groß- und Kleinschreibung unterschieden.

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