Administratoreinstellungen – Abfragen

Auf der Seite Abfragen im Bereich Datenbank des Menüs Verwaltung finden Sie Informationen zu den letzten 50 Abfragen, die Looker an Ihre Datenbank gesendet hat. Informationen zu Abfragen, die älter als die letzten 50 Abfragen sind, finden Sie im Bereich Nutzung von Looker.

Grundlegende Informationen zur Abfrage

Spalte Definition
Zeit Die Startzeit der Abfrage, angezeigt in der Zeitzone Ihrer Anwendung.
Status Der Status der Abfrage, der Folgendes umfassen 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 erfolgreich abgeschlossen.
  • Fehler: Die Abfrage wurde nicht erfolgreich abgeschlossen, da ein Fehler aufgetreten ist. Die Details dazu finden Sie, wenn Sie auf die Schaltfläche „Details“ klicken.
  • Abgebrochen: Die Abfrage wurde von Looker oder dem Nutzer abgebrochen.
  • Warten auf PDT: Die Abfrage muss warten, bis eine persistente abgeleitete Tabelle erstellt wurde, bevor sie ausgeführt werden kann.
  • PDT wird erstellt: Eine persistente abgeleitete Tabelle wird gerade erstellt.
  • In Warteschlange: Die Abfrage wartet auf die Ausführung, da bereits zu viele Abfragen ausgeführt werden. Abfragen können in Ihrer Verbindungseinrichtung oder Ihrer Datenbank von Looker begrenzt werden.
  • Wird ausgeführt: Die Abfrage wird gerade ausgeführt.
  • Unbekannt: Looker konnte nicht feststellen, 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 dies ermittelt werden kann. Einige Abfragen werden nicht von einem bestimmten Nutzer ausgeführt, z. B. wenn Looker eine persistente abgeleitete Tabelle erstellt oder wenn ein unbekannter Nutzer auf einen öffentlichen Look zugreift.
Quelle Die Quelle der Abfrage in Looker, z. B. die Seite „Explore“ oder SQL-Runner. Wenn möglich, wird auch ein Link zum gespeicherten Look oder die Abfrage-ID zusammen mit dem Namen des Modells und des Explores angezeigt. Einige Abfragen enthalten keine zusätzlichen Informationen, z. B. Abfragen, die in SQL-Runner ausgeführt werden. Abfragen, die über die offene SQL-Schnittstelle ausgegeben werden, haben den Quellwert Sql_interface.
Laufzeit Die Zeit, die für die Ausführung der Abfrage benötigt wurde. Dazu gehören die Erstellung der Abfrage, die Zeit, die die Abfrage in der Warteschlange verbracht hat, die Übertragung zur und von der Datenbank sowie die Ausführung der Abfrage in der Datenbank.

Wenn die Abfrage ausgeführt wird, wird die Laufzeit angezeigt. Bei Abfragen, die bereits ausgeführt wurden, wird auch eine Schätzung angezeigt, wie lange die Ausführung der Abfrage dauern wird. Die Schätzung basiert auf der Dauer der letzten Ausführung der Abfrage und sieht etwa so aus: „ungefähr 2 Sekunden“.
Schaltfläche „Details“ Weitere Informationen finden Sie 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 Menü Abfragedetails enthält Folgendes:

  • Ein Abschnitt Informationen mit Details zur Abfrage (siehe folgende Tabelle).
  • Ein Abschnitt SQL mit dem Roh-SQL, das für die Datenbank ausgeführt wurde. Kontextkommentare werden nicht in den Abfragedetails angezeigt. Damit Kommentare das Abfrage-Caching nicht beeinträchtigen, fügt Looker die Kontextkommentare zu ausgehenden SQL-Befehlen hinzu, kurz bevor das SQL an die Datenbank gesendet wird.
  • Ein Abschnitt SQL-Schnittstellenabfrage , der angezeigt wird, wenn eine Abfrage über die offene SQL-Schnittstelle ausgegeben wurde. In diesem Abschnitt wird die SQL-Abfrage angezeigt, die vom externen BI-Tool an Looker gesendet wurde. Dies kann bei der Fehlerbehebung und der Reproduktion von Problemen hilfreich sein.
  • Ein Link In SQL-Runner öffnen , mit dem die Abfrage in SQL-Runner geöffnet wird.

Der Abschnitt Informationen enthält die folgenden Informationen:

Bereich Definition
Verlaufs-ID Die Verlaufs-ID der Abfrage, falls verfügbar.
Status Der Status der Abfrage, wie in der Tabelle mit den grundlegenden Informationen zur Abfrage beschrieben.
Nachricht Wenn die Abfrage eine PDT enthält, wird der Kommentar zur PDT-Generierung in diesem Feld angezeigt. Wenn die Abfrage keine PDT enthält, wird das Feld nicht angezeigt.
Verbindung Die Looker-Verbindung, unter der diese Abfrage ausgeführt wurde.
Nutzer Der Nutzer, der diese Abfrage ausgeführt hat, sofern dies ermittelt werden kann. Einige Abfragen werden nicht von einem bestimmten Nutzer ausgeführt, z. B. wenn Looker eine persistente abgeleitete Tabelle erstellt oder wenn ein unbekannter Nutzer auf einen öffentlichen Look zugreift.
Quelle Die Quelle der Abfrage in Looker, z. B. die Seite Explore oder SQL-Runner. Wenn möglich, werden zusätzliche Informationen angezeigt, z. B. ein Link zum gespeicherten Look, die Abfrage-ID, der Modellname, der Explore-Name oder die ausgewählten Felder.
Beginn Die Startzeit der Abfrage, angezeigt in der Zeitzone Ihrer Anwendung.
Ende Die Endzeit der Abfrage, angezeigt in der Zeitzone Ihrer Anwendung.
Laufzeit Die Zeit, die für die Ausführung der Abfrage benötigt wurde.

Abfrageeabruch

Bei Dialekten, die das Beenden von Abfragen unterstützen, kann Looker eine laufende Abfrage auf zwei Arten beenden:

  • Looker beendet eine Abfrage automatisch, wenn der Nutzer den Browsertab schließt, in dem die Abfrage ausgeführt wird.
  • Looker-Administratoren können eine laufende Abfrage auf der Verwaltungsseite Abfragen beenden, indem sie für die Abfrage auf die Schaltfläche Beenden klicken. (Nutzer mit der see_queries Berechtigung können die Seite Abfragen aufrufen, aber nur Looker-Administratoren können eine laufende Abfrage beenden.)

Damit Looker Abfragen beenden kann, entweder durch Schließen des Browsertabs, in dem eine Abfrage ausgeführt wird, oder durch Beenden der Abfrage auf der Seite Abfragen , muss Ihr Datenbankdialekt das Beenden von Abfragen unterstützen. In der folgenden Tabelle ist zu sehen, welche Dialekte das Beenden von Abfragen in der neuesten Version von Looker unterstützen:

Dialekt Unterstützt?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13+
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

Zeitüberschreitungen bei Abfragen und Warteschlangen

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

  • Zeitüberschreitung für Verbindungspool und maximale Anzahl gleichzeitiger Abfragen: Damit Ihre Datenbank nicht mit gleichzeitigen Abfragen überlastet wird, speichert Looker überzählige gleichzeitige Abfragen in der Looker-Abfragewarteschlange und beendet Abfragen, die zu lange in der Warteschlange verbleiben. Standardmäßig sind 75 gleichzeitige Abfragen pro Verbindung zulässig. Bei zusätzlichen Abfragen, die das Verbindungslimit überschreiten, tritt nach 0 Sekunden eine Zeitüberschreitung auf. Wenn Sie diese Standardwerte ändern möchten, konfigurieren Sie die Einstellungen Maximale Anzahl von Verbindungen, Maximale Anzahl gleichzeitiger Abfragen für diese Verbindung und Zeitüberschreitung für Verbindungspool auf der Seite Verbindungseinstellungen einer Verbindung.

  • Abfragelimit und Zeitüberschreitung pro Nutzer: Damit kein einzelner Nutzer die Looker-Abfragewarteschlange füllen kann, hat jeder Nutzer eine maximale Anzahl zulässiger gleichzeitiger Abfragen und eine entsprechende Zeitüberschreitung für Abfragen, die aufgrund des Limits für gleichzeitige Abfragen in die Warteschlange gestellt werden. Das Limit pro Nutzer gilt sowohl für Nutzer, die sich mit dem regulären Authentifizierungsprozess in Looker anmelden, als auch für Nutzer, die sich mit API-Nutzeranmeldedaten anmelden. Es gibt zwei Möglichkeiten, die maximale Anzahl gleichzeitiger Abfragen pro Nutzer für Verbindungen in Ihrer Looker-Instanz zu definieren:

    • Die per-user-query-limit Startoption. Dies ist eine instanzweite Einstellung, mit der der Standardwert für Verbindungen in Ihrer Instanz festgelegt wird. Die Startoption per-user-query-limit begrenzt die Anzahl gleichzeitiger Abfragen pro Nutzer, pro Verbindung und pro Knoten in der Looker-Instanz. Das Standardlimit von 15 gleichzeitigen Abfragen pro Nutzer gilt für jede gültige Verbindung und, wenn Ihre Looker-Instanz gruppiert ist, für jeden Knoten im Cluster. Standardmäßig kann jeder Nutzer maximal 15 gleichzeitige Abfragen pro Verbindung und Knoten mit einer Zeitüberschreitung von 600 Sekunden ausführen. Wenn Sie beispielsweise einen Cluster mit fünf Knoten und einem per-user-query-limit von 15 haben, sind auf jedem Knoten 15 gleichzeitige Abfragen pro Nutzer für diese Verbindung zulässig, insgesamt also 75 Abfragen auf allen Knoten (15 * 5 = 75).

    Sie können das Abfragelimit pro Nutzer für eine Verbindung ändern, indem Sie auf der Seite Verbindungseinstellungen der Verbindung die Einstellung Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung verwenden. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie die Standardanzahl gleichzeitiger Abfragen pro Nutzer ändern, indem Sie die --per-user-query-limit Startoption konfigurieren. Die Zeitüberschreitung für die Warteschlange können Sie mit der --per-user-query-timeoutStartoption konfigurieren.

    • Die Option Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung in den Verbindungseinstellungen für eine Verbindung. Die Einstellung Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung hat standardmäßig den Wert 25 und gilt pro Nutzer und pro Verbindung, aber nicht pro Knoten. Wenn Sie beispielsweise einen Cluster mit fünf Knoten haben und diesen Wert auf 15 festlegen, sind auf jedem Knoten drei gleichzeitige Abfragen pro Nutzer für diese Verbindung zulässig (15 / 5 = 3), insgesamt also 15 Abfragen auf allen Knoten. Wenn für eine Verbindung ein Wert für die Einstellung Maximale Anzahl gleichzeitiger Abfragen pro Nutzer für diese Verbindung angegeben wird, überschreibt dieser Wert die Startoption per-user-query-limit für die Verbindung.
  • Abfragelimit und Zeitüberschreitung für Scheduler: Damit der Looker-Scheduler-Prozess nicht überlastet wird, kann eine Looker-Instanz maximal 10 gleichzeitige geplante Abfragen ausführen. Die Zeitüberschreitung für Abfragen in der Scheduler-Warteschlange beträgt 1.200 Sekunden. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie diese Standardwerte ändern, indem Sie die --scheduler-query-limit und --scheduler-query-timeout Startoptionen konfigurieren.

  • Abfragelimit und Zeitüberschreitung für Renderer: Damit der Looker-Renderer-Prozess nicht überlastet wird, kann eine Looker-Instanz maximal zwei gleichzeitige bildbasierte Downloads rendern, z. B. im PDF- und PNG-Format. Wenn Ihre Looker-Instanz vom Kunden gehostet wird, können Sie diesen Standardwert ändern, indem Sie die --concurrent-render-jobs Startoption konfigurieren.

  • Zeitüberschreitung für Webhook: Looker versucht maximal 30 Minuten lang, Daten an einen Webhook zu senden. Wenn Looker innerhalb von 30 Minuten nicht mit dem Webhook-Ziel kommunizieren kann, tritt bei der Abfrage eine Zeitüberschreitung auf. Diese Zeitüberschreitung kann nicht konfiguriert werden.
    • Zeitüberschreitung für Proxy: Vom Kunden gehostete Instanzen verwenden häufig Proxys mit einer Standardzeitüberschreitung von 60 Sekunden. Wir empfehlen, diese Zeitüberschreitung auf 60 Minuten zu erhöhen. Weitere Informationen finden Sie im Looker-Community-Beitrag Running Looker behind a proxy server or load balancer.

    • Zeitüberschreitung für Datenbank: Die meisten Datenbanken haben Regeln für Warteschlangen und Zeitüberschreitungen, die unabhängig von den Warteschlangen und Zeitüberschreitungen von Looker sind. Eine Abfrage kann beispielsweise die Looker-Warteschlange verlassen haben, aber trotzdem noch in der Warteschlange Ihrer Datenbank sein. Weitere Informationen zum Anpassen der Zeitüberschreitungen für Datenbankabfragen finden Sie in der Dokumentation Ihrer Datenbank.