Apache Druid

Netzwerkverkehr verschlüsseln

Es wird empfohlen, 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 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

COUNT DISTINCT-Schätzung deaktivieren (optional)

Standardmäßig wird COUNT DISTINCT von Druid geschätzt. Für genaue Ergebnisse fügen Sie der Konfigurationsdatei broker/runtime.properties diese 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 Verwaltung 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 und höher (Apache Druid 0.13.x bis 0.17.x) oder Apache Druid 0.18 und höher.

  • Host: DNS- oder IP-Adresse des Cluster-Brokers. 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 Datenbanknutzername, wenn Ihr Apache Druid-Cluster für die Verwendung der Druid-Grundlegenden Sicherheit konfiguriert ist. Andernfalls 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 werden soll, wenn kein Schema angegeben wird. Die Eingabe eines Schemas ist optional.

  • Zusätzliche JDBC-Parameter: 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 für Verbindungspool: Standardmäßig 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 zum SQL Runner Precache.

  • Zeitzone der Datenbank: 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 Datenbankkonnektivität testen.

Looker führt eine SELECT 1-Abfrage aus, um eine Basisverbindung zu verifizieren 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.

Weitere Informationen finden Sie in der Dokumentation Verbindungen testen.

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 Ihre Datenbanktabellen angezeigt werden.

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.0 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
Abfrage beenden
Nein
SQL-basierte Pivot-Tabellen
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 für Serien
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 Aufrufe
Nein

Apache Druid 0.13 und höher (Apache Druid 0.13.x bis 0.17.x)

Apache Druid 0.13 und höher unterstützt ab Looker 25.0 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
Abfrage beenden
Nein
SQL-basierte Pivot-Tabellen
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 für Serien
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 Aufrufe
Nein

Apache Druid 0.18 und höher

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

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
Abfrage beenden
Nein
SQL-basierte Pivot-Tabellen
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 für Serien
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 Aufrufe
Nein

Nächste Schritte

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