# Swapping datasources

During data platform migrations or upgrades, being able to swap datasources can significantly reduce downtime and the complexity of transitioning between old and new systems. Users can continue using existing reports and dashboards by simply pointing them to the new data source. The following are some common use cases:

**1. Partial dataset migration**

Migrating datasets to new sources can be a daunting task, especially when dealing with large volumes of data or the need to keep the system operational during the transition. Swapping datasources facilitates partial migrations by allowing specific datasets to be moved and integrated into new environments gradually, reducing downtime and ensuring continuity of operations.

**2. Changing vendors**

Switching data storage or processing vendors is another scenario where datasource swapping proves invaluable. Organizations may decide to change vendors for various reasons, including cost reduction, improved performance, or enhanced features. The capability to swap datasources allows for seamless transition, vendor comparison and testing.

**3. Shifting to different instances**

The development-to-production lifecycle is a critical process in software and systems development, involving different data environments. The ability to swap datasources eases this transition by ensuring data integrity.

### **How to swap a data source?**

1. To swap any dataset loaded in Tellius, go to **Data** → **Dataset**.
2. Click on the three-dot kebab menu and choose **Swap Datasource**.

<figure><img src="https://files.helpdocs.io/6dnnwn52e3/articles/u0he3oxuzd/1710499737381/image.png" alt="" width="563"><figcaption><p>Data → Dataset → Swap Datasource</p></figcaption></figure>

3. The following window will be displayed. The applicable data sources will be listed under **New Datasource** dropdown. Select or search for the required datasource.

<figure><img src="https://files.helpdocs.io/6dnnwn52e3/articles/u0he3oxuzd/1710499820380/image.png" alt="" width="563"><figcaption><p>Swapping a datasource</p></figcaption></figure>

4. Tellius validates the new datasource selected and verifies if they are compatible with each other. If the two datasources are synchronized and ready to be swapped, the following message will be displayed.

<figure><img src="https://files.helpdocs.io/6dnnwn52e3/articles/u0he3oxuzd/1710500004489/image.png" alt="" width="563"><figcaption><p>Validating the selected datasources</p></figcaption></figure>

5. If the select datasource is not compatible with the original datasource, then the following message will be displayed.

<figure><img src="https://files.helpdocs.io/6dnnwn52e3/articles/u0he3oxuzd/1710503958392/image.png" alt="" width="563"><figcaption><p>When selected datasources are not in sync</p></figcaption></figure>

6. Click on **"Apply"** to swap the datasource or click on **"Cancel"** to discard the process.
7. The following message will be displayed at the top.

<figure><img src="https://files.helpdocs.io/6dnnwn52e3/articles/u0he3oxuzd/1710504079041/image.png" alt=""><figcaption><p>Notifying about the swap</p></figcaption></figure>

8. The swapping of datasources is an asynchronous operation, that takes place in the background immediately upon user confirmation. The same can be tracked under **Notifications** tab.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.tellius.com/tellius-6.3/data/managing-your-datasets/swapping-datasources.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.