Administratoreinstellungen – Abfragen

Ab Looker 22.16 können Looker-Administratoren die experimentelle Labs-Funktion Erweiterte Abfrage aktivieren, um die Seite Abfragen zu optimieren. Die Labs-Funktion verbessert die Leistung auf der Seite Abfragen und listet 500 statt 50 paginierte Abfragen auf.

Auf der Seite Abfragen im Abschnitt Datenbank des Menüs Admin finden Sie Informationen zu den letzten 50 Abfragen, die Looker an Ihre Datenbank gesendet hat. Informationen zu älteren Abfragen finden Sie im Abschnitt Nutzung von Looker.

Grundlegende Abfrageinformationen

Säulendiagramm Definition
Zeit Der Beginn der Abfrage in Ihrer Anwendungszeitzone.
Status Der Status der Abfrage, der Folgendes enthalten kann:
  • Cache: Looker hat die Ergebnisse aus dem Cache zurückgegeben, anstatt eine doppelte Abfrage für die Datenbank auszuführen.
  • Abgeschlossen: Die Abfrage wurde abgeschlossen.
  • Fehler: Die Abfrage konnte aufgrund eines Fehlers nicht abgeschlossen werden. Details finden Sie über die Schaltfläche Details.
  • Abgebrochen: Die Abfrage wurde von Looker oder dem Nutzer abgebrochen.
  • Warten auf PDT: Die Abfrage muss warten, bis eine persistente abgeleitete Tabelle erstellt wurde.
  • PDT wird erstellt: Eine persistente abgeleitete Tabelle wird erstellt.
  • Queued (In Warteschlange): Die Abfrage steht noch aus. Es werden bereits zu viele Abfragen ausgeführt. Abfragen können durch Looker in der Verbindungseinrichtung oder in der Datenbank eingeschränkt werden.
  • Läuft: Die Abfrage wird gerade ausgeführt.
  • Unbekannt: Looker konnte nicht ermitteln, was mit dieser Abfrage passiert ist.
Verbindung Die Looker-Verbindung, unter der diese Abfrage ausgeführt wurde.
Nutzer Der Nutzer, der diese Abfrage ausgeführt hat, sofern dieser ermittelt werden kann. Einige Abfragen werden nicht von einem bestimmten Nutzer ausgeführt, z. B. wenn eine Looker-Tabelle eine persistente abgeleitete Tabelle erstellt oder ein unbekannter Nutzer auf einen öffentlichen Look zugreift.
Quelle Die Quelle der Abfrage in Looker, z. B. die Seite „Erkunden“ oder der SQL-Runner. Wenn möglich, wird auch ein Link zum gespeicherten Look oder die Abfrage-ID zusammen mit dem Namen des Modells und der Option „Erkunden“ angezeigt. Einige Abfragen enthalten keine zusätzlichen Informationen, z. B. solche, die in SQL Runner ausgeführt werden.
Laufzeit Die für die Ausführung der Abfrage benötigte Zeit. Dazu gehören der Aufbau der Abfrage, jedes Mal, wenn die Abfrage in der Warteschlange verbracht wurde, der Traffic zur und von der Datenbank und die Datenbankausführung der Abfrage.

Wenn die Abfrage gerade ausgeführt wird, zeigt die Laufzeit an, wie lange sie bereits läuft. Für Abfragen, die bereits ausgeführt wurden, wird in der Laufzeit außerdem eine Schätzung angezeigt, wie lange die Abfrage dauern soll. Die Schätzung basiert auf der Dauer der letzten Ausführung der Abfrage und sollte in etwa so aussehen: etwa 2 Sekunden.
Schaltfläche „Details“ Weitere Informationen findest du im Unterabschnitt Schaltfläche „Details“ auf dieser Seite.

Schaltfläche „Details“

Wenn Sie rechts neben einer Abfrage auf die Schaltfläche Details klicken, werden zusätzliche Informationen zu dieser Abfrage angezeigt. Das Pop-up-Fenster Abfragedetails enthält Folgendes:

  • Ein Abschnitt Info mit Details zur Abfrage (siehe folgende Tabelle).
  • Ein SQL-Abschnitt, der den Roh-SQL-Code zeigt, der für die Datenbank ausgeführt wurde. Kontextkommentare werden nicht in den Abfragedetails angezeigt. Damit Kommentare sich nicht auf das Abfrage-Caching auswirken, fügt Looker den ausgehenden SQL-Befehlen die Kontextkommentare hinzu, bevor der SQL an die Datenbank gesendet wird.
  • Ein Link In SQL-Runner öffnen, mit dem die Abfrage in SQL Runner geöffnet wird.

Der Abschnitt Info enthält folgende Informationen:

Bereich Definition
Verlaufs-ID Die Verlaufs-ID der Abfrage, falls verfügbar.
Status Der Status der Abfrage, wie oben beschrieben.
Verbindung Die Looker-Verbindung, unter der diese Abfrage ausgeführt wurde.
Nutzer Der Nutzer, der diese Abfrage ausgeführt hat, sofern dieser ermittelt werden kann. Einige Abfragen werden nicht von einem bestimmten Nutzer ausgeführt, z. B. wenn eine Looker-Tabelle eine persistente abgeleitete Tabelle erstellt oder ein unbekannter Nutzer auf einen öffentlichen Look zugreift.
Quelle Die Quelle der Abfrage in Looker, z. B. die Seite Erkunden oder der SQL-Runner. Es werden nach Möglichkeit zusätzliche Informationen angezeigt, etwa ein Link zum gespeicherten Look, die Abfrage-ID, der Modellname, der Name „Erkunden“ und die ausgewählten Felder.
Beginn Der Beginn der Abfrage in Ihrer Anwendungszeitzone.
Ende Die Endzeit der Abfrage, die in Ihrer Anwendungszeitzone angezeigt wird.
Laufzeit Die Zeit, die für die Ausführung der Abfrage benötigt wurde.

Abfrage löschen

Eine laufende Abfrage wird von Looker automatisch beendet, wenn Sie den Browsertab schließen, in dem die Abfrage ausgeführt wird. Looker-Administratoren können eine laufende Abfrage auch auf der Seite Abfragen beenden. Nutzer mit der Berechtigung see_queries können die Seite Abfragen aufrufen, aber nur Looker-Administratoren können eine laufende Abfrage beenden. Jede noch laufende Abfrage zeigt rechts neben der Abfrage die Schaltfläche Beenden an. Klicken Sie auf Beenden, um die Abfrage zu beenden.

Damit Looker Abfragen abbrechen kann, muss Ihr Datenbankdialekt das Beenden von Abfragen unterstützen. Die folgende Liste enthält die Dialekte, die in der neuesten Version von Looker das Beenden von Abfragen unterstützen:

Abfragezeitüberschreitungen und Warteschlangen

Looker beendet Abfragen, die zu lange in der Warteschlange waren. Dieser Vorgang wird als Zeitüberschreitung bezeichnet. Für Ihre Abfrage können mehrere Zeitüberschreitungen gelten:

  • Zeitüberschreitung beim Verbindungspool: Damit Ihre Datenbank nicht mit gleichzeitigen Abfragen überlastet wird, hält Looker zusätzliche gleichzeitige Abfragen in der Looker-Abfragewarteschlange und beendet Abfragen, die zu lange in der Warteschlange bleiben. Standardmäßig sind maximal 75 Abfragen gleichzeitig pro Verbindung zulässig. Bei Abfragen in der Warteschlange kommt es nach 0 Sekunden zu einer Zeitüberschreitung. Sie können diese Standardeinstellungen auf der Seite Verbindungseinstellungen der Verbindung konfigurieren.

  • Limit für Abfrage pro Nutzer und Zeitlimit: Damit kein einzelner Nutzer die Looker-Abfragewarteschlange ausfüllt, hat jeder Nutzer eine maximale Anzahl gleichzeitiger Abfragen und ein entsprechendes Zeitlimit für die Warteschlange. Standardmäßig kann jeder Nutzer maximal 15 Abfragen gleichzeitig ausführen. Das Zeitlimit für Abfragen, die aufgrund dieses Limits in die Warteschlange gestellt werden, beträgt 600 Sekunden. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie diese Standardeinstellungen ändern. Konfigurieren Sie dazu die Startoptionen --per-user-query-limit und --per-user-query-timeout.

  • Zeitplanlimit für Abfrage und Zeitlimit: Um eine Überlastung des Looker-Planerprozesses zu verhindern, kann eine Looker-Instanz maximal zehn gleichzeitig geplante Abfragen ausführen. Das Zeitlimit für Abfragen in der Planerwarteschlange beträgt 1.200 Sekunden. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie diese Standardeinstellungen ändern. Konfigurieren Sie dazu die Startoptionen --scheduler-query-limit und --scheduler-query-timeout.

    Wenn Ihre Looker-Instanz geclustert ist, verwendet jeder Knoten des Clusters seine eigene Planerwarteschlange. Wenn Sie Ihrem Cluster also Knoten hinzufügen, erhöhen Sie die Gesamtzahl der zulässigen gleichzeitigen geplanten Abfragen, ohne den Looker-Planerprozess zu belasten.

  • Limit für Renderer-Abfrage und Zeitlimit: Damit eine Überlastung des Looker-Renderer-Prozesses vermieden wird, kann eine Looker-Instanz maximal zwei gleichzeitige bildbasierte Downloads rendern, z. B. PDF- und PNG-Formate. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie diese Standardeinstellung ändern, indem Sie die Startoption --concurrent-render-jobs konfigurieren.

    Wenn Ihre Looker-Instanz geclustert ist, verwendet jeder Knoten des Clusters seine eigene Renderer-Warteschlange. Daher erhöht das Hinzufügen von Knoten zu Ihrem Cluster die Gesamtzahl der zulässigen gleichzeitigen Renderer-Jobs, ohne den Looker-Renderer-Prozess zusätzlich zu belasten.

  • Webhook-Zeitlimit: Looker versucht maximal 30 Minuten, Daten an einen Webhook zu senden. Wenn Looker nicht innerhalb von 30 Minuten mit dem Webhook-Ziel kommunizieren kann, kommt es zu einer Zeitüberschreitung bei der Abfrage. Dieses Zeitlimit kann nicht konfiguriert werden.

  • Proxy-Zeitlimit: Von Looker gehostete Instanzen verwenden einen Proxy, mit dem alle Abfragen beendet werden, die seit 60 Minuten ausgeführt wurden. Dieses Zeitlimit kann nicht konfiguriert werden.

    Vom Kunden gehostete Instanzen verwenden häufig Proxys mit einem Standardzeitlimit von 60 Sekunden. Wir empfehlen, dieses Zeitlimit auf 60 Minuten zu erhöhen. Weitere Informationen finden Sie im Looker-Communitybeitrag Looker hinter einem Proxyserver oder Load-Balancer ausführen.

  • Datenbank-Timeout: Die meisten Datenbanken haben Regeln für Warteschlangen und Zeitlimits, die unabhängig von Looker-Warteschlangen und -Zeitüberschreitungen sind. Beispiel: Eine Abfrage hat die Warteschlange von Looker verlassen, kann aber dennoch in Ihrer Datenbank in die Warteschlange gestellt werden. Weitere Informationen zum Anpassen von Zeitüberschreitungen bei Datenbankabfragen finden Sie in der Dokumentation zu Ihrer Datenbank.