Druid

Netzwerk-Datenverkehr verschlüsseln

Es empfiehlt sich, 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

Fügen Sie der Konfigurationsdatei broker/runtime.properties diese Zeile hinzu, um SQL in Ihrer Druid-Datenbank zu aktivieren:

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

druid.sql.enable=true

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

Standardmäßig schätzt Druid den Wert COUNT DISTINCT. 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 Admin die Option Verbindungen aus und klicken Sie dann auf Verbindung hinzufügen.

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 Broker. 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 (Passwort): Das Nutzerpasswort. Wenn Ihr Cluster nicht für die Verwendung von Druid Basic Security 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 Eigenschaften können als Verbindungseigenschaften festgelegt werden: <ph type="x-smartling-placeholder">
        </ph>
      • useApproximateCountDistinct
      • useApproximateTopN
      • useFallback
      • sqlTimeZone

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

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

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

  • SSL überprüfen: Aktivieren Sie diese Option, um eine strenge Überprüfung des Hostnamens zu erzwingen.

  • Maximale Verbindungen pro Knoten: Der Standardwert ist 25. Für diese Einstellung kann anfänglich die Standardeinstellung beibehalten werden. 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 Apache Druid 0.18+.

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 Kombination aus Katalog und Schema 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.12 die folgenden Funktionen:

Feature 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
Anfrage wird abgebrochen
Nein
SQL-basierte Drehpunkte
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Unterschiedliches Perzentil
Nein
SQL Runner – Prozesse anzeigen
Nein
SQL Runner – Tabelle beschreiben
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+ unterstützt die folgenden Funktionen ab Looker 24.12:

Feature 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
Anfrage wird abgebrochen
Nein
SQL-basierte Drehpunkte
Nein
Zeitzonen
Ja
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Nein
Listentyp
Nein
Perzentil
Nein
Unterschiedliches Perzentil
Nein
SQL Runner – Prozesse anzeigen
Nein
SQL Runner – Tabelle beschreiben
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+

Apache Druid 0.18+ unterstützt die folgenden Funktionen ab Looker 24.12:

Feature 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
Anfrage wird abgebrochen
Nein
SQL-basierte Drehpunkte
Nein
Zeitzonen
Ja
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Nein
Perzentil
Nein
Unterschiedliches Perzentil
Nein
SQL Runner – Prozesse anzeigen
Nein
SQL Runner – Tabelle beschreiben
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.