Open topic with navigation

Learn more about Toad for SQL Server at Dell Software Find solutions and downloads at the Toad for SQL Server Support Portal

Manage Objects under Version Control

Note: Version Control should be configured in Toad before you start managing objects. See Configure Version Control for more information.

To add objects and scripts under version control

Tips: 

• The objects under version control are marked with sign at the top right corner of the object's icon.
• If you rename a version controlled object, Toad drops the original object and its history from version control and prompts you to add the renamed object to version control This newly renamed object does not have any history associated with it.

• You can create and version control SQL scripts for current database using the Scripts node in the Object Explorer. Click to create the new script.

  

To manage objects and scripts under version control

1. Determine object's version control status. Hover a mouse over the object in the Object Explorer to see its status. Review the following for additional information:

   Version Control status	Description
   Uninitialized	The object status is undetermined yet. This is a temporary status that is issued for all objects during version control status processing.
   Untracked	The object is not added to version control.
   Ignored	The object is added to ignore list and excluded from version control.
   UpToDate	The object is under version control and is synchronized with version control repository. No changes are detected.
   Modified	The object is under version control and has been modified by user. The changes are stored in local database only and need to be synchronized with version control repository.
   Merge	The object is under version control and has been modified in both local database and version control repository. Note:: Toad's Version Control feature does not allow to merge object scripts.
   OutOfDate	The object is under version control and has been modified in version control repository.
   Unknown	The object is under version control but for some reason its status cannot be determined (for example, you created a script in your local database while the script with the same name already exists in version control repository, or you upgraded to a higher version of Toad and configured version control for the same repository while you have some uncommitted changes in the database). Tip: If you are sure that the object is up to date but is listed as unknown, commit the object in version control system to resolve unknown status.
   Deleted	The object was under version control, but it was dropped or renamed in local database and exists only in version control repository. Tip: You can see deleted objects in the Controlled objects pane only. To access it right-click any object and select Show perspective. Once you commit changes in Controlled objects pane, the object with all history will be deleted from version control repository.
   NotInView	The object is under version control and exists in version control repository only.

2. Right-click an object or script and select one of the following actions:

   Use	To...
   Show perspective	Select to review all controlled objects for current configuration. See Review Controlled Objects for more information.
   Diff	Select to review differences between the object script in your local database and the object's revision that was applied to it. Note: Diff is unavailable for File System Based configuration.
   Diff with latest revision	Select to review differences between the object script in your local database and the latest revision in the version control repository.
   Example: You got the latest object revision from the repository 2 days ago. By the time you did it, the latest revision was 5. Yesterday your colleague worked with the same object and committed changes in the repository, which are now marked as revision 6. Today you altered the object's script and want to see the differences. You can select one of the following: Diff—To compare the object in your local database with revision 5. Diff with latest revision—To compare the object in your local database with revision 6.
   Show history	Select to review all commits for selected object. See View History and Compare Revisions for more information. Tip: Select Show history on database to review all commits. Note: Show History is unavailable for File System Based configuration.
   Get latest revision	Select to apply object's changes from the version control repository to your local database. The synchronization script is generated to update selected object to the latest revision.
   Commit	Select to apply object's changes from your local database to the version control repository. Note: You should write a comment when committing changes.
   Undo changes	Select to rollback changes in your local database. The synchronization script is generated to revert object to the revision which was a applied last time.
   Update status	Select to compare a script in your local database with the script in the repository. New status will be issued according to the comparison results.
   Add to ignore list	Select to exclude object from the version control. Ignored objects are not listed in Controlled Objects pane, Commit and Get latest revision are disabled.
   Remove from ignore list	Select to set object status as Untracked and add it to version control.
   Open in Windows Explorer	Select to navigate to the file in the Windows Explorer.

Tip: You can enable, disable, or delete a version control configuration under Tools | Options | Version Control | Configurations.

Related Topics

About Version Control

Configure Version Control

Review Controlled Objects

of