ClickHouse

Looker unterstützt ClickHouse-Version 0.2 und höher.

Netzwerk-Datenverkehr verschlüsseln

Looker empfiehlt dringend, den Netzwerk-Datenverkehr zwischen der Looker-Anwendung und Ihrer Datenbank zu verschlüsseln. Verwenden Sie eine der Optionen auf der Seite Sicheren Datenbankzugriff aktivieren.

Informationen zum Aktivieren der SSL-Verschlüsselung auf der Serverseite finden Sie in der ClickHouse-Dokumentation.

Benutzer und Sicherheit

Konfigurieren Sie zuerst Ihren Looker-Nutzer auf dem ClickHouse-Server. ClickHouse-Datenbanknutzer werden nicht mit dem herkömmlichen CREATE USER-Befehl erstellt. Konfigurieren Sie den Abschnitt users in der Datei users.xml gemäß dem Dokument ClickHouse Access Rights. Hier ein einfaches Beispiel:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

Konfigurieren Sie außerdem in dieser Datei den entsprechenden Datenbankzugriff:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

Looker-Verbindung zu Ihrer Datenbank erstellen

Wählen Sie im Abschnitt Admin von Looker die Option Verbindungen aus und klicken Sie auf Verbindung hinzufügen.

Geben Sie die Verbindungsdetails ein. Die meisten Einstellungen gelten für die meisten Datenbankdialekte. Informationen dazu finden Sie in der Dokumentation zum Verbinden von Looker mit Ihrer Datenbank. Einige der Einstellungen werden als Nächstes beschrieben:

  • Dialekt: ClickHouse.
  • Host: Erreichbarer Hostname.
  • Port: Port, auf dem der ClickHouse-Dienst über HTTP(S) erreichbar ist.
    • Für HTTP-Verbindungen wird standardmäßig 8123 und für HTTPS 8443 verwendet.
    • Port 9000 und 9440 werden standardmäßig vom ClickHouse-Befehlszeilen-Client verwendet, aber diese Ports können nicht von Looker verwendet werden, um eine Verbindung zu ClickHouse herzustellen.
    • Ihr ClickHouse-Administrator hat möglicherweise alternative Ports mit den http_port/https_port-Einstellungen in der ClickHouse-Konfiguration ausgewählt. Fragen Sie Ihren ClickHouse-Administrator nach den Einstellungen für Ihre lokale Konfiguration.
  • Datenbank: Datenbankname (muss eine der Datenbanken sein, die in der Datei users.xml zulässig sind)
  • Nutzername: Datenbank-Nutzername.
  • Password (Passwort): Datenbankpasswort
  • Zusätzliche JDBC-Parameter (optional): Zusätzliche JDBC-Stringparameter.
  • Wartungszeitplan für Datengruppe und PAT: ClickHouse unterstützt keine PATs und kann daher ignoriert werden.
  • SSL: Klicken Sie das Kästchen an, um über SSL eine Verbindung zu ClickHouse herzustellen.
  • SSL überprüfen (optional): Setzen Sie ein Häkchen, um die Überprüfung des Hostnamens auf dem ClickHouse-Server zu erzwingen. Wählen Sie diese Option nur aus, wenn Sie ein SSL-Zertifikat verwenden, das von einer allgemein vertrauenswürdigen Zertifizierungsstelle signiert ist. Wenn Sie ein selbst signiertes SSL-Zertifikat verwenden, lassen Sie es deaktiviert.

Klicken Sie auf Test, um zu prüfen, ob die Verbindung erfolgreich war. Informationen zur Fehlerbehebung finden Sie in der Dokumentation zum Testen der Datenbankverbindung.

Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

Unterstützte Funktionen

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

ClickHouse unterstützt die folgenden Funktionen mit Looker 23.8:

Funktion Unterstützt?
Supportstufe
Unterstützt
Looker (Google Cloud Core)
Ja
Symmetrische Summen
Nein
Abgeleitete Tabellen
Ja
Über SQL abgeleitete Tabellen
Nein
Nichtflüchtige native abgeleitete Tabellen
Nein
Stabile Aufrufe
Nein
Abfrageabbau
Ja
SQL-basierte Pivots
Nein
Zeitzonen
Nein
SSL
Ja
Zwischensummen
Nein
Zusätzliche JDBC-Parameter
Ja
Groß-/Kleinschreibung beachten
Ja
Standorttyp
Ja
Listentyp
Ja
Perzentil
Ja
Eindeutiges Perzentil
Nein
Prozesse der SQL Runner-Sendung
Ja
SQL-Runner-Beschreibungstabelle
Ja
SQL-Runner-Show-Indizes
Nein
SQL Runner Select 10
Ja
Anzahl der SQL-Runner
Ja
Erläuterung zu SQL
Nein
OAuth-Anmeldedaten
Nein
Kontextkommentare
Ja
Verbindungs-Pooling
Nein
HLL-Sketche
Nein
Aggregatfunktion
Nein
Inkrementelle PDTs
Nein
Millisekunden
Nein
Mikrosekunden
Nein
Materialisierte Ansichten
Nein
Ungefähre Anzahl Einzeln
Nein