OLAP Query Builder di Skalfa API
Skalfa API 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.
Keterangan Ekstensi:Untuk mengaktifkan dukungan Data Analytics ClickHouse (OLAP), jalankan perintah CLI berikut di proyek backend Anda:
Kode berhasil di copy!
5
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.