Apache Druid

Netzwerk-Datenverkehr verschlüsseln

Es empfiehlt sich, den Netzwerkverkehr zwischen Looker-Anwendung und 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 broker/runtime.properties Konfigurationsdatei diese Zeile hinzu:

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

druid.sql.enable=true

COUNT DISTINCT-Näherung deaktivieren (optional)

Standardmäßig nähert Druid COUNT DISTINCT an. Wenn Sie genaue Ergebnisse erhalten möchten, fügen Sie der broker/runtime.properties Konfigurationsdatei 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 Admin die Option Verbindungen aus und klicken Sie dann auf Verbindung hinzufügen.

Geben Sie die Verbindungsdetails ein. Der Großteil der Einstellungen ist für die meisten Datenbankdialekte gleich. 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 Cluster-Brokers. Sie finden diese 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 eine beliebige String angeben.

  • Passwort: Das Nutzerpasswort. Wenn Ihr Cluster nicht für die Verwendung von Druid Basic Security konfiguriert ist, können Sie eine beliebige 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 Semikolons getrennte Avatica-JDBC-Parameter. Eine Liste der von Looker unterstützten Parameter finden Sie auf dieser Seite im Abschnitt Unterstützte JDBC-Parameter.

    • Diese Attribute 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.

  • Max. Verbindungen pro Knoten: Der Standardwert ist 25. Diese Einstellung kann vorerst 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 SQL Runner Precache Dokumentation.

  • 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 Datenbankverbindung 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.

Wenn Sie Probleme haben, lesen Sie die Dokumentation zum Testen von Verbindungen.

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.

Unterstützte JDBC-Parameter

Für Apache Druid unterstützt Looker die folgenden JDBC-Parameter im Feld Zusätzliche JDBC-Parameter für die Verbindung. Informationen zu diesen Parametern finden Sie in der Dokumentation zu Ihrer Datenbank.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

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.6 die folgenden Funktionen:

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Aggregate
Abgeleitete Tabellen
Persistente abgeleitete SQL-Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivottabellen
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner-Befehl – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner-Befehl – 10 auswählen
SQL-Runner – Anzahl
SQL – Erklären
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
Benutzerdefinierte Kalender

Apache Druid 0.13.x–0.17.x

Apache Druid 0.13.x–0.17.x unterstützt ab Looker 26.6 die folgenden Funktionen:

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Aggregate
Abgeleitete Tabellen
Persistente abgeleitete SQL-Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivottabellen
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner-Befehl – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner-Befehl – 10 auswählen
SQL-Runner – Anzahl
SQL – Erklären
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
Benutzerdefinierte Kalender

Apache Druid 0.18+

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

Funktion Unterstützt?
Looker (Google Cloud Core)
Symmetrische Aggregate
Abgeleitete Tabellen
Persistente abgeleitete SQL-Tabellen
Persistente native abgeleitete Tabellen
Stabile Ansichten
Abfrageeabruch
SQL-basierte Pivottabellen
Zeitzonen
SSL
Zwischensummen
Zusätzliche JDBC-Parameter
Groß- und Kleinschreibung
Standorttyp
Listentyp
Perzentil
Perzentil der unterschiedlichen Werte
SQL Runner-Befehl – Prozesse anzeigen
SQL-Runner-Funktion – Tabelle beschreiben
SQL Runner-Befehl – Indexe anzeigen
SQL Runner-Befehl – 10 auswählen
SQL-Runner – Anzahl
SQL – Erklären
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
Benutzerdefinierte Kalender

Nächste Schritte

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