ClickHouse¶

In dit artikel

• ClickHouse. Kernfuncties
• Implementatiefuncties
• Aan de slag na het implementeren van ClickHouse
• Verbinding maken met ClickHouse
• Kernoperaties in ClickHouse
• Een server met ClickHouse bestellen

ClickHouse. Kernfuncties¶

• Kolomgebaseerde opslag: gegevens worden per kolom in plaats van per rij opgeslagen, wat de uitvoering van analytische queries aanzienlijk versnelt en de hoeveelheid verwerkte gegevens vermindert.
• Hoge prestaties: geoptimaliseerd voor het verwerken van enorme datasets en in staat om queries uit te voeren op miljarden rijen dankzij vectorisatie en efficiënt CPU-gebruik.
• Gegevenscompressie: maakt gebruik van gespecialiseerde compressie-algoritmen die de hoeveelheid opgeslagen gegevens drastisch kunnen verminderen (vaak vele malen kleiner dan bij rijgebaseerde DBMS), vooral bij analytische workloads.
• SQL-compatibiliteit: ondersteunt uitgebreide SQL-syntax met extra analytische functies, wat de migratie van bestaande applicaties vereenvoudigt.
• Gedistribueerde verwerking: maakt de creatie van clusters mogelijk voor horizontale schaalbaarheid en gegevensverwerking over meerdere servers.
• Gegevensreplicatie: ingebouwde ondersteuning voor replicatie zorgt voor fouttolerantie en een hoge beschikbaarheid van gegevens.
• Ondersteuning voor meerdere gegevensformaten: kan gegevens importeren en exporteren in CSV, JSON, Parquet, Avro en andere formaten.
• Materialized views: aggregeert automatisch gegevens op de achtergrond om terugkerende queries te versnellen.
• Integratie met externe bronnen: ondersteunt direct lezen van gegevens uit MySQL, PostgreSQL, MongoDB, Kafka, S3 en andere systemen.

Implementatiefuncties¶

Aan de slag na het implementeren van ClickHouse¶

Nadat de bestelling is betaald, wordt er een melding naar het e-mailadres gestuurd dat is opgegeven tijdens de registratie, dat de server klaar is voor gebruik. Deze melding bevat het IP-adres van de VPS, evenals de login en het wachtwoord voor de verbinding. Klanten van ons bedrijf beheren de hardware in het server- en API-beheerderspaneel - Invapi.

Inloggegevens:

• Server IP-adres: verstrekt in de e-mail en in het beheerderspaneel;
• Login: default;
• Wachtwoord: komt overeen met het wachtwoord van het root-account en wordt naar het e-mailadres verzonden.

Verbinding maken met ClickHouse¶

Verbinding maken via clickhouse-client¶

ClickHouse bevat een native command-line client voor database-operaties.

1. Verbinding maken vanaf de server (lokaal):

clickhouse-client

2. Verbinding maken vanaf een externe machine:

clickhouse-client --host <IP-adres> --port 9000 --user default --password <wachtwoord>

3. Een eenvoudige query uitvoeren:

SELECT version();

4. De lijst met databases bekijken:

SHOW DATABASES;

Verbinding maken via DBeaver¶

DBeaver is een universele GUI-client voor het werken met verschillende databases, waaronder ClickHouse.

1. DBeaver installeren

Download en installeer DBeaver vanaf de officiële website.

2. Een nieuwe verbinding maken

• Start DBeaver
• Selecteer Database >> New Database Connection (of druk op Ctrl+Shift+N)

• Zoek in de lijst met databases naar ClickHouse en selecteer deze

• Klik op Next

3. Verbindingsparameters configureren

Geef in het instellingenvenster de volgende parameters op:

Host: <IP-adres van uw server>
Port: 8123
Database/Schema: (leeg laten of de standaard opgeven)
Username: default
Password: <root_password>

4. De JDBC-driver downloaden

Wanneer u voor het eerst verbinding maakt, vraagt DBeaver u om de JDBC-driver voor ClickHouse te downloaden:

• Klik op Download in het pop-upvenster:

• Wacht tot de driver is gedownload:

• Klik op OK

5. De verbinding testen

• Klik op Test Connection;
• Als alles correct is geconfigureerd, verschijnt er een melding: Connected (XXX ms):

• De melding bevat:
• Server: ClickHouse X.X.X.XXX
• Driver: ClickHouse JDBC Driver X.X.X

6. Installatie afronden

• Klik op Finish;
• De verbinding verschijnt in de Database Navigator;
• Vouw de boomstructuur van de verbinding uit om databases, tabellen en andere objecten te bekijken.

Veelvoorkomende problemen:

Kernoperaties in ClickHouse¶

Een database maken¶

CREATE DATABASE IF NOT EXISTS my_database;

Een tabel maken¶

CREATE TABLE my_database.events
(
    event_date Date,
    event_time DateTime,
    user_id UInt32,
    event_type String,
    value Float64
)
ENGINE = MergeTree()
PARTITION BY toYYYYMM(event_date)
ORDER BY (event_date, user_id);

Gegevens invoegen¶

INSERT INTO my_database.events VALUES
    ('2024-12-25', '2024-12-25 10:00:00', 1, 'click', 1.5),
    ('2024-12-25', '2024-12-25 10:05:00', 2, 'view', 2.3),
    ('2024-12-25', '2024-12-25 10:10:00', 1, 'purchase', 99.99);

Gegevens selecteren¶

Eenvoudige query:

SELECT * FROM my_database.events LIMIT 10;

Gegevens aggregeren:

SELECT 
    event_type,
    count() as events_count,
    avg(value) as avg_value
FROM my_database.events
WHERE event_date = '2024-12-25'
GROUP BY event_type;

Tijdreeksen:

SELECT 
    toStartOfHour(event_time) as hour,
    count() as events_per_hour
FROM my_database.events
WHERE event_date >= '2024-12-01'
GROUP BY hour
ORDER BY hour;

Gegevens importeren uit CSV¶

Een tabel maken:

CREATE TABLE my_database.logs
(
    timestamp DateTime,
    level String,
    message String
)
ENGINE = MergeTree()
ORDER BY timestamp;

Gegevens importeren:

INSERT INTO my_database.logs
FROM INFILE '/path/to/file.csv'
FORMAT CSV;

Gebruikers en privileges beheren¶

Een gebruiker maken:

CREATE USER analyst IDENTIFIED BY 'secure_password';

Rechten verlenen:

GRANT SELECT ON my_database.* TO analyst;

Gebruikers bekijken:

SHOW USERS;

Privileges bekijken:

SHOW GRANTS FOR analyst;

De service beheren¶

De service starten:

clickhouse start

De service stoppen:

clickhouse stop

De service herstarten:

clickhouse restart

Status van de service:

clickhouse status

Logs bekijken:

tail -f /var/log/clickhouse-server/clickhouse-server.log

Actieve poorten controleren¶

Om te zien op welke poorten ClickHouse luistert:

ss -tlnp | grep clickhouse

Of gedetailleerder:

ss -tlnp | grep $(pidof clickhouse-server)

Om geconfigureerde poorten in de configuratie te controleren:

cat /etc/clickhouse-server/config.xml | grep -E "port>" | head -20

Om een specifieke poort te controleren:

ss -tlnp | grep :8123

Verwachte output van de poortcontrole:

LISTEN  *:8123  clickhouse-serv  (HTTP)
LISTEN  *:9000  clickhouse-serv  (Native TCP)
LISTEN  *:9004  clickhouse-serv  (MySQL)
LISTEN  *:9005  clickhouse-serv  (PostgreSQL)
LISTEN  *:9009  clickhouse-serv  (Interserver)

Een server met ClickHouse bestellen¶

Om deze software te installeren met behulp van de API, volgt u deze instructies.