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
file, which is also shared among the Hello Data and
Hello Visualization tutorials.
If you already installed the dependencies in the previous tutorial, go to step 2.
Run the following command from a command shell:
This command installs all of the dependent packages in the
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.
volumes: - ./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
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: 2012 Armageddon Avatar Battleship Cars 2 Cleopatra Evan Almighty Green Lantern Harry Potter and the Half-Blood Prince Indiana Jones and the Kingdom of the Crystal Skull Session closed.
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
Continue with the Hello Visualization tutorial to learn how to display the data that you loaded in this tutorial as a scatter plot.