CDS Dataset
A Cache Dataset (CDS) stores pre-executed dataset results for faster dashboard performance. When you run a dataset and save the output, AIV creates a CDS file. Dashboards then read from this cache instead of querying the source each time, reducing load and improving response times.
Overview
A CDS file is generated by executing a dataset and saving the result. Once created, the system retrieves data from the cache rather than the original data source. This approach optimizes performance and keeps dashboards responsive, even with large datasets or complex queries.
Benefits
| Benefit | Description |
|---|---|
| Easy Data Sharing | Share the CDS with others without requiring access to the original data source or shared resources. |
| Better Performance | CDS files serve data faster because they bypass the original data source. |
| Cross-Platform Compatibility | Data in a CDS file can be downloaded and used across different platforms. |
| Flexible Creation | Create a CDS from any dataset for flexible data management. |
Steps to Create a CDS Dataset
Step 1: Select a Dataset
- In the DATASETS section, select the dataset you want to convert to CDS.
- Click the Schedule icon in the Options column for that dataset.

Step 2: Configure the Schedule Dialog
The Schedule dialog provides four tabs:
| Tab | Purpose |
|---|---|
| Parameter | Enter parameters for the dataset (if applicable). |
| Schedule | Set the schedule frequency and type. |
| Output | Specify the output name, format, suffix, path, and event options. |
| Map emails to share the dataset with specific users. |

Step 3: Configure Output and Run
- Open the Output tab.
- Enter the required Name for the CDS.
- Optionally configure Format (e.g., CDS), Suffix, and Path.
- Select Replace Default if you want to override default output settings.
- Click Run to execute.

:::tip Multiple Parameters
To pass multiple parameters, use a query like WHERE IN ({{country_para}}). For a single parameter, use the Parameter tab as shown above.
:::
Step 4: Monitor the Schedule
- Go to Requests > Requests.
- Click the Completed tab to view the status of the CDS execution.

Step 5: Verify the CDS Dataset
- Return to the DATASETS section.
- Locate the new CDS file (Type: cds) in the list.
- Double-click the CDS to open it and view the cached data in the Edit Dataset dialog.

Related Guides
Explore other ways to create and manage datasets in AIV:
| Data Source | Guide |
|---|---|
| Drag & drop | Create Dataset |
| Excel | Dataset using Excel |
| CSV | Dataset using CSV |
| JSON | Dataset using JSON |
| Parquet | Dataset using Parquet |
| NoSQL | Dataset using NoSQL |
| Flat files | Dataset using Flat files |
| Google BigQuery | Dataset using Google BigQuery |
| Google Sheet | Dataset using Google Sheet |
| External sources | Dataset using External sources |
| Stored Procedure | Dataset using Stored Procedure |
| View | Dataset using View |