Diese Seite wurde von der Cloud Translation API übersetzt.

Abfragestatistiken verwenden, um die Abfrageleistung zu verbessern

MySQL | PostgreSQL | SQL Server

Auf dieser Seite wird beschrieben, wie Sie mit dem Query Insights-Dashboard Leistungsprobleme erkennen und analysieren.

Einleitung

Mit Query Insights können Sie Leistungsprobleme bei Abfragen für Cloud SQL-Datenbanken erkennen, diagnostizieren und verhindern. Es unterstützt ein intuitives Monitoring und liefert Diagnoseinformationen, die Ihnen helfen, über die Erkennung hinaus die Ursache von Leistungsproblemen zu identifizieren.

Mit Query Insights können Sie die Leistung von Cloud SQL-Abfragen verbessern. Dabei werden Sie durch die folgenden Schritte geführt:

Statistiken für Cloud SQL Enterprise Plus abfragen

Wenn Sie die Cloud SQL Enterprise Plus-Version verwenden, können Sie unter „Abfragestatistiken“ auf zusätzliche Funktionen zugreifen, um erweiterte Diagnosen zur Abfrageleistung durchzuführen. Zusätzlich zu den Standardfunktionen des Query Insights-Dashboards können Sie mit Query Insights für die Cloud SQL Enterprise Plus-Version Folgendes tun:

Längerer Suchanfragetext (bis zu 20 KB)
Messwerte 30 Tage lang aufbewahren
Indexempfehlungen vom Indexberater erhalten
Sitzung in aktiven Abfragen beenden

In der folgenden Tabelle werden die funktionalen Anforderungen und Funktionen von Abfragestatistiken für die Cloud SQL Enterprise-Version mit denen der Cloud SQL Enterprise Plus-Version verglichen.

Vergleichsbereich	Statistiken für die Cloud SQL Enterprise-Version abfragen	Statistiken für Cloud SQL Enterprise Plus abfragen
Unterstützte Datenbankversionen	Alle Versionen der folgenden Instanzen: SQL Server Web SQL Server Standard SQL Server Enterprise Query Insights wird in Instanzen der SQL Server Express-Version nicht unterstützt	SQL Server Enterprise Version 2019 oder 2022
Unterstützte Maschinentypen	Unterstützt auf allen Maschinentypen	Nicht unterstützt bei Instanzen mit Maschinentyp mit gemeinsam genutztem Kern
Unterstützte Regionen	Standortorte von Cloud SQL	Standortregionen für Cloud SQL Enterprise Plus
Aufbewahrungsdauer von Messwerten	7 Tage	30 Tage
Maximales Limit für die Abfragelänge	4.500 Byte	20 KB
Empfehlungen des Indexberaters	Nicht verfügbar	Verfügbar
Sitzungen in aktiven Abfragen beenden	Nicht verfügbar	Verfügbar

Wenn Sie Query Insights für die Cloud SQL Enterprise Plus-Version in der Vorabversion für Ihre Cloud SQL Enterprise Plus-Instanz aktivieren möchten, folgen Sie der Anleitung unter Query Insights für die Cloud SQL Enterprise Plus-Version aktivieren.

Preise

Für Suchanfrage-Statistiken fallen keine zusätzlichen Kosten an. Außerdem ist es kostenlos, Abfragestatistiken für die Cloud SQL Enterprise Plus-Version zu aktivieren, die sich derzeit in der Vorabversion befindet.

Speicherbedarf

Für Abfragestatistiken werden Messwertdaten in der Instanz gespeichert. Dazu muss die Einstellung für die automatische Speichererweiterung aktiviert bleiben. Es gelten die geltenden Speichergebühren.

Hinweise

Führen Sie die folgenden Schritte aus, bevor Sie Suchanfrage-Statistiken verwenden:

Fügen Sie die erforderlichen Rollen und Berechtigungen hinzu.
Achten Sie darauf, dass Automatische Speichererhöhungen aktivieren für die Instanz aktiviert ist.

Erforderliche Rollen und Berechtigungen

Wenn Sie Suchanfrage-Statistiken verwenden möchten, müssen Sie Rollen mit den erforderlichen Identity and Access Management-Berechtigungen gewähren oder einem Nutzerkonto die erforderlichen Berechtigungen zuweisen.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, in dem die Cloud SQL-Instanz gehostet wird, um die Berechtigungen zu erhalten, die Sie zum Zugriff auf Verlaufsdaten zur Abfrageausführung im Dashboard „Abfragestatistiken“ benötigen:

Database Insights Monitoring Viewer (roles/databaseinsights.monitoringViewer)
Cloud SQL Viewer (roles/cloudsql.viewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Zugriff auf Verlaufsdaten zur Abfrageausführung im Dashboard „Abfragestatistiken“ erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um auf Verlaufsdaten zur Abfrageausführung im Dashboard „Statistiken zu Abfragen“ zuzugreifen:

databaseinsights.aggregatedStats.query
databaseinsights.timeSeries.query

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

In Database Insights können Sie Ihren Administrator beispielsweise bitten, Ihnen die vordefinierte Rolle Database Insights-Betrachter (roles/databaseinsights.viewer) zuzuweisen. Anschließend können Sie Ihren Administrator in Cloud SQL bitten, Ihnen eine der folgenden vordefinierten Rollen zu gewähren:

Cloud SQL Editor (roles/cloudsql.editor)
Cloud SQL-Administrator (roles/cloudsql.admin)

Automatische Speichererhöhungen aktivieren

Die Instanzeinstellung für automatische Speichererhöhungen muss aktiviert bleiben.

Wenn Sie diese Instanzeinstellung zuvor deaktiviert haben, aktivieren Sie die automatische Speichererweiterung wieder, bevor Sie Query Insights aktivieren.

Abfragestatistiken aktivieren

Nutzer mit Zugriff auf das Cloud SQL-Dashboard können auf Query Insights-Messwerte zugreifen. Wenn Sie berechtigt sind, Instanzen zu aktualisieren, können Sie Query Insights aktivieren. Eine Liste der für Cloud SQL-Instanzen erforderlichen Berechtigungen finden Sie unter Cloud SQL-Projektzugriffssteuerung. Wenn Sie diese Berechtigungen nicht haben und Query Insights für Ihre Instanzen aktivieren möchten, wenden Sie sich an Ihren Administrator.

Console

Abfragestatistiken für eine Instanz aktivieren

Rufen Sie in der Google Cloud -Konsole die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie in der Kachel Konfiguration auf Konfiguration bearbeiten.
Maximieren Sie im Bereich Instanz anpassen den Eintrag Query Insights.
Klicken Sie das Kästchen Query Insights aktivieren an.
Optional. Wählen Sie eine oder mehrere der folgenden zusätzlichen Funktionen für Query Insights aus:

Abfragelänge anpassen

Standardwert: 1024

Legt die maximale Länge der Abfragelänge auf einen angegebenen Wert von 256 Byte bis 4.500 Byte fest. Höhere Abfragelängen sind hilfreich für analytische Abfragen, erfordern aber auch mehr Arbeitsspeicher. Wenn Sie die Abfragelänge ändern möchten, müssen Sie die Instanz neu starten.

Klicken Sie auf Speichern.

Query Insights für mehrere Instanzen aktivieren

Rufen Sie in der Google Cloud -Konsole die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie in einer beliebigen Zeile auf das Menü Weitere Aktionen .
Wählen Sie Abfragestatistiken aktivieren aus.
Klicken Sie im Dialogfeld das Kästchen Query Insights für mehrere Instanzen aktivieren an.
Klicken Sie auf Aktivieren.
Wählen Sie im nachfolgenden Dialogfeld die Instanzen aus, für die Sie Query Insights aktivieren möchten.
Klicken Sie auf Query Insights aktivieren.
Hinweis: Mit diesem Schritt wird Query Insights für Ihre Instanzen basierend auf der Standardkonfiguration aktiviert.

gcloud

Um Query Insights für eine Cloud SQL-Instanz mithilfe von gcloud zu aktivieren, führen Sie gcloud sql instances patch mit dem Flag --insights-config-query-insights-enabled so aus, nachdem Sie INSTANCE_ID durch die ID der Instanz ersetzt haben.

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled

Verwenden Sie außerdem eines oder mehrere der folgenden optionalen Flags:

--insights-config-query-string-length

Legt die maximale Länge der Abfragelänge auf einen angegebenen Wert von 256 bis 4.500 Byte fest. Die Standardlänge der Abfrage beträgt 1.024 Byte. Höhere Abfragelängen sind hilfreich für analytische Abfragen, erfordern aber auch mehr Arbeitsspeicher. Zum Ändern der Abfragelänge müssen Sie die Instanz neu starten.

Ersetzen Sie Folgendes:

INSIGHTS_CONFIG_QUERY_STRING_LENGTH: Die zu speichernde Länge des Abfragestrings in Byte.
API_TIER_STRING: Die benutzerdefinierte Instanzkonfiguration, die für die Instanz verwendet werden soll.
REGION: Die Region für die Instanz.

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--tier=API_TIER_STRING \
--region=REGION

REST Version 1

Rufen Sie die Methode instances.patch mit den Einstellungen für insightsConfig auf, um Query Insights für eine Cloud SQL-Instanz mithilfe der REST API zu aktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: Die Instanz-ID.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : true } }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Terraform

Wenn Sie Terraform verwenden möchten, um Query Insights für eine Cloud SQL-Instanz zu aktivieren, legen Sie das Flag query_insights_enabled auf true fest.

Sie können auch eines oder mehrere der folgenden optionalen Flags verwenden:

query_string_length: Der Standardwert ist 1024 und Sie können dafür einen Wert zwischen 256 und 4500 in Byte konfigurieren.
record_application_tags: Legen Sie den Wert auf true fest, wenn Sie Anwendungs-Tags aus der Abfrage aufzeichnen möchten.
record_client_address: Legen Sie den Wert auf true fest, wenn Sie die Client-IP-Adresse erfassen möchten.
query_plans_per_minute: Der Standardwert ist 5 und Sie können einen Wert zwischen 5 und 20 konfigurieren.

Beispiel:

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Google Cloud -Projekt anzuwenden.

Cloud Shell vorbereiten

Rufen Sie Cloud Shell auf.
Legen Sie das Standardprojekt Google Cloud fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

Kopieren Sie den Beispielcode in das neu erstellte main.tf.

Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.
Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
Speichern Sie die Änderungen.
Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.
```
terraform init
```
Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:
```
terraform init -upgrade
```

Änderungen anwenden

Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:
```
terraform plan
```
Korrigieren Sie die Konfiguration nach Bedarf.
Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:
```
terraform apply
```
Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.
Öffnen Sie Ihr Google Cloud -Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Google Cloud Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

Messwerte sollten innerhalb von Minuten nach Abschluss der Abfrage in Query Insights verfügbar sein.

Abfragestatistiken für Cloud SQL Enterprise Plus aktivieren

Sie können Query Insights für die Cloud SQL Enterprise Plus-Version in Ihrer Cloud SQL-Instanz nur über die Google Cloud -Console aktivieren.

Rufen Sie in der Google Cloud -Konsole die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Achten Sie darauf, dass im Bereich Speicher das Kästchen Automatische Speichererhöhungen aktivieren angeklickt ist.
Maximieren Sie im Bereich Instanz anpassen den Eintrag Query Insights.
Klicken Sie das Kästchen Enterprise Plus-Funktionen aktivieren an.
Nachdem Sie Query Insights für die Cloud SQL Enterprise Plus-Version aktiviert haben, können Sie die folgenden Felder aktualisieren:
- Abfragelänge anpassen: Hier können Sie die maximale Abfragelänge in Byte angeben. Sie können eine Zahl zwischen 256 und 20480 angeben. Alle Suchstrings, die das angegebene Limit überschreiten, werden bei der Anzeige abgeschnitten. Ein höheres Limit für die Abfragelänge erfordert mehr Arbeitsspeicher. Der Standardwert ist 10240 Byte (10 KB).
Klicken Sie auf Speichern.

Query Insights-Dashboard ansehen

Im Query Insights-Dashboard wird die Abfragelast basierend auf von Ihnen ausgewählten Faktoren angezeigt. Die Abfragelast ist ein Maß für die Gesamtarbeit aller Abfragen in der Instanz im ausgewählten Zeitraum. Das Dashboard bietet eine Reihe von Filtern, mit denen Sie die Abfragelast anzeigen können.

So öffnen Sie das Query Insights-Dashboard:

Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Wählen Sie entweder im linken Navigationsbereich den Tab Query Insights aus oder klicken Sie den Link Zu „Query Insights“ für ausführliche Informationen über Abfragen und zur Leistung.

Das Dashboard "Query Insights" wird geöffnet. Sie sehen dort folgende Informationen zu Ihrer Instanz:

Das Query Insights-Dashboard mit Drop-down-Menüs für Datenbanken. Rechts neben den Drop-down-Menüs gibt es einen Filter zum Festlegen eines Zeitraums.

Datenbanken: Filtert die Abfragelast für eine bestimmte Datenbank oder für alle Datenbanken.
Zeitraum: Filtert die Abfragelast nach Zeiträumen wie 1 Stunde, 6 Stunden, 1 Tag, 7 Tage, 30 Tage oder benutzerdefinierte Zeiträume.
Diagramm zur Datenbanklast: Zeigt das Abfrageladediagramm basierend auf den gefilterten Daten an.
Abfragen und Datenbanken: Filtert die Abfragelast nach einer ausgewählten Abfrage oder einer ausgewählten Datenbank. Siehe Datenbanklast filtern.

Datenbanklast für alle Abfragen ansehen

Die Datenbankabfragelast ist ein Maß für die Arbeit (in CPU-Sekunden), die die ausgeführten Abfragen in der ausgewählten Datenbank im Laufe der Zeit ausführen. Bei jeder ausgeführten Abfrage wird entweder CPU-Ressourcen, E/A-Ressourcen oder Sperren von CPU-Ressourcen verwendet oder darauf gewartet. Die Datenbankabfragelast ist das Verhältnis der Zeit, die von allen innerhalb eines bestimmten Zeitfensters abgeschlossenen Abfragen benötigt wird, zur tatsächlich verstrichenen Zeit.

Das Dashboard „Query Insights“ der obersten Ebene zeigt das Diagramm Datenbanklast nach Ausführungszeit. Mit Drop-down-Menüs im Dashboard können Sie das Diagramm für alle Datenbanken oder eine bestimmte Datenbank filtern.

Hier werden alle ausgeführten Abfragen für eine ausgewählte Datenbank angezeigt.

Die farbigen Linien im Diagramm zeigen die Datenbankauslastung nach Ausführungszeit an. Sehen Sie sich die Grafik an und verwenden Sie die Filteroptionen, um diese Fragen zu untersuchen:

Ist die Abfragelast hoch? Ist eine Spitze oder ein Anstieg im Zeitverlauf zu sehen? Wenn keine hohe Last angezeigt wird, liegt das Problem nicht bei Ihrer Abfrage.
Wie lange war die Last hoch? Ist die Auslastung nur jetzt hoch oder schon seit längerer Zeit? Verwenden Sie die Bereichsauswahl, um verschiedene Zeiträume auszuwählen, um herauszufinden, wie lange das Problem besteht. Heranzoomen, um ein Zeitfenster aufzurufen, in dem Spitzen bei der Abfragelast auftreten. Zoomen Sie heraus, um bis zu einer Woche der Zeitachse anzuzeigen.
Welche Datenbank hat die Auslastung? Wählen Sie im Drop-down-Menü „Datenbanken“ verschiedene Datenbanken aus, um die Datenbanken mit der höchsten Auslastung zu ermitteln.

Datenbanklast filtern

Sie können die Datenbanklast nach Abfragen filtern. Wenn Sie Query Insights für die Cloud SQL Enterprise Plus-Version verwenden, können Sie das Diagramm zur Datenbankauslastung anpassen, um die angezeigten Daten mithilfe einer der folgenden Dimensionen aufzuschlüsseln:

Alle Abfragen
Datenbanken

Wenn Sie das Diagramm für die Datenbankauslastung anpassen möchten, wählen Sie eine Dimension aus dem Drop-down-Menü Datenbankauslastung nach Ausführungszeit aus.

Hauptursachen für die Datenbanklast ansehen

In der Tabelle Top-Dimensionen nach Datenbanklast sehen Sie die Hauptursachen für die Datenbanklast. In der Tabelle Top-Dimensionen nach Datenbanklast sehen Sie die Hauptfaktoren für den Zeitraum und die Dimension, die Sie im Drop-down-Menü des Diagramms Datenbanklast nach Ausführungszeit ausgewählt haben. Sie können den Zeitraum oder die Dimension ändern, um die wichtigsten Beitragenden für eine andere Dimension oder einen anderen Zeitraum aufzurufen.

In der Tabelle Top-Dimensionen nach Datenlast können Sie die folgenden Tabs auswählen.

Tabulatortaste	Beschreibung
Abfragen	Die Tabelle enthält die Top-normalisierten Abfragen nach Gesamtausführungszeit. Für jede Abfrage werden die in den Spalten angezeigten Daten so aufgeführt: Durchschnittliche Ausführungszeit (ms): Die durchschnittliche Zeit für die Ausführung der Abfrage. Gesamtausführungszeit (ms): Die Gesamtausführungszeit der jeweiligen Abfrage. Durchschnittliche zurückgegebene Zeilen: Die durchschnittliche Anzahl der Zeilen, die für die Abfrage abgerufen wurden. Aufrufe: Gibt an, wie oft die Abfrage von der Anwendung aufgerufen wurde.
Datenbanken	Die Tabelle enthält eine Liste der Datenbanken, die im ausgewählten Zeitraum am meisten zur Last beigetragen haben. Durchschn. Zeit in Datenbank (ms): Durchschnittliche Zeit, die die Abfragen in der jeweiligen Datenbank verbracht haben. Gesamtzeit in Datenbank (ms): Die Gesamtausführungszeit der Abfragen in der jeweiligen Datenbank.

Tabulatortaste

Beschreibung

Abfragen

Die Tabelle enthält die Top-normalisierten Abfragen nach Gesamtausführungszeit. Für jede Abfrage werden die in den Spalten angezeigten Daten so aufgeführt:

Durchschnittliche Ausführungszeit (ms): Die durchschnittliche Zeit für die Ausführung der Abfrage.
Gesamtausführungszeit (ms): Die Gesamtausführungszeit der jeweiligen Abfrage.
Durchschnittliche zurückgegebene Zeilen: Die durchschnittliche Anzahl der Zeilen, die für die Abfrage abgerufen wurden.
Aufrufe: Gibt an, wie oft die Abfrage von der Anwendung aufgerufen wurde.

Datenbanken

Die Tabelle enthält eine Liste der Datenbanken, die im ausgewählten Zeitraum am meisten zur Last beigetragen haben.

Durchschn. Zeit in Datenbank (ms): Durchschnittliche Zeit, die die Abfragen in der jeweiligen Datenbank verbracht haben.
Gesamtzeit in Datenbank (ms): Die Gesamtausführungszeit der Abfragen in der jeweiligen Datenbank.

Nach Abfragen filtern

Die Tabelle Abfragen bietet einen Überblick über die Abfragen, die die meisten Abfragelasten verursachen. Die Tabelle enthält alle normalisierten Abfragen für das Zeitfenster und die Optionen, die im Query Insights-Dashboard ausgewählt wurden. Es sortiert Abfragen nach der gesamten Ausführungszeit während des ausgewählten Zeitfensters.

Wählen Sie eine Spaltenüberschrift aus, um die Tabelle zu sortieren. Die Tabelle enthält die folgenden Eigenschaften:

query: Der normalisierte Abfragestring. Standardmäßig werden in Query Insights nur 1.024 Zeichen im Abfragestring angezeigt.
Datenbank: Die Datenbank, für die die Abfrage ausgeführt wurde.
Durchschnittliche Ausführungszeit (ms): Die durchschnittliche Zeit für die Ausführung der Abfrage.
Gesamtausführungszeit (ms): Die Gesamtzeit für die Ausführung der Abfrage.
Aufrufe: Gibt an, wie oft die Anwendung die Abfrage aufgerufen hat.
Durchschnittliche zurückgegebene Zeilen: Die durchschnittliche Anzahl der Zeilen, die für die Abfrage zurückgegeben wurden.

In Query Insights werden nur normalisierte Abfragen gespeichert und angezeigt.

Query Insights deaktivieren

Console

So deaktivieren Sie Query Insights für eine Cloud SQL-Instanz mithilfe der Google Cloud Console:

Rufen Sie in der Google Cloud -Konsole die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie in der Kachel Konfiguration auf Konfiguration bearbeiten.
Erweitern Sie im Abschnitt Konfigurationsoptionen die Option Query Insights.
Entfernen Sie das Häkchen aus dem Kästchen Query Insights aktivieren.
Klicken Sie auf Speichern.

gcloud

Wenn Sie Query Insights für eine Cloud SQL-Instanz mithilfe von gcloud deaktivieren möchten, führen Sie gcloud sql instances patch mit dem Flag --no-insights-config-query-insights-enabled so aus, nachdem Sie INSTANCE_ID durch die ID der Instanz ersetzt haben.

gcloud sql instances patch INSTANCE_ID 

--no-insights-config-query-insights-enabled

REST

Rufen Sie die Methode instances.patch auf, wobei queryInsightsEnabled so auf false gesetzt ist, um Query Insights für eine Cloud SQL-Instanz mithilfe der REST API zu deaktivieren.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

project-id: die Projekt-ID
instance-id: Die Instanz-ID.

HTTP-Methode und URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

JSON-Text anfordern:

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Abfragestatistiken für Cloud SQL Enterprise Plus deaktivieren

So deaktivieren Sie Query Insights für die Cloud SQL Enterprise Plus-Version:

Rufen Sie in der Google Cloud -Konsole die Seite Cloud SQL-Instanzen auf.

Cloud SQL-Instanzen aufrufen
Klicken Sie auf den Instanznamen, um die Übersichtsseite einer Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie im Bereich Instanz anpassen den Eintrag Query Insights.
Entfernen Sie das Häkchen aus dem Kästchen Enterprise Plus-Funktionen aktivieren.
Klicken Sie auf Speichern.

Nächste Schritte

Blog zur Einführung: Datenbank-Sichtbarkeit für Entwickler: Einführung von Cloud SQL Insights
Blog: Mit Cloud SQL Insights die Fähigkeiten zur Fehlerbehebung bei Abfragen verbessern
Video: Einführung in Cloud SQL Insights
Podcast: Cloud SQL Insights
Informationen zu Codelabs