Dalang (Data Analytics LANGuage)

Dalang adalah bahasa analisis data yang mudah dibaca, dirancang untuk pengguna DAX/Power BI dan analis data, dari pemula awam sampai mahir. Konteks perhitungan selalu tertulis eksplisit di kode, dan pesan error berbahasa Indonesia.

LET sales = LOAD CSV "penjualan.csv"

MODEL Store
    TABLES sales
    CALENDAR sales.tanggal
    MEASURE Omzet = SUM(sales.nilai)
    MEASURE Growth = (Omzet - Omzet PREVIOUS YEAR) / Omzet PREVIOUS YEAR
END MODEL

SHOW Omzet, Growth BY kota WHERE YEAR = 2025
EXPLAIN Omzet AT kota = "Jakarta", YEAR = 2025

Status versi 0.3.0

Versi 0.3.0 menambahkan JOIN, RANK, file Excel dan Parquet, serta EXPORT ke DAX. Versi 0.2.0 menambahkan MODEL: measure yang dihitung ulang di dalam konteks, seperti DAX, tetapi semua konteksnya tertulis di kode. Kesepuluh Program Target (1–9 dan kasus error E1–E6) kini lolos sebagai golden test.

• dal run: menjalankan file .dal (diterjemahkan ke Python, lalu dijalankan di atas DuckDB).
  • --set nama=nilai mengganti nilai PARAMETER (boleh berulang).
  • --show-python menampilkan kode Python hasil terjemahan.
• dal check: memeriksa file .dal tanpa menjalankannya.
• dal parse: menampilkan cara Dalang membaca program, dengan setiap ekspresi berkurung lengkap.

MODEL (baru di 0.2.0)

LET sales = LOAD CSV "penjualan.csv"
LET products = LOAD CSV "produk.csv"

MODEL Store
    TABLES sales, products
    RELATE sales.kode TO products.kode
    CALENDAR sales.tanggal
    MEASURE Omzet = SUM(sales.nilai)
    MEASURE Growth = (Omzet - Omzet PREVIOUS YEAR) / Omzet PREVIOUS YEAR
END MODEL

SHOW Omzet, Omzet PREVIOUS YEAR, Growth BY kota WHERE YEAR = 2025 WITH totals: TRUE

kota     Omzet  Omzet PREVIOUS YEAR  Growth
-------  -----  -------------------  ------
Bandung    100                   50  100,0%
Jakarta    290                  170   70,6%
Total      390                  220   77,3%

• RELATE: filter mengalir dari tabel "satu" ke tabel "banyak" (BY products.kategori menyaring sales). Kunci sisi "satu" wajib unik. Baris tanpa pasangan masuk kelompok MISSING, disertai peringatan.
• CALENDAR: dimensi waktu YEAR, QUARTER, MONTH, WEEK (ISO), DAY tanpa tabel tanggal terpisah. Kalender hanya mencakup rentang data.
• Pengubah: PREVIOUS YEAR, LAST 3 MONTH, YEAR TO DATE, IGNORE FILTER kota, AS SHARE OF kota, (Omzet WHERE kota = "Jakarta") (irisan, tidak menimpa), Omzet AT kota = "Jakarta", YEAR = 2025.
• MEAN(Omzet) FOR EACH ROW OF products: iterasi dengan measure di dalamnya.
• SHOW TOP 2 products BY Omzet, EXPLAIN Omzet AT … (menunjukkan rumus, filter, dan jumlah baris), TEST … EXPECT … END TEST.
• WITH totals: TRUE dihitung ulang (bukan dijumlah); baris yang semua nilainya MISSING disembunyikan kecuali WITH show_empty: TRUE.
• Measure juga bisa dipakai di IF, LET, dan fungsi biasa: IF (Growth WHERE kota = k AND YEAR = tahun) IS MISSING THEN ….
• Tampilan persen otomatis: pembagian dua besaran yang sama (misalnya Omzet dibagi Omzet tahun lalu) dan AS SHARE OF ditampilkan sebagai 70,6%. Nilai aslinya tetap 0,706.

Baru di 0.3.0

• LOAD EXCEL "laporan.xlsx" WITH sheet: "Juni", LOAD PARQUET "data.parquet", serta SAVE … AS EXCEL dan SAVE … AS PARQUET. Kolom file Excel dan Parquet ikut diperiksa oleh dal check. Excel butuh pip install "dalang[excel]".
• JOIN sales, products ON sales.kode = products.kode: semua baris kiri tetap ada (LEFT JOIN). Kunci yang sama tidak diulang, nama kolom yang bentrok diberi akhiran _<tabel kanan>, dan ada peringatan bila baris tidak punya pasangan atau berlipat.
• RANK sales BY nilai (setiap baris diberi Peringkat) dan, dengan MODEL, RANK kota BY Omzet (setiap nilai kolom). Nilai sama mendapat peringkat yang sama (1, 2, 2, 4).
• EXPORT Store TO DAX (atau EXPORT Omzet, Growth TO DAX WITH file: "store.dax"): menulis tabel kalender, relasi, dan measure DAX yang siap ditempel di Power BI Desktop. Contoh:

Growth = DIVIDE([Omzet] - CALCULATE([Omzet], DATEADD(Kalender[Date], -1, YEAR)), CALCULATE([Omzet], DATEADD(Kalender[Date], -1, YEAR)))
Omzet_Jkt = CALCULATE([Omzet], KEEPFILTERS(sales[kota] = "Jakarta"), KEEPFILTERS(Kalender[Tahun] = 2025))
Per_Produk = AVERAGEX(products, [Omzet])

WHERE pada measure diterjemahkan dengan KEEPFILTERS agar tetap irisan seperti di Dalang. Fungsi Python di dalam measure tidak punya padanan DAX dan ditulis sebagai komentar.

Yang sudah bisa dijalankan sejak 0.1.0

• LOAD CSV (pemisah ;, ,, tab, atau | dikenali otomatis), SAVE ... AS CSV;
• tabel: WHERE, SELECT, SORT BY ... DESCENDING, TOP n tabel BY kolom, kolom baru LET sales.pajak = nilai * 0.11, RENAME, REMOVE, FILL, APPEND;
• SHOW ringkasan SUM/MEAN/MEDIAN/MIN/MAX/COUNT/COUNTDISTINCT/STDEV/VARIANCE dengan BY dan WHERE, serta opsi rows, totals, show_empty;
• PLOT ... BY ...: grafik teks di layar, dan file PNG bila matplotlib terpasang;
• LET, SET, PARAMETER, IF, FOR, FOR EACH, WHILE, EXIT, CONTINUE, FUNCTION, RETURN, TRY/CATCH, FAIL;
• USE PYTHON "paket" AS alias;
• aturan MISSING dan angka format Indonesia (1.250.000, 42,9).

Keamanan: nilai dari program tidak pernah disambung ke teks SQL. Semua nilai dikirim sebagai parameter kueri.

Belum didukung (pesan jelas, program tidak dijalankan sebagian): EXPORT … TO SQL/PYTHON, ASK, FORECAST, REGRESS, USE R, modul .dal. Pengubah waktu belum bisa menggeser filter periodik seperti WHERE MONTH = 3 (pakai BY MONTH atau WHERE YEAR = …).

Yang diperiksa dal check:

• seluruh susunan kalimat menurut Tata Bahasa v0.1 (misalnya IF tanpa THEN, WHERE tanpa kurung di dalam syarat IF/EXPECT, MEASURE di luar MODEL, kata kunci dipakai sebagai nama);
• teks yang belum ditutup, karakter tak dikenal, kurung tak berpasangan, != (gunakan <>);
• bentuk lama yang tidak berlaku (PRINT, REM, ELSEIF, NEXT sebagai penutup FOR, DESC, satuan jamak seperti MONTHS);
• nama dan kolom yang tidak ada, dengan saran nama yang mirip (dibaca dari header CSV);
• aturan MODEL: TABLES wajib, kunci RELATE unik, CALENDAR bertipe tanggal, nama measure tidak sama dengan nama kolom;
• PREVIOUS, LAST, dan ... TO DATE tanpa konteks waktu, termasuk lewat measure lain;
• operasi aritmetika pada teks, termasuk WHERE tanpa kurung yang menelan pembagian;
• FOR EACH ROW OF hanya untuk ekspresi berisi measure;
• LET/SET/PARAMETER (parameter hanya-baca), fungsi bawaan dan jumlah argumennya, nama fungsi lama seperti AVERAGE;
• keseimbangan blok IF/FOR/WHILE/FUNCTION/MODEL/TEST/TRY dengan END pasangannya;
• USE dan PARAMETER wajib di bagian atas file, dan USE wajib memakai AS;
• koma di dalam WHERE (syarat digabung dengan AND/OR);
• TOP tanpa BY.

Pemasangan dan pemakaian

pip install dalang
dal --version
dal check analisis.dal
dal run analisis.dal
dal run analisis.dal --set tahun=2024

Untuk grafik PNG: pip install "dalang[grafik]". Untuk file Excel: pip install "dalang[excel]". Keduanya: pip install "dalang[semua]".

Contoh dal run (Program 2 di examples/):

610
kota     SUM(sales.nilai)  COUNT(sales)
-------  ----------------  ------------
Bandung               150             3
Jakarta               460             5

Contoh keluaran dal check:

Kesalahan di analisis.dal baris 1:
    PRINT Omzet
    ^^^^^
PRINT tidak ada di Dalang. Gunakan SHOW.

[GAGAL] analisis.dal: 1 kesalahan

Pengembangan

pip install -e ".[dev]"
pytest

Folder examples/ berisi Program Target 1–9 dan kasus error E1–E6 yang menjadi golden test. Program 1–4 diuji oleh tests/test_run.py, Program 5–9 oleh tests/test_model.py, fitur 0.3.0 oleh tests/test_v03.py.

Lisensi

Dalang dirilis di bawah Apache License 2.0.