Log changes to the database during upgrades

Sitefinity CMS logs all database schema changes applied during the upgrade phase. For example, adding a new column to an existing table: ALTER TABLE table_name ALTER COLUMN column_name datatype

The Data Definition Language (DDL) statement for each update is recorded in the UpgradeTrace.log. The file is located in the ~\App_Data\Sitefinity\Logs folder of your project.
Together with the DDL migration statements, Sitefinity CMS stores additional information that describes the entire database schema migration process in general:

  • The complexity of the schema migration:
    • Trivial - contains schema artifacts without influencing the existing schema
    • Extending - contains schema artifacts that extend the existing schema
    • Complex - contains schema artifacts with structural changes
  • Types of the schema changes to be applied to the underlying database:
    • Adding new artifacts:
      • Adding columns on an existing tables
      • Adding foreign key constraints to existing tables
      • Adding foreign key constraints to new tables - the create table statement is included as well
      • Adding indices to existing tables
      • Adding indices definition for new tables - the create table statement is included as well
      • Adding new tables
      • Adding structures independent of existing
      • Adding primary key constraints to existing tables
      • Adding primary key constraints to new tables - the create table statement is included as well
    • Modifying existing artifacts:
      • Modifying columns of existing tables
      • Modifying existing structures
    • Removing existing artifacts:
      • Removing columns from existing tables
      • Removing foreign key constraints from existing tables
      • Removing indices from existing tables
      • Removing primary key constraints from existing tables
    • Using temporary tables to migrate data during structural table changes
EXAMPLE: Following is an example of the contents of the UpgradeTrace.log file after a complex schema migration:
EXAMPLE: Following is an example of the contents of the UpgradeTrace.log file after an extending schema migration:

Want to learn more?

Sign up for our free beginner training. Boost your credentials through advanced courses and certification.
Register for Sitefinity training and certification.

Was this article helpful?