Getting Started With DAZL

general

slug: tutorial-getting-started-with-dazl

Welcome

DAZL is a pipeline-based analytics language that turns raw data into insight. Using easy syntax, you define steps that extract, transform, analyze, and visualize your data — all in one workflow.

This guide walks you through your first DAZL script using sample data, so you can see how DAZL works together with nollejBase to store insights and results.

---

Core Concepts

Before diving into code, here are the key ideas:

• Pipeline-Based: DAZL executes steps sequentially; each step transforms your data or produces results.
• Steps: Over 30 specialized steps exist (load, loadInline, freq, calculate, cube, chart, dashboard, etc.).
• Virtual Warehouse: nollejBase stores summaries and analytical results, keeping raw data in place.
• Readable code: Scripts are declarative, easy to read, and maintain.

---

Your First Script

Here’s a minimal DAZL workflow using inline sample data:

steps:
  - loadInline:
      data:
        - {region: "North", product: "Widget", price: 10, quantity: 5}
        - {region: "North", product: "Gadget", price: 15, quantity: 2}
        - {region: "South", product: "Widget", price: 10, quantity: 3}
        - {region: "East",  product: "Widget", price: 10, quantity: 7}

  - calculate:
      assign:
        total: "$price * $quantity"

  - freq:
      columns: [region]

  - chart:
      type: bar
      x_axis: region
      y_axis: total

Step-by-Step Explanation

1. loadInline – Loads the dataset defined directly in the script using compact inline objects.
2. calculate – Creates a new column total by multiplying price and quantity.
3. freq – Counts the number of rows per region.
4. chart – Generates a bar chart showing the frequency of each region.

---

Running Your Script

You can run this script:

• Via nollejBase /dazlStudio IDE: Paste it into the DAZL editor and execute.
• nollejCraft shortecodes: Use DAZL in your nollejCraft web page by embedding calls with the [ dazl ] shortcode.
• Automated pipelines: Schedule or trigger scripts to process data on demand.

---

Viewing Results in dazlStudio

Once the script runs, you are sent to the 'results' module. This screen is organized within a few tabs (reports, datasets, runlog)

Each tab contains an accordion for all the assets produced, and you're automatically open in the first report

These report results can be tables, charts, dashboards, reports. Any $html output produced by steps are here.

The datasets tab contains all the data loaded from external sources, and datasets created throughout the script execution.

The runlog tab contaims an accordion panel for each step, including run time stats and memory usage.

---

Next Steps

• DAZL Language Reference Guide reference
• Understanding nollejBase tutorial
• Recipes Table Of Contents reference

---

Tips for Beginners

• Keep steps simple and sequential — easier to debug.
• Start with small datasets (loadInline) before connecting to live data.
• Use descriptive column names for clarity in scripts and dashboards.

---