Apache 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

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

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

druid.sql.enable=true

Approximation von COUNT DISTINCT wird deaktiviert (optional)

Standardmäßig verwendet Druid den Näherungswert COUNT DISTINCT. Wenn Sie präzise Ergebnisse erhalten möchten, 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 im Bereich Admin von Looker 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 Broker 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 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 eine beliebige Zeichenfolge 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 ist. Die Eingabe eines Schemas ist optional.

  • Zusätzliche JDBC-Parameter: durch Semikolons getrennte Avatica-JDBC-Parameter.

    • Diese Attribute können als Verbindungsattribute 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 soll. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation zum Wartungsplan für Datengruppen und PATs.

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

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

  • Maximale Anzahl von Verbindungen pro Knoten: Der Standardwert ist 25. Sie können diese Einstellung anfangs auf dem Standardwert belassen. Weitere Informationen finden Sie auf der Dokumentationsseite Looker mit Ihrer Datenbank verbinden.

  • Zeitlimit für Verbindungspool: Der Standardwert beträgt 120 Sekunden.

  • SQL Runner Precache: Deaktivieren Sie diese Option, damit SQL Runner Tabelleninformationen nicht vorab lädt, sondern nur dann, wenn eine Tabelle ausgewählt ist. Weitere Informationen zu dieser Einstellung finden Sie in der Dokumentation zum SQL Runner Precache.

  • Database Time Zone: Zeitzone der Datenbank. Wird in Apache Druid 0.13 und höher und Apache Druid 0.18 und höher unterstützt.

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 einfache Verbindung zu verifizieren und einen Abfragetest durchzuführen. Es wird nicht überprüft, ob die Katalog- und Schemakombination vorhanden ist oder ob der Nutzer die erforderlichen Zugriffsrechte für dieses Schema hat.

Falls Probleme auftreten, lesen Sie unsere 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 dann, ob Sie Ihre Datenbanktabellen sehen.

Unterstützte Funktionen

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

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Yes
Abgeleitete SQL-Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Nein
SSL
Yes
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Yes
Groß-/Kleinschreibung beachten
Yes
Standorttyp
Yes
Listentyp
Nein
Perzentil
Nein
Unterschiedliche Perzentile
Nein
SQL-Runner-Show-Prozesse
Nein
SQL-Runner – Tabelle beschreiben
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner Select 10
Yes
Anzahl der SQL-Runner
Yes
SQL erklären
Yes
OAuth-Anmeldedaten
Nein
Kontextkommentare
Yes
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Yes
Mikrosekunden
Nein
Materialisierte Ansicht
Nein
Ungefähre Anzahl unterschiedlich
Nein

Apache Druid 0.13 und höher

Apache Druid 0.13 und höher unterstützt ab Looker 24.8 die folgenden Funktionen:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Nein
Symmetrische Summen
Nein
Abgeleitete Tabellen
Yes
Abgeleitete SQL-Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Yes
SSL
Yes
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Yes
Groß-/Kleinschreibung beachten
Yes
Standorttyp
Nein
Listentyp
Nein
Perzentil
Nein
Unterschiedliche Perzentile
Nein
SQL-Runner-Show-Prozesse
Nein
SQL-Runner – Tabelle beschreiben
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner Select 10
Yes
Anzahl der SQL-Runner
Yes
SQL erklären
Yes
OAuth-Anmeldedaten
Nein
Kontextkommentare
Yes
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Yes
Mikrosekunden
Nein
Materialisierte Ansicht
Nein
Ungefähre Anzahl unterschiedlich
Nein

Apache Druid 0.18 und höher

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

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Yes
Symmetrische Summen
Nein
Abgeleitete Tabellen
Yes
Abgeleitete SQL-Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Ansichten
Nein
Abfrage beenden
Nein
SQL-basierte Pivots
Nein
Zeitzonen
Yes
SSL
Yes
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Yes
Groß-/Kleinschreibung beachten
Yes
Standorttyp
Yes
Listentyp
Nein
Perzentil
Nein
Unterschiedliche Perzentile
Nein
SQL-Runner-Show-Prozesse
Nein
SQL-Runner – Tabelle beschreiben
Nein
SQL Runner – Indexe anzeigen
Nein
SQL Runner Select 10
Yes
Anzahl der SQL-Runner
Yes
SQL erklären
Yes
OAuth-Anmeldedaten
Nein
Kontextkommentare
Yes
Verbindungs-Pooling
Nein
HLL-Skizzen
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Yes
Mikrosekunden
Nein
Materialisierte Ansicht
Nein
Ungefähre Anzahl unterschiedlich
Nein

Weitere Informationen

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