Change logging is only available in SQL Source Control version 3.1 and later. |
In the shared database development model, developers work on the same database simultaneously. By default, information about who makes a change to a shared database is read from the default trace and saved in tempdb. However, because tempdb resets when the server is restarted, information about who made a change is permanently lost. When this happens, the Changed by column lists the object as changed by Unknown:
To prevent this, you can create a new database to permanently log information about changes in. This makes sure information isn't lost, and database administrators can set appropriate security restrictions.
Setting up a new database to log changes is only necessary when developers share databases. You might want to consider switching to the dedicated development model. |
Information about who made a change can still be lost for other reasons. For more information, see Object changed by Unknown. |
You can use this SQL script template to create a dedicated change log database named ChangeLog
. You can modify the script as needed.
USE master EXECUTE ('CREATE DATABASE ChangeLog') ALTER DATABASE ChangeLog SET ANSI_NULL_DEFAULT OFF ALTER DATABASE ChangeLog SET ANSI_NULLS OFF ALTER DATABASE ChangeLog SET ANSI_PADDING OFF ALTER DATABASE ChangeLog SET ANSI_WARNINGS OFF ALTER DATABASE ChangeLog SET ARITHABORT OFF ALTER DATABASE ChangeLog SET AUTO_CLOSE OFF ALTER DATABASE ChangeLog SET AUTO_CREATE_STATISTICS ON ALTER DATABASE ChangeLog SET AUTO_SHRINK OFF ALTER DATABASE ChangeLog SET AUTO_UPDATE_STATISTICS ON ALTER DATABASE ChangeLog SET READ_WRITE ALTER DATABASE ChangeLog SET RECOVERY SIMPLE ALTER DATABASE ChangeLog SET MULTI_USER ALTER DATABASE ChangeLog SET PAGE_VERIFY CHECKSUM ALTER DATABASE ChangeLog SET DB_CHAINING ON EXECUTE ('USE ChangeLog IF NOT EXISTS (SELECT * FROM sys.sysusers WHERE name=''guest'') EXECUTE sp_grantdbaccess guest') |
After the change log database is created, you need to edit a local config file so SQL Source Control can access it.
Every member of your team will have to follow these instructions for SQL Source Control to log their changes. |
Go to the SQL Source Control config files folder: %localappdata%\Red Gate\SQL Source Control 3
Open RedGate_SQLSourceControl_Engine_EngineOptions.xml in a text editor.
Below the EngineOptions version
line, add:
<TraceCacheDatabase>ChangeLog</TraceCacheDatabase> |
The file is case sensitive. Don't change the capitalization of the text. |
Ignoring any comments (indicated with <!->
), the final file should look like this::
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <EngineOptions version="3" type="EngineOptions"> <TraceCacheDatabase>ChangeLog</TraceCacheDatabase> </EngineOptions> |
The example above doesn't include any extra lines you may have included for other options. |
SQL Source Control will now use the change log database to log changes made to all linked databases.
|
The change log database will contain details of changes made to all databases linked to SQL Source Control. Users will see the names of modified objects, but not the data itself. If the object names in your database contain sensitive information, consider restricting access instead of using the guest role. |
To check if change logging is set up correctly, interact with a linked database.
Afterwards, in the ChangeLog database, the table RG_AllObjects should appear. You can inspect the table to see changes appearing in it as you make them.
Changes made to the following object types can't be logged:
application roles asymmetric keys certificates constraints DDL triggers DML triggers event notifications | extended properties full text catalogs full text stoplists partition functions partition schemes roles schemas | search property lists symmetric keys table keys user-defined data types user-defined table types user-defined types users |
Changes made to data can't be logged. |