Reloading scripts
Run your load script to export data with the latest data from the data source.
Scripts in the Qlik Cloud Analytics do not run automatically to update their outputs. Reloading the script runs the load script again to load the latest data from the script's data source and then exports it. Script reloads can be manual or scheduled.
For information about which users can reload data, see:
You can check the reload status of a script. This can be Success, Reloading, or Failed.
- In list view of scripts by clicking the value in the Last modified column.
- In Reload history.
Scheduling reloading script data
You can create a schedule for data reloading in your script. The schedule can be based on frequency, date, and time, or when a dataset in the script is refreshed.
Do the following:
-
Click on the script and select Reload schedule.
-
Click Add schedule.
-
Select any of the time options in Reload the script.
Time-based schedules
When you create a time-based schedule, you can choose:
-
The frequency and interval of the reload
-
The timezone and time of day
-
How long the schedule will be in effect
Repeating reloads can be set at the following intervals:
-
Daily: Set the times per day, timezone, and the time of day.
-
Weekly: Set the days of the week, times per day, timezone, and time of day.
-
Monthly: Set the days of the month, times per day, timezone, and time of day.
-
Yearly: Set the months, days of the month, times per day, timezone, and time of day.
By default, schedules will run continuously, with no end date. You can choose to set a start date, an end date, or to only run the schedule between two dates.
Event-based schedules
You can set a schedule to reload the script when a dataset used by the script is refreshed. This option is only available for scripts that contain a dataset that is created and refreshed by Qlik Talend Data Integration. For more information, see Integrating data.
This option is only available if the last reload run on the script was a reload or a preview with Use STORE commands turned on. If the last action was a preview, event-based schedules are not available..
Viewing and managing reload schedules
You can view and edit scheduled reloads for all scripts that you own.
To view or edit a reload schedule, in the Analytics activity center, click on a script, and click Reload schedule.
You can also delete the schedule.
Tenant admins and analytics admins can edit and delete scheduled reload tasks from the Administration activity center. For more information, see Managing scheduled reloads of script data.
Limitations and considerations
-
The reload schedule is disabled if it fails to execute five times in a row. If you own the reload schedule for the script (the reload schedule is assigned to you), you will receive notifications when this happens. Notification settings can be customized for a single script, all scripts in a space, or all scripts in a tenant. For information about the owner of a reload schedule, see Ownership of reload schedules.
-
If you have a high number of queued and executing data reload processes (and additional concurrent CPU and memory intensive processes), you might notice that some reload processes execute, in some cases, noticeably after their scheduled start time.
-
Scheduled reloads are not included for the published copy of a script. Published scripts must have scheduled reloads reconfigured on the scripts in the managed space.
-
If you move a script with a reload schedule between spaces, the reload schedule is deleted. Recreate the schedule in the new space if required.
-
If you add or remove datasets in a script with a When a dataset is refreshed schedule, you must remove the schedule and recreate it.
-
When using Direct Access gateway to access your data source, reload script queries cannot exceed 500,000 characters.
Ownership of reload schedules
A time-based scheduled reload runs on behalf of the user that is assigned to the reload schedule (the reload schedule owner), rather than the script owner. Certain actions will result in changes to who is assigned to the reload schedule. The user assigned to the reload schedule is determined by the following rules:
-
When you create a reload schedule for a script that did not previously have one, you become the owner of that reload schedule. In other words, it is assigned to you.
-
If another user edits or saves an existing reload schedule, ownership is transferred to them. In other words, the reload schedule is now assigned to them.
-
If another user modifies the script's load script by making edits in Editor, ownership is transferred to them in most cases (it will be assigned to them). However, if this user is already the most recent user to edit the load script, the ownership of the schedule will not transfer to them.
For more information about co-developing script data models, see Collaboratively developing data load scripts in shared spaces.
Manually reloading script data
You can reload a script manually.
Do the following:
- Click on the script and select Reload now.
Viewing reload history for a script
Reload history contains the reload history for the selected script. Use it to help troubleshoot scheduled reload issues. You can view the status, start and end times, and duration of past and current reloads. You can also view and download a corresponding log file.
There are two ways to view the reload history for a script.
- In Overview of a script, click Reload history.
- In the list view of scripts in the Analytics activity center, click the date in the Last modified column and select View reload history.
On the Reload history page, click the View button to view the reload summary. Optionally, you can also download a detailed log file. When the limit for the number of logs stored is reached, new logs will replace the oldest logs, on a first in, first out basis.
You might want to cancel a reload of your script if the reload is taking too long or the script has been updated with new data and you want to start a new reload. To cancel a reload, go to Reload history, and click Cancel.
You can see the canceled reload in your Reload history.
Viewing and deleting reload schedules
Tenant admins and analytics admins can view and delete scheduled reload tasks from the Administration activity center. For more information, see Managing scheduled reloads of script data.
Understanding timestamps: Updated, Modified date, and Last reload date
You can view time information in that Updated timestamp that is shown in the script tile. You can also see this information by clicking on a script to open Overview. It is listed in Summary as Modified date. The format of the date may differ; for example, if the script was recently updated, the Updated value on the script tile may appear as follows: Updated 15 minutes ago.
You can view Last reload date by selecting on the script, then selecting Details. This value is only refreshed when the script's data is reloaded. A reload also changes the Updated and Modified date timestamp.
The following table lists the operations that refresh Updated (same as Modified date) and Last reload date timestamps:
Operation | Updated, Modified date | Last reload date |
---|---|---|
Reload | Yes | Yes |
Change name | Yes | No |
Change description | Yes | No |
Publish script | Yes | No |
Change owner | Yes | No |
Change script | Yes | No |