Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Creating a new version adds a number to the parent synID (e.g. syn12345678.2), which can be used to reference or query that version within Synapse. Navigating to the parent synID (syn12345678) will always display the most recent changes to the view, regardless of whether you have included them in a version.

Creating a Version

Versioning Tables and Views

From a table , or view , or dataset, navigate to theTable Tools or Entity View Tools menu, then respectively. Then select Create a New VersionSnapshot from the dropdown menu. Add a label and a comment about this version. Any text entered in the label field is appended with the word “Version” in the version history. For example, entering “Final” as a label appears as “Version Final” in your version history.

Versioning datasets

The process of versioning a dataset differs from that of Tables or Views. To the left of the Dataset Tools menu are four icons, click on the Create Stable Version icon. Add a label and a comment about this version.

Selecting and Sharing Versions

...

To share a version, copy the URL at the top of the page to share it with other Synapse users, or you can mint a Digital Object Identifier (DOI)/wiki/spaces/DOCS/pages/1972405096 for the selected version. Minting a DOI for a specific version can be useful if you want to publish a snapshot of your data at a specific point in time.

...

(plus) For more information and further instructions, see Querying Tables, Views, and Datasets /wiki/spaces/DOCS/pages/2667642897.

Deleting a Version

To remove a version, navigate to the Tools menu and select Version History. Click on the “x” on the right hand side of the table to delete a specific version. Deleting the most recent version only deletes the record of the version; it does not delete the most recent changes to your table content. Navigating to the parent ID (syn12345678) will always display the most recent updates to a table, view, or dataset, regardless of whether they are included in a version.

...