Editing and versions
All datasets on Redivis are automatically versioned. Any change to a dataset's data in tables or files will require a new version. A version is a locked copy of the data that can't be edited or deleted, supporting future reproducibility and confidence in the persistence of researchers' data workflows.
Changes to documentation and metadata do not create a new version, though different versions do have independent documentation and metadata. For example, if a new version contains a new table, or new data, you will likely want to document this information separately from the previous version. However, if you only want to enrich the existing metadata on the current version, you can do so without creating a new version.
To help researchers better understand if the differences across versions, Redivis uses semantic versioning, of the form
v[major].[minor] The first version of every dataset is v1.0. For subsequent versions, the tag will augment automatically depending on the changes being released. - Major update: Your existing code may not run.
- Triggered when a new version renames, deletes, or retypes variables in the dataset's tables. Also occurs if any tables from the previous version were deleted.
- Minor update: Your existing code will generally run.
- Changes are limited to adding / removing records, recoding variables, adding variables, and adding tables.
On any dataset page, you can view the current version tag next to the dataset title, and click on this tag to switch to view a full version history and switch to a different version of this dataset.
Within a project, you can change the version of a dataset by selecting the dataset node and clicking the Version button at top right. If there is a new version available, the dataset node will be highlighted to indicate that you might want to upgrade.
When it's time to update a dataset's data, you'll want to create a new version. To do this, navigate to the dataset editor and click Create next version.
Before this version is released, it will be tagged as
next. Only dataset editors will be able to see the next version on the dataset page and use it in their projects.A dataset can have up to 1,000 versions. If your use case exceeds this limit, consider creating a new dataset that imports the previous dataset's tables once this limit has been reached.
Create subsequent versions from within the dataset editor
All versions of a dataset contribute to that dataset's total size, which in turn will count towards your usage quotas or organization billing (depending on whether the dataset is owned by you or an organization).
This total size will be displayed in the dataset editor, alongside the size for the current version. For datasets with one version, this total size may be slightly larger than the current version, as Redivis stores certain metadata behind the scenes to support future versioning.
As new versions are created, Redivis will efficiently compute a row-level difference between the versions — only additions and updates to existing data will contribute to the dataset's total storage size, preventing data that is consistent across versions from being double-counted.
Adding or removing columns (or changing column types) won’t affect row uniqueness as we store the stringified representation of each value on our backend. Only the storage size of the new column would be added.
If the most recent version of a dataset has been released in the last 7 days, and there is no Next version already created, you'll have the option to unrelease it.
This will revert the dataset to the exact state it was in before the version was released. If anyone who is not a dataset editor has this version in a project, it will no longer be available to them.
Any version of a dataset can be deleted as long as it is not the most recent released version. Deleting this version will permanently delete all metadata and data associated with it.
This version will no longer be available in any projects, and where it was previously it use it will now be unavailable. In order to continue in the project, it will need to be updated to a different version. If tables do not exist between versions, any transforms referencing a table will be shifted to reference a different one.
Deleting a version is permanent and can't be undone.
If you are deleting versions to reduce storage costs, be aware that Redivis stores data efficiently across versions – the storage used by a particular record will be deleted only if it is unique to the deleted version (or, if deleting a series of versions, if that record doesn't exist in any non-deleted version).
When a dataset is first created it will be marked as unreleased.
As you work on the initial version of the dataset you can see the changes you make to the data in the version history modal. in this unreleased state you can add it to a project and analyze the data it contains. Note that the only people who can see it in the project are dataset editors. If you make changes to the data or delete it, your project will change instantly to reflect those changes.
To add an unreleased or unpublished dataset to a project, click the View dataset tab from the edit interface, and click the Analyze in project button. Since this dataset is not published it will not appear in the Add dataset interface in projects.
Once you are ready to make your data available to non-editors, you will need to publish it. This will simultaneously release your version as well as make your dataset discoverable. As soon as it is published it will be accessible to all who meet its access rules.
If this is an organization dataset, it can be unpublished at any time. This will "unlist" the dataset so that it will not be listed on your organization home page and even users who meet the access requirements will not be able to see it. Anywhere it is used in a project it will instantly be made unavailable.
Unpublishing might be used if you need to temporarily halt usage of the dataset but don't want to disrupt all of the access rules.
By default the only people who can edit a dataset are the owner of the dataset or the administrators of the organization if it is an organization dataset.
If you would like to allow someone else to edit a dataset you can configure this in the access settings on each individual dataset. Editors can only edit the dataset (metadata, data, variable metadata, versions) and can't change the access.
Last modified 2mo ago