Skip to content

Commit

Permalink
Fixed grammar and phraseololgy.
Browse files Browse the repository at this point in the history
  • Loading branch information
Patrick-Pimentel-Bitwarden committed Jan 9, 2025
1 parent 060499b commit 2769117
Showing 1 changed file with 11 additions and 10 deletions.
21 changes: 11 additions & 10 deletions docs/contributing/database-migrations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,17 +30,18 @@ Style][code-style-sql] first, since they have a major impact in how we write mig
:::info

The separate database definitions in `src/Sql/.../dbo` serve as a "master" reference for the
intended and final state of the database at that time. This is crucial because this state of files
at the current moment may differ from when a migration was added in the past. These definitions act
as a lint and validation step to ensure that migrations work as expected, and the separation helps
maintain clarity and accuracy in the database schema management and synchronization processes.

Additionally, `src/Server` is a regular `sqlproj` as described in the
[SQL Database Project Extension SDK Style Projects](https://learn.microsoft.com/en-us/azure-data-studio/extensions/sql-database-project-extension-sdk-style-projects).
However, instead of using the auto-generated migrations from DAC, as detailed in
[Data-tier Applications](https://learn.microsoft.com/en-us/sql/relational-databases/data-tier-applications/data-tier-applications?view=sql-server-ver16),
intended and final state of the database at that time. This is crucial because the state of database
definitions at the current moment may differ from when a migration was added in the past. These
definitions act as a lint and validation step to ensure that migrations work as expected, and the
separation helps maintain clarity and accuracy in database schema management and synchronization
processes.

Additionally, an
[SQL database project](https://learn.microsoft.com/en-us/azure-data-studio/extensions/sql-database-project-extension-sdk-style-projects)
is in place; however, instead of using the auto-generated migrations from
[DAC](https://learn.microsoft.com/en-us/sql/relational-databases/data-tier-applications/data-tier-applications?view=sql-server-ver16),
we manually write migrations. This approach is chosen to enhance performance and prevent accidental
data loss. This is why there are both a `sqlproj` and standalone migrations.
data loss, which is why we have both an `sqlproj` and standalone migrations.

:::

Expand Down

0 comments on commit 2769117

Please sign in to comment.