Creating and Restoring Versions

Anzo provides a versioning feature that enables users to quickly back up and restore versions of the entities that make up a solution. Before making changes to data sources, schemas, mappings, pipelines, or data models, users can take a snapshot of the current version of that artifact. When a backup is created, Anzo automatically creates a version of each entity that is related to that artifact. For example, backing up a version of a pipeline automatically backs up the same version of any related data models, mappings, schemas, and so on. In addition, Anzo backs up the metadata graphs for all of the entities. The metadata graphs store information such as the creator and creation date and the permissions or access control list (ACL) information. Changed artifacts can be reverted at any time to any of the saved versions. If an artifact is restored to a previous version, Anzo automatically saves a version of the current state of the artifact and its related entities and metadata.

This topic provides instructions for backing up and restoring versions of artifacts.

Creating a Backup Version

Follow the instructions below to save a snapshot of a data source, schema, mapping, pipeline, or data model.

  1. In the Anzo console, go to the detail view or overview for the component that you want to back up. For data models, add the model to the working set and then open it in the model editor. For example, the image below opens a pipeline:

  2. Click the Versions tab. Anzo displays the Versions screen. For example:

  3. Click Create Version. Anzo displays the Create New Version screen.

  4. In the Label field, type a name for the backup version. Then type details about the version in the optional Comment field.
  5. Click Save. Anzo takes a snapshot of the component as well as its related entities and adds the version to the list on the left side of the screen. For example:

    Note: Depending on the size and number of related entities, the backup operation can take a few minutes to complete.

  6. Select the new version in the list to view details about the backup. The screen lists details such as the creator and created date and lists each of the related entities that Anzo also backed up. For example:

Users can now make changes to the current version of the backed up components, and the new changes can be reverted to a backup version at any time.

Restoring a Backup Version

Follow the instructions below to restore a component and its related entities to a previous backup version

  1. In the Anzo console, go to the detail view or overview for the component that you want to restore. For data models, add the model to the working set and then open it in the model editor. For example, the image below opens a mapping to be restored:

  2. Click the Versions tab. Anzo displays the Versions screen, which lists the backups that exist for the component. For example:

  3. On the left side of the screen, select the version that you want to restore the component to. For example:

  4. Click the Restore button to restore the component to the version that you selected. Since Anzo automatically creates a snapshot of the current version before you restore a component, Anzodisplays the Revert to Version dialog box so that you can specify a label for the new version.

  5. In the Restore to Version dialog box, type a name for the new version in the Label field.
  6. Specify whether you want to revert to this version's metadata graphs for this component and its related entities:
    • If you want the restored version to use the metadata, such as access control list information and last created date, that was saved at the time of the backup, select the Revert metadata graphs checkbox. Anzo will revert the metadata to the saved version.
    • If changes were made to the metadata for the current version of the component and you want to preserve those changes, such as if the permissions were modified to further restrict or allow access, leave the Revert metadata graphs checkbox blank. Anzo will preserve the current metadata graphs instead of reverting the metadata to the saved version.
  7. Click Save. Anzo saves the current version and restores the current files to the backup version. The new version is added to the list of available backups.