Apache Druid

Netzwerk-Datenverkehr verschlüsseln

Es empfiehlt sich, den Netzwerkverkehr zwischen der Looker-Anwendung und Ihrer Datenbank zu verschlüsseln. Prüfen Sie eine der Optionen, die auf der Dokumentationsseite Sicheren Datenbankzugriff ermöglichen 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 für Ihre 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

COUNT DISTINCT-Schätzung deaktivieren (optional)

Standardmäßig wird COUNT DISTINCT in Druid geschätzt. Für genaue Ergebnisse fügen Sie der Konfigurationsdatei broker/runtime.properties die folgende Zeile hinzu:

<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. Der Großteil der Einstellungen gilt für die meisten Datenbankdialekte. 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+ (Apache Druid 0.13.x–0.17.x) oder Apache Druid 0.18+.

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

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

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

  • Nutzername: Der Datenbanknutzername, wenn Ihr Apache Druid-Cluster für die Verwendung von Druid Basic Security konfiguriert ist. Andernfalls können Sie einen beliebigen String angeben.

  • 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 werden soll, wenn kein Schema angegeben wird. Die Eingabe eines Schemas ist optional.

  • Zusätzliche JDBC-Parameter: Durch Semikolon 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: Ein cron-Ausdruck, der angibt, wann Looker Datengruppen und persistente abgeleitete Tabellen prüfen soll. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation zum 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 Hostnamenüberprüfung zu erzwingen.

  • Maximale Anzahl von Verbindungen pro Knoten: Der Standardwert ist 25. Diese Einstellung kann zunächst auf dem Standardwert belassen werden. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

  • Zeitlimit für Verbindungspool: Der Standardwert ist 120 Sekunden.

  • SQL-Runner-Precache: Deaktivieren Sie diese Option, damit SQL Runner Tabelleninformationen nicht vorab lädt, sondern nur bei Auswahl einer Tabelle. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation zu SQL Runner-Precache.

  • Zeitzone der Datenbank: Zeitzone der Datenbank. Wird in Apache Druid 0.13+ und Apache Druid 0.18+ unterstützt.

Klicken Sie auf Test, um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde. Informationen zur Fehlerbehebung finden Sie auf der Dokumentationsseite Datenbankkonnektivität testen.

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

Bei Problemen können Sie sich unsere Dokumentation zum Testen von Verbindungen ansehen.

Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

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

Funktionsunterstützung

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

Apache Druid

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

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Summen
Abgeleitete Tabellen
Persistente SQL-abgeleitete Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivots
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner – „Select 10“
SQL-Runner Count
SQL Explain
OAuth 2.0-Anmeldedaten
Kontextkommentare
Verbindungs-Pooling
HLL-Skizzen
Aggregate Awareness
Inkrementelle PDTs
Millisekunden
Mikrosekunden
Materialisierte Ansichten
Vergleich zum vorherigen Zeitraum
Ungefähre Anzahl einzelner Aufrufe

Apache Druid 0.13.x bis 0.17.x

Apache Druid 0.13+ unterstützt ab Looker 26.0 die folgenden Funktionen:

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Summen
Abgeleitete Tabellen
Persistente SQL-abgeleitete Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivots
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner – „Select 10“
SQL-Runner Count
SQL Explain
OAuth 2.0-Anmeldedaten
Kontextkommentare
Verbindungs-Pooling
HLL-Skizzen
Aggregate Awareness
Inkrementelle PDTs
Millisekunden
Mikrosekunden
Materialisierte Ansichten
Vergleich zum vorherigen Zeitraum
Ungefähre Anzahl einzelner Aufrufe

Apache Druid 0.18+

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

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Summen
Abgeleitete Tabellen
Persistente SQL-abgeleitete Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivots
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner – „Select 10“
SQL-Runner Count
SQL Explain
OAuth 2.0-Anmeldedaten
Kontextkommentare
Verbindungs-Pooling
HLL-Skizzen
Aggregate Awareness
Inkrementelle PDTs
Millisekunden
Mikrosekunden
Materialisierte Ansichten
Vergleich zum vorherigen Zeitraum
Ungefähre Anzahl einzelner Aufrufe

Nächste Schritte

Nachdem Sie die Datenbankverbindung hergestellt haben, konfigurieren Sie die Authentifizierungsoptionen.