Versioning in Yandex DataLens

Dataset versioning means storing the history of dataset configuration changes through versions. A list of versions is available to users with the minimum edit permission for the dataset.

To go to the list of versions, click at the top of the screen and select Change history.

To select a version from the list, click it. The version number will be displayed in the revId parameter in the dataset address string. Click a link with the version number in the revId parameter to open the relevant version of the dataset.

Version typesVersion types

All versions fall into the following types:

1. Current: Most recently saved dataset version. It is displayed for all users that open the dataset for viewing in the workbook or from the navigation panel. A dataset can only have one current version.

2. Draft: Version containing unsaved dataset changes. Common users see none of the changes made to the draft. This allows you to hide dataset edits until you actualize your version. A dataset can only have one draft.
   When you open a draft, you see a panel at the top informing you that it is the draft version of the dataset. There are buttons in the right-hand panel:

   • Make actual: Turns the draft into the current version. The version current at the time will become outdated.
   • Open actual: Opens the current version.
   Draft

   

   To create a draft after you have edited a dataset, click the check mark in the top-right corner and select Save as draft.

3. Outdated: Version that is no longer current.
   When you open an outdated version, a panel appears at the top indicating the version type, creation date and time, and login of the version author. There are buttons in the right-hand panel:

   • Make actual: Turns an outdated version into the current one. The version current at the time will become outdated.
   • Open actual: Opens the current version.
   Outdated version

   

Creating a new versionCreating a new version

A new version is automatically created:

• In the current dataset version edit mode, after you click Save (which creates a new current version) or → Save as draft (which creates a new draft version).
• In draft or outdated dataset version edit mode, after you click Save as draft (which creates a new draft version) or → Save and make actual (which creates a new current version).
• In draft or outdated dataset version view mode, after you click Make actual.

Below are dataset configuration changes that create a new version once they are saved:

• Changes on the Sources tab:

  • Replacing a connection.
  • Adding data to the workspace from source tables or via an SQL query.
  • Configuring links.
  • Changing data table settings. To open the settings window, click → Change settings to the right of the table.

• Adding, editing, deleting fields on the Fields tab.

• Adding, editing, deleting a parameter on the Parameters tab.

• Adding, editing, deleting a filter on the Filtering tab.

Editing versionsEditing versions

You can edit any version of a dataset.

Editing a current versionEditing a current version

If a dataset has a draft, as soon as you open its current version for editing, you will see a message in the top panel informing you that there is a draft in the change history.

Click:

• Open draft: To navigate to the draft.
• Show in history: To display the list of versions.

Editing a draftEditing a draft

To edit a draft, select it in the version list. To save your draft edits, at the top right, click:

• Save as draft: New draft will be created. The current draft will become the outdated version.
• → Save and make actual to create a new current version and make all other versions outdated.

Editing an outdated versionEditing an outdated version

To edit an outdated version, select it from the list of versions. To save edits to an outdated version, at the top right, click:

• Save as draft: Draft will be created from the edited version. If there is a current draft, it will become the outdated version.
• → Save and make actual to create a new current version and make all other versions, including the draft, outdated.

LimitsLimits

• You can only switch to versions created on or after December 1, 2024. Therefore, if your dataset was created before this date, editing it now and saving your changes will permanently delete the previous version.

• Change history is only available for the last three months.

• The change history only contains a list of dataset versions and indicates the version type, save date and time, and user who made the change.

• Dataset versions do not include:

  • Access permission changes (this operation is performed separately from dataset edits).
  • Changes to connection settings made using the interface for editing connection parameters.
  • Changes to the source data (rows added, updated, or deleted in the data source).

• Versions do not display a list of changes. You can only view the saved status of the dataset configuration.