ClickHouse¶

Bu makalede

• ClickHouse Temel Özellikleri
• Çalıştırma Özellikleri
• ClickHouse Kurulumundan Sonra Başlangıç
• ClickHouse'a Bağlanma
• ClickHouse ile Temel İşlemler
• ClickHouse İçeren Bir Sunucu Sipariş Etme

ClickHouse Temel Özellikleri¶

• Sütun tabanlı depolama: Veriler satırlar yerine sütunlar halinde saklanır; bu da analitik sorgu yürütme hızını önemli ölçüde artırır ve işlenen veri hacmini azaltır.
• Yüksek performans: Devasa veri kümelerini işlemek için optimize edilmiştir; vektörel işlem ve verimli CPU kullanımı sayesinde milyarlarca satır üzerinde sorgu yürütebilir.
• Veri sıkıştırma: Özellikle analitik iş yükleri altında, depolanan veri miktarını dramatik bir şekilde azaltabilen (genellikle satır tabanlı DBMS'lerden birkaç kat daha küçük) özel sıkıştırma algoritmaları kullanır.
• SQL uyumluluğu: Ek analitik fonksiyonlar içeren genişletilmiş SQL sözdizimini destekleyerek mevcut uygulamaların taşınmasını kolaylaştırır.
• Dağıtık işleme: Yatay ölçeklendirme ve birden fazla sunucu arasında veri işleme için küme (cluster) oluşturulmasına olanak tanır.
• Veri replikasyonu: Yerleşik replikasyon desteği hata toleransı ve yüksek veri kullanılabilirliği sağlar.
• Çoklu veri formatı desteği: CSV, JSON, Parquet, Avro ve diğer formatlarda veri içe aktarabilir ve dışa aktarabilir.
• Materialized views: Tekrarlayan sorguları hızlandırmak için arka planda verileri otomatik olarak toplu halde (aggregate) işler.
• Harici kaynaklarla entegrasyon: MySQL, PostgreSQL, MongoDB, Kafka, S3 ve diğer sistemlerden doğrudan veri okumayı destekler.

Çalıştırma Özellikleri¶

ClickHouse Kurulumundan Sonra Başlangıç¶

Sipariş ödemesi yapıldıktan sonra sunucunun çalışmaya hazır olduğuna dair kayıt sırasında belirtilen e-posta adresine bir bildirim gönderilecektir. Bu bildirim, VPS'in IP adresinin yanı sıra bağlantı için kullanıcı adı ve şifreyi içerecektir. Şirketimizin müşterileri, sunuculardaki donanımı ve API kontrol panelini - Invapi üzerinden yönetirler.

Yetkilendirme ayrıntıları:

• Server IP address: e-posta ile ve kontrol panelinde sağlanır;
• Login: default;
• Password: root hesabının şifresiyle aynıdır ve e-posta adresine gönderilir.

ClickHouse'a Bağlanma¶

clickhouse-client ile Bağlanma¶

ClickHouse, veritabanı işlemleri için yerel bir komut satırı istemcisi içerir.

1. Sunucudan bağlanma (yerel):

clickhouse-client

2. Uzak bir makineden bağlanma:

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

3. Basit bir sorgu çalıştırma:

SELECT version();

4. Veritabanı listesini görüntüleme:

SHOW DATABASES;

DBeaver ile Bağlanma¶

DBeaver, ClickHouse dahil olmak üzere çeşitli veritabanları ile çalışmak için evrensel bir GUI istemcisidir.

1. DBeaver Kurulumu

Resmi web sitesinden DBeaver'ı indirin ve kurun.

2. Yeni bir bağlantı oluşturma

• DBeaver'ı başlatın
• Database >> New Database Connection seçeneğini seçin (veya Ctrl+Shift+N tuşlarına basın)

• Veritabanı listesinde ClickHouse öğesini bulun ve seçin

• Next düğmesine tıklayın

3. Bağlantı parametrelerini yapılandırma

Ayarlar penceresinde aşağıdaki parametreleri belirtin:

Host: <Sunucunuzun IP adresi>
Port: 8123
Database/Schema: (boş bırakın veya varsayılanı belirtin)
Username: default
Password: <root_password>

4. JDBC sürücüsünü indirme

İlk kez bağlandığınızda, DBeaver ClickHouse için JDBC sürücüsünü indirmeniz için sizi yönlendirecektir:

• Açılır penceredeki Download düğmesine tıklayın:

• Sürücünün indirilmesinin tamamlanmasını bekleyin:

• OK düğmesine tıklayın

5. Bağlantıyı test etme

• Test Connection düğmesine tıklayın;
• Her şey doğru yapılandırılmışsa, şu mesaj görünecektir: Connected (XXX ms):

• Mesaj şunları içerecektir:
• Server: ClickHouse X.X.X.XXX
• Driver: ClickHouse JDBC Driver X.X.X

6. Kurulumu tamamlama

• Finish düğmesine tıklayın;
• Bağlantı Database Navigator'da görünecektir;
• Veritabanlarını, tabloları ve diğer nesneleri görüntülemek için bağlantı ağacını genişletin.

Yaygın sorunlar:

ClickHouse ile Temel İşlemler¶

Veritabanı oluşturma¶

CREATE DATABASE IF NOT EXISTS my_database;

Tablo oluşturma¶

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);

Veri ekleme¶

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);

Veri seçme¶

Basit sorgu:

SELECT * FROM my_database.events LIMIT 10;

Verileri toplulaştırma (Aggregation):

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;

Zaman serisi:

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;

CSV'den veri içe aktarma¶

Tablo oluşturma:

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

Veri içe aktarma:

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

Kullanıcı ve yetki yönetimi¶

Kullanıcı oluşturma:

CREATE USER analyst IDENTIFIED BY 'secure_password';

Yetki verme:

GRANT SELECT ON my_database.* TO analyst;

Kullanıcıları görüntüleme:

SHOW USERS;

Yetkileri görüntüleme:

SHOW GRANTS FOR analyst;

Servis yönetimi¶

Servisi başlatma:

clickhouse start

Servisi durdurma:

clickhouse stop

Servisi yeniden başlatma:

clickhouse restart

Servis durumu:

clickhouse status

Logları görüntüleme:

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

Aktif portları kontrol etme¶

ClickHouse'un hangi portları dinlediğini görmek için:

ss -tlnp | grep clickhouse

Veya daha detaylı:

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

Yapılandırmadaki yapılandırılmış portları kontrol etmek için:

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

Belirli bir portu kontrol etmek için:

ss -tlnp | grep :8123

Beklenen port kontrol çıktısı:

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)

ClickHouse İçeren Bir Sunucu Sipariş Etme¶

Bu yazılımı API kullanarak kurmak için bu talimatları izleyin.