ClickHouse

Verbinden Sie Looker mit Ihrer ClickHouse-Datenbank, um Ihre Daten zu analysieren und interaktive Dashboards zu erstellen. Durch diese Verbindung werden Ihre ClickHouse-Daten für Berichte und Analysen in Looker verfügbar, sodass Sie direkt datengestützte Entscheidungen treffen können.

Auf dieser Seite wird beschrieben, wie Sie Ihre ClickHouse-Instanz und die Looker-Verbindungseinstellungen konfigurieren. Dazu gehören das Verschlüsseln des Netzwerkverkehrs, das Definieren von Nutzerberechtigungen und das Überprüfen der unterstützten Funktionen. Looker unterstützt ClickHouse Version 0.2 oder höher.

Netzwerkverkehr 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.

Informationen zum Aktivieren der SSL-Verschlüsselung auf Serverseite finden Sie in der Dokumentation zu den globalen Servereinstellungen von ClickHouse.

Benutzer und Sicherheit

Konfigurieren Sie zuerst Ihren Looker-Nutzer auf dem ClickHouse-Server. ClickHouse-Datenbanknutzer werden nicht mit dem Befehl CREATE USER erstellt. Folgen Sie der Dokumentation zu den ClickHouse-Zugriffsrechten, um den Abschnitt users in der Datei users.xml zu konfigurieren. Hier ist 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 in dieser Datei auch 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 Bereich Admin von Looker 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:

  • Dialekt: ClickHouse
  • Host: Erreichbarer Hostname
  • Port: Port, über den der ClickHouse-Dienst über HTTP(S) erreichbar ist
    • Standardmäßig verwenden HTTP-Verbindungen 8123 und HTTPS 8443.
    • Die Ports 9000 und 9440 werden standardmäßig vom ClickHouse-Befehlszeilenclient verwendet. Diese Ports können jedoch 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, die für Ihre lokale Konfiguration geeignet sind.
  • Datenbank: Datenbankname (muss eine der in der Datei users.xml zulässigen Datenbanken sein)
  • Nutzername: Datenbanknutzername
  • Passwort: Datenbankpasswort

  • Zusätzliche JDBC-Parameter: (Optional) Zusätzliche JDBC-Stringparameter Eine Liste der von Looker unterstützten Parameter finden Sie auf dieser Seite im Abschnitt Unterstützte JDBC-Parameter.

  • Wartungszeitplan: ClickHouse unterstützt keine PDTs. Diese Einstellung kann daher ignoriert werden.

  • SSL: Aktivieren Sie diese Option, um eine Verbindung zu ClickHouse über SSL herzustellen.

  • SSL überprüfen: (Optional) Aktivieren Sie diese Option, um eine strenge Hostnamenüberprüfung auf dem ClickHouse-Server zu erzwingen. Aktivieren Sie diese Option nur, wenn Sie ein SSL-Zertifikat verwenden, das von einer allgemein vertrauenswürdigen Zertifizierungsstelle signiert wurde. Wenn Sie ein selbst signiertes SSL-Zertifikat verwenden, lassen Sie die Option deaktiviert.

Klicken Sie unten auf der Seite Verbindungseinstellungen im Bereich Statusdetails auf die Schaltfläche Verbindung testen , um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde.

Wenn in Looker Verbindung möglich angezeigt wird, klicken Sie auf Verbinden, um die Verbindung herzustellen.

Ihre Datenbankverbindung wird dann der Liste auf der Looker-Administrationsseite Verbindungen Admin hinzugefügt.

Unterstützte JDBC-Parameter

Für ClickHouse 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 für Ihre Datenbank.

  • beta.row_binary_for_simple_insert
  • compress
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_http_headers
  • custom_http_params
  • default_query_settings
  • disable_frameworks_detection
  • jdbc_ignore_unsupported_values
  • jdbc_resultset_auto_close
  • jdbc_sql_parser
  • jdbc_use_max_result_rows
  • jdbcCompliance
  • max_execution_time
  • password
  • session_timezone
  • socket_timeout
  • typeMappings
  • use_server_time_zone
  • use_time_zone
  • user
  • wrapperObject

Funktionsunterstützung

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

ClickHouse unterstützt ab Looker 26.14 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
Analytische Modelle in der Datenbank
Benutzerdefinierte Kalender