OLAP Query Builder di Elysia-Light
Elysia-Light menyediakan query builder OLAP ringan di atas ClickHouse client resmi. Query builder ini dirancang untuk menulis query analitik dengan cara yang lebih aman, terstruktur, dan mudah dibaca tanpa kehilangan fleksibilitas SQL ClickHouse.
Tujuan Query Builder OLAP
Query builder ini dibuat untuk kebutuhan baca analitik (read-heavy) dan insert data log/metric. Ia tidak mencoba menjadi ORM penuh, melainkan helper untuk membangun query OLAP yang eksplisit dan predictable.
Query Data Analitik
Gunakan da.select() atau da.from() untuk memulai query. Semua method dapat di-chain seperti query builder pada umumnya.
Kode berhasil di copy!
5
Where Clause
Method where mendukung operator eksplisit dan otomatis melakukan escaping sederhana untuk string.
Kode berhasil di copy!
5
Pagination Manual (Limit & Offset)
ClickHouse tidak dirancang untuk pagination OLTP klasik. Limit dan offset disediakan untuk kebutuhan analitik atau debugging.
Kode berhasil di copy!
5
Mengambil Satu Record
Gunakan first() untuk mengambil satu baris data pertama dari hasil query.
Kode berhasil di copy!
5
Insert Data ke ClickHouse
Untuk insert data, gunakan da.insert. Method ini mendukung batch insert dengan format JSONEachRow agar performa tetap optimal.
Kode berhasil di copy!
5
Batch Insert
Batch insert sangat dianjurkan untuk OLAP. Kirim data dalam array untuk efisiensi jaringan dan storage.
Kode berhasil di copy!
5
Raw Query
Jika query builder tidak mencukupi, gunakan exec untuk mengeksekusi SQL ClickHouse mentah.
Kode berhasil di copy!
5
Best Practice
Gunakan ClickHouse sebagai append-only storage. Hindari update/delete baris individual. Gunakan batch insert dan query eksplisit. Query builder ini adalah alat bantu, bukan ORM transaksi.