Skip to content

Hello Data

Load data into and retrieve data from the Qlik Associative Engine running in a Docker container.


Clone the Get Started Git repository to your local machine. The Hello tutorials are located here, and all commands should be executed from this Git repository.

You must have Node.js and npm installed on your local machine.


Make sure the Qlik Associative Engine is running. Run docker-compose up -d command in a command shell to start the engine in a Docker container. If you are unfamiliar with starting the Qlik Associative Engine in a Docker container, we recommend that you begin with the Hello Engine tutorial.

Loading and retrieving data

To load and retrieve data, you will run a small Node.js application that loads data into, and then retrieves that data from the Qlik Associative Engine.

The application consists of the hello-engine.js file and the package.json file, which is also shared among the Hello Data and Hello Visualization tutorials.

  1. Install dependencies.


    If you already installed the dependencies in the previous tutorial, go to step 2.

    Run the following command from a command shell:

    npm install

    This command installs all of the dependent packages in the package.json file.

  2. Run the application.

    Run the following command in a command shell:

    npm run hello-data

    This command runs the application, which creates a representation of the data and loads it into Qlik Associative Engine as a part of opening a session.

What is happening

When you start Qlik Associative Engine, the docker-compose.yml file makes the movies.csv file available to Qlik Associative Engine, and the data location is specified in the volumes section.

  - ./data:/data


To learn more about volumes, see Use volumes.

To load the data, the hello-data application uses halyard.js to create a representation of the data and loads it into the Qlik Associative Engine as part of opening a session. Then, it uses enigma.js mixin support to create a session object that holds the first 10 movie titles from the movies.csv dataset. The application then retrieves the movie titles from the dataset, prints the results, and closes the session.

If the application runs successfully, you will see the list of 10 movies from the dataset.

$ npm run hello-data

Creating table data representation.
Creating and opening session using mixin.
Creating session object with movie titles.
Listing the 10 first movies:
Cars 2
Evan Almighty
Green Lantern
Harry Potter and the Half-Blood Prince
Indiana Jones and the Kingdom of the Crystal Skull
Session closed.


Open the hello-data.js file to see how enigma.js and halyard.js are used to load to and retrieve data from the Qlik Associative Engine.


You might see some unfamiliar details of the Qlik Associative Engine in the source code. For example, the properties object that is used to create the session object contains a field called qHyperCubeDef. This relates to the central concept of hypercubes in the Qlik Associative Engine. To learn more about hypercubes, see Hypercubes.

Next steps

Continue with the Hello Visualization tutorial to learn how to display the data that you loaded in this tutorial as a scatter plot.


To learn more about the libraries that are used in this tutorial, we recommend that you take a look at enigma.js and halyard.js to learn about their many features.