Skip to main content
Version: 0.22.2

Create and Use Snapshots

A snapshot saves a session's datasets in a DataChat object. Snapshots can be used, for example: to capture a time slice of a live-updating data stream, to re-use a dataset in a different session, to share the datasets from a session with another user, to update large datasets at convenient times from a database, and more.

You can create a snapshot from within a session and open it from the homepage.

Save a Snapshot

You can either save all datasets in the current session as a snapshot, or compose a DataChat sentence to select specific datasets.

note

You can save one snapshot in each session. If you already created a snapshot in the session and save the current snapshot with a new name, the current snapshot is saved with the new name and replaces the former snapshot. If you save with the same name, you are prompted to either overwrite with the same nameupdating the former snapshot with the current oneor cancel and save with a different name.

Snapshot Form

From within your current session, select Save in the sidebar. The Save form opens.

Save a snapshot form

  1. Select Snapshot.
  2. Enter a name for your new snapshot.
  3. Click Submit.

DataChat Sentence

To build a DataChat sentence, enter in the chat box:

Save the current session as a snapshot <name>

Specific Datasets

To save specific datasets from your session, enter in the chat box:

Save the current session as a snapshot <name> adding the datasets <datasets>

Rename a Snapshot

To rename a snapshot, select Snapshots in the sidebar of the homepage.

Homepage Snapshot rename

  1. Select the snapshot to rename.
  2. Right-click on the highlighted snapshot and click Rename Snapshot. Or, click More options > Rename Snapshot. The Rename Snapshot form appears.
  3. Enter a new name and click Submit.

Open a Snapshot

You can open a new session with the datasets contained in a snapshot in several ways:

The first session is named <SnapshotName>. The next session is named <SnapshotName_1>, and subsequent sessions are appended with increasing numbers.

Homepage

To use an existing snapshot in a new session from the homepage, select Snapshots in the sidebar.

Homepage Snapshots

  1. Double-click the snapshot you'd like to open.
  2. A new session opens and loads the datasets contained in the snapshot.

Within a Session with a Form

To use an existing snapshot from within a session, click Load from the sidebar. The Load Data form opens.

Load Data Snapshots

  1. Click on the snapshot from the Snapshots section. Or, click "load data from my snapshots" to look for an existing snapshot.
  2. The datasets contained in the snapshot load within the session.

Within a Session in the Chat Box

To use an existing snapshot from within a session by building a DataChat sentence:

  1. Enter in the chat box: Load data from the snapshot <snapshot name>.
  2. The datasets contained in the snapshot load within the session.

Delete a Snapshot

To delete a snapshot from the homepage:

  1. Select Snapshots in the sidebar of the homepage.

  2. Select the snapshot to delete.

  3. Right-click on the highlighted snapshot and click Delete Snapshot. Or, click More options > Delete Snapshot.

    Homepage Snapshots delete

To delete a snapshot from within an existing session, enter in the chatbox: Forget the snapshot <snapshot name>.

note

Any charts created from the snapshot are also deleted.

Refresh a Snapshot

To refresh a snapshot by running the workflow associated with the snapshot, select Snapshots in the sidebar of the homepage.

Homepage Snapshots refresh

  1. Select the snapshot to refresh.
  2. Right-click on the highlighted snapshot and click Refresh Snapshot. Or, click the Refresh Snapshot button. A new session opens and replays the workflow associated with the snapshot.

To refresh a snapshot from within an existing session, enter in the chat box: Refresh the snapshot <snapshot name>.