> For the complete documentation index, see [llms.txt](https://docs.bdb.ai/self-service-visualization-5/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bdb.ai/self-service-visualization-5/creating-a-new-report/create-new-report/creating-a-new-report-with-an-existing-data-store/creating-and-updating-instance.md).

# Creating and Updating Instance

This section explains steps to create and update instance for a Data Store.

## Creating Instance <a href="#creating-instance" id="creating-instance"></a>

{% hint style="warning" %}
*<mark style="color:orange;">**Prerequisite:**</mark> The **Data Store Settings must** be configured from the **Admin module** to **access the Instance functionality** for the* *Data Store inside a **Report.***
{% endhint %}

<details>

<summary>What is a Personalised Store?</summary>

The Data Store for which the user can set the TIme To Live (TTL) limit using the Story interface is considered a Personlised Data Store or Personalised Store.

</details>

<details>

<summary>What is the limit for TTL? What is the maximum limit for TTL?</summary>

The ***Time to Live (TTL)*** for the data will be of 1-30 days. The maximum limit provided for the ***TTL*** is ***30 days.***

</details>

{% hint style="success" %}
*Check out the walk-through on the instance for an existing datastore under the Personalised category.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FjPT0dGVnmBPN1qr6zsQb%2FCreating%20instance%20for%20a%20personalized%20datastore.mp4?alt=media&token=6e9484bc-6730-4587-ac57-a3f80fdc875c>" %}
***Instance Creation for Personalised Data Stores***
{% endembed %}

The ***Create Instance*** option loads the data for the first time from the datastore into Elastic, MongoDB, and ClickHouse server as the configuration is done in the ***Admin Module*** for the Datastore Settings.&#x20;

* Navigate to the Data Store list inside a ***Create New Report*** dialog box.
* The ***Select Data Store*** page opens listing all the available Data Stores.
* Select the ***Personalized*** Data Store Category.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FlqWlHCQbypFYXVI7N48C%2Fimage.png?alt=media&amp;token=54e1d740-38d8-408f-afeb-406d8f1a9213" alt=""><figcaption></figcaption></figure>

* Search for a Data Store in the given search bar.
* Select a Data Store by using the checkbox.
* Click the Data Store to open the Time To Live (in days) option. Provide the no. of days for the selected Data Store to create a new instance.
* Click the ***Refresh*** option.&#x20;

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FeMef7OlafMnh2x0BfSIQ%2Fimage.png?alt=media&amp;token=588d1349-62f1-401b-a3f9-5123090ffeae" alt=""><figcaption></figcaption></figure>

* A confirmation message appears to update the Data Store details.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FOKH8PSNeGjkQlyDFJ3TO%2Fimage.png?alt=media&amp;token=133ebd83-261e-49e0-b1c2-dad233654dc6" alt=""><figcaption></figcaption></figure>

* The concerned Data Store starts displaying the Days Left option based on the provided no. of days while setting the TTL.
* Select the Data Store by using the check box.
* Click the ***Create Report*** option to proceed with the View creation.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2Fh36gE30pRgeCpLBXVPvf%2Fimage.png?alt=media&amp;token=fe78dd2e-acd5-4bd0-9180-1429233804c3" alt=""><figcaption></figcaption></figure>

## Updating Instance  <a href="#updating-instance" id="updating-instance"></a>

The permitted ***Time to Live*** limit for a Data Store is only 30 days (maximum). If it goes above that, data will not be present in the Report.

Hence, the user can manually update the instance. The ***Days Left*** column will highlight such conditions as flashing ***Expire*** status in the red color. Click the user to get redirected to update the instance for the selected Data Store so the data will be refreshed again in the ***ES*** or ***MongoDB***.

{% hint style="success" %}
*Check out the illustration on updating an instance for an existing datastore.*
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FqWOpOli9V2sO660Nnfe2%2FUpdating%20the%20Instance%20V2.mp4?alt=media&token=7a7bbdec-142f-4b13-8a93-5b76396b940d>" %}
***Updating  the Instance for an existing Datastore***
{% endembed %}

* Navigate to the ***Create New Report*** page.
* Filter the Data Store list with the ***Personalised*** category.
* Select a Data Store from the ***Personalised*** category that has expired.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FoJ4oQYdh2VNPhtFtp8YJ%2Fimage.png?alt=media&amp;token=4d1c8c61-f76c-41a1-9b65-508575f0ba49" alt=""><figcaption></figcaption></figure>

* Select the Data Store by using the checkbox provided next to the Data Store.&#x20;
* Click the Datastore to open the ***Time to Live*** (TTL) option. Mention no. of days (up to 30 days is allowed for TTL).
* Click the ***Refresh*** option.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FpDTDQFtuATS9yg1o2Tpw%2Fimage.png?alt=media&amp;token=07db12c5-69d0-4803-a028-c18e525c0a56" alt=""><figcaption></figcaption></figure>

* A notification message appears to inform about the successful update of the Data Store.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FWCpy8Q3UDzNA8ezHoWi4%2Fimage.png?alt=media&amp;token=0b60de4b-684a-49f4-bb10-99b382b862ce" alt=""><figcaption></figcaption></figure>

* The Data Store gets refreshed, and the inserted no. of days gets reflected under the Days Left column.
* Click the **Create Report** option to start with the View creation part of the Report.

<figure><img src="https://3555642236-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxZF8YGlESz97qqyTOJvz%2Fuploads%2FwiMbjwGykPfzKUnToAlk%2Fimage.png?alt=media&amp;token=427065b1-4158-4ce9-a1ba-95f673470b32" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
*<mark style="color:green;">Please Note:</mark> The user can distinguish between Datastores:*

* *Distinguish between instances and scheduler-based data stores.*
* *Distinguish between the **Active** and **Expired** instances.*
  * *The Expired Data Stores are mentioned with the Expired Status.*
    {% endhint %}