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 diese 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 angenähert. 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 mit SSL gesichert 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 25.10 die folgenden Funktionen:

Apache Druid 0.13+ (Apache Druid 0.13.x bis 0.17.x)

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

Apache Druid 0.18+

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

Nächste Schritte

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