ClickHouse

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

ClickHouse ist eine Datenbank für Auswertungen über sehr große Datenmengen. Sie speichert die Werte einer Tabelle spaltenweise und stark gepackt. Deshalb muss sie bei einer Abfrage nur die benötigten Spalten lesen und kann Summen, Mittelwerte oder Zählungen über viele Millionen Zeilen in Sekundenbruchteilen berechnen. Typische Einsätze sind Messwerte, Protokolldaten von Servern und Besucherstatistiken von Websites. Diese Anleitung installiert ClickHouse als Dienst, erzeugt fünf Jahre Wetterdaten mit über zehn Millionen Zeilen und wertet sie mit SQL aus.

Vorbemerkungen

  • Warum nicht apt aus Ubuntu: Ubuntu 26.04 enthält kein Paket für ClickHouse. Der Hersteller betreibt aber ein eigenes apt-Archiv. Nach dem Einbinden installiert und aktualisiert apt ClickHouse wie jedes andere Paket.
  • LTS oder stable: Das Archiv hat zwei Bereiche. stable bekommt jeden Monat eine neue Version, lts nur zweimal im Jahr eine, die dann ein Jahr lang Fehlerbehebungen erhält. Diese Anleitung nimmt lts, weil eine Datenbank selten jede Neuerung sofort braucht.
  • DuckDB oder ClickHouse: DuckDB läuft ohne Server direkt in einem Programm und ist ideal für Auswertungen am eigenen Rechner. ClickHouse läuft als Dienst, nimmt laufend neue Daten an und bedient viele Benutzer und Programme gleichzeitig.
  • Nur lokal erreichbar: ClickHouse lauscht nach der Installation nur auf 127.0.0.1 und ::1. Die wichtigsten Ports sind 8123 (HTTP) und 9000 (eigenes Protokoll für clickhouse-client).
  • Arbeitsspeicher: Der laufende Dienst belegt schon ohne Daten rund 800 MB.
  • Version: Getestet mit ClickHouse 26.8.15 (LTS) am 2. Oktober 2026.

Paketquelle einbinden

1. Paketlisten aktualisieren

Damit apt die aktuellen Versionen der Hilfsprogramme aus dem nächsten Schritt kennt.

sudo apt update

2. Hilfsprogramme installieren

wget lädt den Schlüssel herunter, ca-certificates enthält die Zertifikate für die verschlüsselte Verbindung zum Archiv. Meist sind beide schon vorhanden.

sudo apt install wget ca-certificates

3. Signaturschlüssel herunterladen

Mit diesem Schlüssel prüft apt, dass die Pakete wirklich von ClickHouse stammen und unterwegs nicht verändert wurden. Der Hersteller legt denselben Schlüssel für alle Paketarten im Ordner rpm ab, er gilt aber auch für die Pakete für Ubuntu. Mit der Endung .asc kann apt ihn direkt lesen.

sudo wget -O /etc/apt/keyrings/clickhouse.asc https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key

Prüfen: Die erste Zeile lautet -----BEGIN PGP PUBLIC KEY BLOCK-----.

head -n 1 /etc/apt/keyrings/clickhouse.asc

4. Paketquelle eintragen

Legt eine neue Datei an, die apt als zusätzliche Paketquelle liest.

sudo nano /etc/apt/sources.list.d/clickhouse.sources

Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

Types: deb
URIs: https://packages.clickhouse.com/deb
Suites: lts
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/clickhouse.asc
  • Suites: lts – der Bereich mit den lange gepflegten Versionen. Wer immer die neueste Version möchte, schreibt stable.
  • Signed-By – Pakete aus dieser Quelle werden nur mit dem Schlüssel aus Schritt 3 angenommen.

5. Paketlisten neu einlesen

Erst jetzt lädt apt das Paketverzeichnis von ClickHouse herunter.

sudo apt update

Prüfen: Der Installationskandidat ist eine Version wie 26.8.15.10.

apt policy clickhouse-server

Installation

6. ClickHouse installieren

Installiert den Server, das Kommandozeilenprogramm clickhouse-client und das gemeinsame Programm clickhouse-common-static, in dem alle Teile stecken. Der Download ist rund 250 MB groß.

sudo apt install clickhouse-server clickhouse-client

Gegen Ende der Installation erscheint im Terminal die Frage Set up the password for the default user:. Gib ein eigenes, langes Passwort ein und drücke Enter. Die Eingabe ist nicht zu sehen und wird nicht wiederholt, tippe also sorgfältig.

Prüfen: Danach erscheint Password for the default user is saved in file /etc/clickhouse-server/users.d/default-password.xml. In dieser Datei steht nur eine Prüfsumme des Passworts, nicht das Passwort selbst.

7. Version prüfen

clickhouse-client --version

Prüfen: Es erscheint z. B. ClickHouse client version 26.8.15.10 (official build).

Vor dem ersten Start einrichten

Das Paket meldet den Dienst für den Systemstart an, startet ihn aber noch nicht.

8. Absturzberichte abschalten

ClickHouse schickt in der Grundeinstellung nach einem Absturz einen anonymisierten Bericht an die Entwickler. Wer das nicht möchte, legt eine Ergänzungsdatei an. Dateien im Ordner config.d ergänzen die große Hauptdatei config.xml, die bei Updates ersetzt werden kann.

sudo nano /etc/clickhouse-server/config.d/keine-absturzberichte.xml

Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

<clickhouse>
    <send_crash_reports>
        <enabled>false</enabled>
    </send_crash_reports>
</clickhouse>

9. Dienst starten

sudo systemctl start clickhouse-server

10. Prüfen, ob der Dienst läuft

systemctl status clickhouse-server

Prüfen: In der Ausgabe steht active (running) und weiter unten Merging configuration file '/etc/clickhouse-server/config.d/keine-absturzberichte.xml'. Die Ergänzung aus Schritt 8 wurde also gelesen. Beende die Anzeige mit q.

11. Prüfen, dass ClickHouse nur lokal lauscht

sudo ss -ltnp | grep clickhouse

Prüfen: Alle Zeilen enthalten 127.0.0.1 oder [::1]. Neben 8123 und 9000 erscheinen die Ports 9004 und 9005: Über sie verstehen auch Programme für MySQL und PostgreSQL ClickHouse. Port 9009 dient dem Austausch zwischen mehreren ClickHouse-Servern.

12. Lebenszeichen abfragen

Die Adresse /ping antwortet auch ohne Anmeldung.

curl http://127.0.0.1:8123/ping

Prüfen: Die Antwort lautet Ok.

Anmeldedaten hinterlegen

clickhouse-client fragt sonst bei jedem Aufruf nach dem Passwort. Er liest aber eine Einstellungsdatei im eigenen Home-Ordner, in der das Passwort stehen kann.

13. Ordner anlegen

mkdir -p ~/.clickhouse-client

14. Einstellungsdatei anlegen

nano ~/.clickhouse-client/config.xml

Füge diesen Inhalt ein (Strg+Umschalt+V) und ersetze DEIN-PASSWORT durch das Passwort aus Schritt 6. Speichere mit Strg+O und Enter und beende nano mit Strg+X.

<config>
    <user>default</user>
    <password>DEIN-PASSWORT</password>
</config>

15. Datei schützen

Nur du darfst die Datei lesen und ändern.

chmod 600 ~/.clickhouse-client/config.xml

16. Anmeldung testen

-q übergibt eine einzelne Abfrage und beendet den Client danach wieder.

clickhouse-client -q "SELECT version()"

Prüfen: Es erscheint die Versionsnummer, z. B. 26.8.15.10. Erscheint Authentication failed, stimmt das Passwort in der Datei nicht.

Wetterdaten erzeugen

Statt Daten herunterzuladen, lässt das Beispiel ClickHouse selbst Messwerte erfinden: für vier Orte jede Minute einen Wert für Temperatur und Regen, fünf Jahre lang. Das ergibt gut 10,5 Millionen Zeilen.

17. Übungsordner anlegen

mkdir -p ~/clickhouse-uebung

18. In den Ordner wechseln

cd ~/clickhouse-uebung

19. SQL-Datei anlegen

nano wetter.sql

Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

CREATE DATABASE IF NOT EXISTS uebung;

CREATE TABLE IF NOT EXISTS uebung.wetter
(
    zeit       DateTime,
    station    LowCardinality(String),
    temperatur Float32,
    regen      Float32
)
ENGINE = MergeTree
ORDER BY (station, zeit);

INSERT INTO uebung.wetter
SELECT
    toDateTime('2021-01-01 00:00:00') + intDiv(number, 4) * 60 AS zeit,
    ['Ahrensburg', 'Bargteheide', 'Hamburg', 'Lübeck'][number % 4 + 1] AS station,
    round(10 - 9 * cos(2 * pi() * toDayOfYear(zeit) / 365)
             - 4 * cos(2 * pi() * (toHour(zeit) - 3) / 24)
             + randNormal(0, 1), 1) AS temperatur,
    if(rand() % 100 = 0, round(randExponential(7), 1), 0) AS regen
FROM numbers(4 * 60 * 24 * 1826);

Was die Teile bewirken:

  • LowCardinality(String) – für Spalten mit wenigen verschiedenen Texten. ClickHouse speichert jeden Ortsnamen nur einmal und in der Tabelle nur eine kleine Nummer.
  • ENGINE = MergeTree – die übliche Speicherart von ClickHouse für große Tabellen.
  • ORDER BY (station, zeit) – die Zeilen liegen nach Ort und Zeit sortiert auf der Festplatte. Abfragen, die nach Ort oder Zeitraum filtern, müssen dadurch nur einen kleinen Teil lesen.
  • numbers(…) – liefert die Zahlen 0, 1, 2 … bis zur angegebenen Anzahl. Daraus werden Zeit und Ort berechnet: 4 Orte × 60 Minuten × 24 Stunden × 1826 Tage.
  • temperatur – im Jahresverlauf zwischen etwa 1 °C im Januar und 19 °C im Juli, nachts kühler als nachmittags, dazu etwas Zufall.
  • regen – in etwa jeder hundertsten Minute fällt eine zufällige Regenmenge, im Jahr kommen so gut 700 mm zusammen.

20. SQL-Datei ausführen

--multiquery erlaubt mehrere Befehle hintereinander. < gibt den Inhalt der Datei an den Client weiter.

clickhouse-client --multiquery < wetter.sql

Das dauert nur ein bis zwei Sekunden.

21. Zeilen zählen

clickhouse-client -q "SELECT count() FROM uebung.wetter"

Prüfen: Die Antwort lautet 10517760.

22. Platzbedarf ansehen

Die Tabelle system.parts beschreibt, wie ClickHouse die Daten auf der Festplatte abgelegt hat.

clickhouse-client -q "SELECT formatReadableSize(sum(data_compressed_bytes)) AS gepackt, formatReadableSize(sum(data_uncompressed_bytes)) AS entpackt FROM system.parts WHERE database = 'uebung' AND active"

Prüfen: Es erscheinen zwei Größen, etwa 68 MiB gepackt und 91 MiB entpackt. Die Zufallswerte lassen sich schlecht packen. Echte Messwerte, die sich von Minute zu Minute wenig ändern, schrumpfen meist auf einen Bruchteil.

Auswerten

Ab hier weichen die Zahlen bei dir leicht ab, weil die Messwerte zufällig erzeugt wurden.

23. Kommandozeile öffnen

Ohne -q öffnet clickhouse-client eine Eingabezeile. Ergebnisse erscheinen dort als Tabelle, darunter steht, wie lange die Abfrage gedauert hat.

clickhouse-client

Prüfen: Es erscheint Connected to ClickHouse server version 26.8.15. und darunter die Eingabezeile mit dem Rechnernamen und :). Eine Warnung zu Delay accounting kannst du übergehen. Sie betrifft nur eine Messgröße für Wartezeiten der Festplatte.

Die Abfragen der nächsten Schritte fügst du jeweils komplett ein (Strg+Umschalt+V) und drückst dann Enter.

24. Kennzahlen je Ort berechnen

ClickHouse rechnet hier über alle 10,5 Millionen Zeilen.

SELECT station,
       round(avg(temperatur), 1) AS mittel,
       min(temperatur)           AS tiefster,
       max(temperatur)           AS hoechster,
       round(sum(regen) / 5)     AS regen_pro_jahr
FROM uebung.wetter
GROUP BY station
ORDER BY station;

Prüfen: Es erscheinen vier Zeilen mit einem Mittel von etwa 10 °C und rund 730 mm Regen pro Jahr. Unter der Tabelle steht Elapsed: mit einer Zeit von meist unter 0,1 Sekunden.

25. Monatsmittel für einen Ort berechnen

toMonth macht aus jedem Zeitpunkt die Nummer des Monats.

SELECT toMonth(zeit) AS monat,
       round(avg(temperatur), 1) AS mittel
FROM uebung.wetter
WHERE station = 'Ahrensburg'
GROUP BY monat
ORDER BY monat;

Prüfen: Das Mittel steigt von etwa 1,4 °C im Januar auf etwa 18,6 °C im Juni und Juli und fällt danach wieder. Unter der Tabelle steht Processed 2.63 million rows: ClickHouse hat nur ein Viertel der Tabelle gelesen. Weil die Zeilen nach Ort sortiert gespeichert sind (ORDER BY in Schritt 19), findet es die Werte für Ahrensburg, ohne die anderen Orte durchzusehen.

26. Sommertage im Jahr 2025 zählen

Ein Sommertag ist ein Tag mit mindestens 25 °C. Die innere Abfrage ermittelt den Höchstwert jedes Tages, die äußere zählt mit countIf nur die Tage, die die Bedingung erfüllen.

SELECT station,
       countIf(hoechst >= 25) AS sommertage
FROM
(
    SELECT station, toDate(zeit) AS tag, max(temperatur) AS hoechst
    FROM uebung.wetter
    WHERE toYear(zeit) = 2025
    GROUP BY station, tag
)
GROUP BY station
ORDER BY station;

Prüfen: Je Ort erscheinen etwa 40 bis 55 Sommertage.

27. Kommandozeile verlassen

exit

Daten aus einer CSV-Datei laden

28. CSV-Datei anlegen

nano stationen.csv

Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

station,kreis,hoehe
Ahrensburg,Stormarn,25
Bargteheide,Stormarn,41
Hamburg,Hamburg,6
Lübeck,Lübeck,13

29. Tabelle für die Stationen anlegen

UInt16 ist eine ganze Zahl ohne Vorzeichen bis 65535, das reicht für die Höhe in Metern.

clickhouse-client -q "CREATE TABLE uebung.stationen (station String, kreis String, hoehe UInt16) ENGINE = MergeTree ORDER BY station"

30. CSV-Datei laden

FORMAT CSVWithNames sagt ClickHouse, dass die Daten als CSV mit einer Kopfzeile kommen.

clickhouse-client -q "INSERT INTO uebung.stationen FORMAT CSVWithNames" < stationen.csv

31. Beide Tabellen verbinden

JOIN verknüpft jede Messung über den Ortsnamen mit den Angaben zur Station.

clickhouse-client -q "SELECT s.kreis, w.station, s.hoehe, round(sum(w.regen) / 5) AS regen_pro_jahr FROM uebung.wetter AS w JOIN uebung.stationen AS s ON w.station = s.station GROUP BY s.kreis, w.station, s.hoehe ORDER BY s.kreis, w.station" --format PrettyCompact

Prüfen: Es erscheinen vier Zeilen. Ahrensburg und Bargteheide stehen beide beim Kreis Stormarn. --format PrettyCompact zeichnet die Tabelle mit Rahmen, ohne die Angabe gibt -q die Werte nur durch Tabulatoren getrennt aus.

Weboberfläche

32. SQL-Seite im Browser öffnen

ClickHouse bringt eine einfache Seite mit, auf der man Abfragen eingeben und als Tabelle ansehen kann. Öffne im Browser:

http://127.0.0.1:8123/play

Trage oben rechts als Benutzer default und das Passwort aus Schritt 6 ein. Gib dann z. B. SELECT * FROM uebung.stationen ein und klicke auf Run.

Prüfen: Unter dem Eingabefeld erscheinen die vier Stationen.

Sichern und wiederherstellen

Eine einfache Sicherung ist der Export einer Tabelle in eine Datei im Format Parquet. Das Format ist verbreitet und gepackt, DuckDB, Python mit pandas und viele andere Programme können es direkt lesen.

33. Tabelle exportieren

clickhouse-client -q "SELECT * FROM uebung.wetter FORMAT Parquet" > wetter.parquet

Prüfen: Die Datei ist rund 54 MB groß.

ls -lh wetter.parquet

34. Tabelle leeren

Nur zum Ausprobieren der Wiederherstellung: TRUNCATE löscht alle Zeilen, die Tabelle selbst bleibt bestehen.

clickhouse-client -q "TRUNCATE TABLE uebung.wetter"

35. Sicherung zurückspielen

clickhouse-client -q "INSERT INTO uebung.wetter FORMAT Parquet" < wetter.parquet

Prüfen: Der Befehl aus Schritt 21 meldet wieder 10517760.

Die Tabellenbeschreibung ist in der Parquet-Datei nicht vollständig enthalten. Für eine neue Datenbank legst du die Tabelle deshalb zuerst wie in Schritt 19 an und spielst dann die Daten ein.

Optional: Autostart ausschalten

Wer ClickHouse nur ab und zu braucht, nimmt es aus dem Systemstart heraus und startet es bei Bedarf mit sudo systemctl start clickhouse-server.

sudo systemctl disable --now clickhouse-server

Wie geht es weiter?

  • Eigene Benutzer: Für Programme legt man mit CREATE USER eigene Benutzer an und gibt ihnen mit GRANT nur die nötigen Rechte, statt überall default zu verwenden.
  • Ohne Server: clickhouse-local (im Paket enthalten) wertet CSV-, JSON- oder Parquet-Dateien mit derselben SQL-Sprache aus, ohne dass der Dienst laufen muss.
  • Aus Programmen zugreifen: Es gibt offizielle Bibliotheken für Python (clickhouse-connect), Go, Java und JavaScript. Alle nutzen Port 8123 oder 9000.
  • Zugriff aus dem Netz: Dafür wird in einer Datei in config.d die Einstellung listen_host geändert. Die Ports sollten dann per Firewall nur für bekannte Rechner offen sein.
  • Dokumentation: Die SQL-Befehle und Funktionen sind unter https://clickhouse.com/docs/sql-reference beschrieben.

Deinstallieren

1. Übungsordner und Einstellungsdatei löschen

rm -rf ~/clickhouse-uebung ~/.clickhouse-client

2. Dienst anhalten

sudo systemctl stop clickhouse-server

3. ClickHouse entfernen

sudo apt purge clickhouse-server clickhouse-client clickhouse-common-static

4. Übrige Dateien löschen

Die Pakete von ClickHouse räumen beim Entfernen nicht vollständig auf. apt meldet deshalb, dass /etc/clickhouse-server nicht leer ist. Dieser Befehl löscht die Konfiguration, die Datenbanken, die Protokolle, die Einstellung für die Zahl offener Dateien und zwei Verknüpfungen in /usr/bin, die bei der Installation angelegt wurden. Achtung: Alle Daten in ClickHouse sind danach unwiderruflich weg.

sudo rm -rf /etc/clickhouse-server /etc/clickhouse-keeper /var/lib/clickhouse /var/log/clickhouse-server /var/log/clickhouse-keeper /etc/security/limits.d/clickhouse.conf /usr/bin/clickhouse-disks /usr/bin/clickhouse-git-import

5. Systembenutzer entfernen

Die Installation hat für den Dienst den Benutzer clickhouse und eine gleichnamige Gruppe angelegt. Die Gruppe wird mit dem Benutzer entfernt.

sudo deluser clickhouse

6. Paketquelle und Schlüssel löschen

sudo rm /etc/apt/sources.list.d/clickhouse.sources /etc/apt/keyrings/clickhouse.asc

7. Paketlisten aktualisieren

Danach kennt apt die Pakete von ClickHouse nicht mehr.

sudo apt update

Prüfen: Der Befehl clickhouse-client wird nicht mehr gefunden.

clickhouse-client --version

Quellen und Lizenz

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.