ClickHouse

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.

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 Zugriffsrechten von ClickHouse, 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 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:

  • 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 auf Test , um zu prüfen, ob die Verbindung erfolgreich hergestellt wurde. Informationen zur Fehlerbehebung finden Sie auf der Dokumentationsseite Datenbankverbindung für vom Kunden gehostete Instanzen testen.

Klicken Sie auf Verbinden, um diese Einstellungen zu speichern.

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 zu Ihrer 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.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