Druid

Netzwerk-Datenverkehr verschlüsseln

Es wird empfohlen, den Netzwerkverkehr zwischen der Looker-Anwendung und Ihrer Datenbank zu verschlüsseln. Sehen Sie sich eine der Optionen an, die auf der Dokumentationsseite Sicheren Datenbankzugriff aktivieren beschrieben werden.

Apache Druid-Cluster konfigurieren

<DRUID_BASE_DIR> bezieht sich auf das Basisverzeichnis, in dem der Apache Druid-Cluster auf einem Server installiert ist.

SQL aktivieren

Wenn Sie SQL in Ihrer Druid-Datenbank aktivieren möchten, fügen Sie der Konfigurationsdatei broker/runtime.properties die folgende Zeile hinzu:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

Schätzung für COUNT DISTINCT wird deaktiviert (optional)

Standardmäßig wird COUNT DISTINCT von Druid geschätzt. Fügen Sie der Konfigurationsdatei broker/runtime.properties diese Zeile hinzu, um genaue Ergebnisse zu erhalten:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

`druid.sql.planner.useApproximateCountDistinct=false`

Looker-Verbindung zu Ihrer Datenbank erstellen

Wählen Sie in Looker im Bereich Verwaltung die Option Verbindungen und dann Verbindung hinzufügen aus.

Geben Sie die Verbindungsdetails ein. Die meisten Einstellungen sind den meisten Datenbankdialekten gemeinsam. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden. Einige der Einstellungen werden im Folgenden beschrieben:

  • Name: Der Name der Verbindung.

  • Dialekt: Apache Druid, Apache Druid 0.13 oder höher oder Apache Druid 0.18 oder höher.

  • Host: DNS- oder IP-Adresse des Clusters Broker. Sie finden sie in der Datei broker/runtime.properties.

  • Port: Der Port des Brokers. Der Standardport ist 8082. Wenn Ihr Cluster durch SSL gesichert ist, ist der Standardport 8182.

  • Datenbank: Der Name Ihrer Datenbank. Der Standardwert ist druid.

  • Nutzername: Der Nutzername der Datenbank, wenn Ihr Apache Druid-Cluster für die Verwendung von Druid Basic Security konfiguriert ist. Ist dies nicht der Fall, können Sie einen beliebigen String angeben.

  • Password: Das Nutzerpasswort. Wenn Ihr Cluster nicht für die Verwendung der Druid-Grundlegenden Sicherheit konfiguriert ist, können Sie einen beliebigen String angeben.

  • Schema: Das Standardschema, das verwendet wird, wenn kein Schema angegeben ist. Die Eingabe eines Schemas ist optional.

  • Zusätzliche JDBC-Parameter: Durch Semikolons getrennte Avatica-JDBC-Parameter.

    • Diese Properties können als Verbindungseigenschaften festgelegt werden:
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

    Beispiel: none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Wartungszeitplan für Datengruppe und PAT: Ein cron-Ausdruck, der angibt, wann Looker Datengruppen und persistente abgeleitete Tabellen prüfen sollte. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation Wartungszeitplan für Datengruppe und PAT.

  • SSL: Prüfen Sie, ob Ihr Apache Druid-Cluster für die Verwendung von Druid TLS konfiguriert ist.

  • SSL überprüfen: Hier können Sie eine strenge Überprüfung des Hostnamens erzwingen.

  • Max. Verbindungen pro Knoten: Standardmäßig ist 25 festgelegt. Diese Einstellung kann zunächst unverändert bleiben. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

  • Zeitlimit des Verbindungspools: Der Standardwert beträgt 120 Sekunden.

  • SQL Runner-Precache: Deaktivieren Sie diese Option, damit SQL Runner Tabelleninformationen nicht vorab lädt, sondern nur, wenn eine Tabelle ausgewählt ist. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation zu SQL Runner Precache.

  • Database Time Zone: Zeitzone der Datenbank Unterstützt in Apache Druid 0.13 und höher sowie in Apache Druid 0.18 und höher.

Klicken Sie auf Testen, um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde. Informationen zur Fehlerbehebung finden Sie auf der Dokumentationsseite Datenbankverbindung testen.

Looker führt eine SELECT 1-Abfrage aus, um eine Basisverbindung zu prüfen und einen Abfragetest durchzuführen. Es wird nicht geprüft, ob die Katalog- und Schemakombination vorhanden ist oder ob der Nutzer den erforderlichen Zugriff auf dieses Schema hat.

Informationen zu Problemen finden Sie in der Dokumentation zum Testen von Verbindungen.

Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

Testen Sie die Verbindung in SQL Runner. Gehen Sie zu SQL Runner, wählen Sie Ihre Verbindung und Ihr Schema aus und prüfen Sie, ob Sie die Datenbanktabellen sehen können.

Funktionsunterstützung

Damit Looker einige Funktionen unterstützen kann, müssen diese auch von Ihrem Datenbankdialekt unterstützt werden.

Druid

Apache Druid unterstützt ab Looker 24.18 die folgenden Funktionen:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Persistente SQL-Abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Perzentil der unterschiedlichen Werte
Nein
SQL Runner-Prozesse anzeigen
Nein
SQL Runner Describe Table
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner – Select 10
Ja
Anzahl der SQL-Runner
Ja
SQL Explain
Ja
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Ja
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl einzelner
Nein

Apache Druid 0.13+

Apache Druid 0.13 und höher unterstützt ab Looker 24.18 die folgenden Funktionen:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Persistente SQL-Abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Ja
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Nein
Listentyp
Nein
Perzentil
Nein
Perzentil der unterschiedlichen Werte
Nein
SQL Runner-Prozesse anzeigen
Nein
SQL Runner Describe Table
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner – Select 10
Ja
Anzahl der SQL-Runner
Ja
SQL Explain
Ja
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Ja
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl einzelner
Nein

Apache Druid 0.18 und höher

Apache Druid 0.18 und höher unterstützt ab Looker 24.18 die folgenden Funktionen:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Ja
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Persistente SQL-Abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Ja
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Perzentil der unterschiedlichen Werte
Nein
SQL Runner-Prozesse anzeigen
Nein
SQL Runner Describe Table
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner – Select 10
Ja
Anzahl der SQL-Runner
Ja
SQL Explain
Ja
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Ja
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl einzelner
Nein

Nächste Schritte

Nachdem die Datenbankverbindung hergestellt wurde, konfigurieren Sie die Authentifizierungsoptionen.