Document Migration Bundles #3527
Conversation
| @@ -348,3 +363,4 @@ dotnet ef migrations script 20180904195021_InitialCreate | |||
|
|
|||
| * [Migrations](xref:core/managing-schemas/migrations/index) | |||
| * [Reverse Engineering](xref:core/managing-schemas/scaffolding) | |||
| * [Compiled models](../performance/advanced-performance-topics.md#compiled-models) | |||
There was a problem hiding this comment.
I know this is just a reference, but should we link to the appropriate doc page for each (relevant) option? That seems more helpful than some generic "additional resources" links
There was a problem hiding this comment.
Please use xref to page uid instead of referencing md file.
There was a problem hiding this comment.
We also do that.
The see also section is to help guide users who still have questions about a related topic after reaching the end of an article.
There was a problem hiding this comment.
Please use xref to page uid instead of referencing md file.
|
|
||
| * Executing SQL scripts requires additional tools. | ||
| * The transaction handling and continue-on-error behavior of these tools are inconsistent and sometimes unexpected. | ||
| * Bundles can be generated as part of your CI process and executed later as part of your deployment process. |
There was a problem hiding this comment.
This is true of SQL scripts though too, right? Not that we shouldn't mention it, but it doesn't seem like a reason to prefer bundles over SQL scripts per se...
| @@ -156,6 +159,76 @@ Note that this can be used to roll back to an earlier migration as well. | |||
|
|
|||
| For more information on applying migrations via the command-line tools, see the [EF Core tools reference](xref:core/cli/index). | |||
|
|
|||
| ## Bundles | |||
There was a problem hiding this comment.
So at least thinking like a clueless newcomer, this kinda begs the question of why we SQL scripts are still "the recommended way" to apply migrations (above). It may be good to add a point or two about where SQL scripts are still better (e.g. allow inspection of the SQL before application, etc.).
There was a problem hiding this comment.
That's why I left SQL scripts first in the document. Those points are made there and are still just as valid after the introduction of bundles.
Resolves dotnet#3437
| @@ -310,3 +326,4 @@ Update-Database 20180904195021_InitialCreate -Connection your_connection_string | |||
|
|
|||
| * [Migrations](xref:core/managing-schemas/migrations/index) | |||
| * [Reverse Engineering](xref:core/managing-schemas/scaffolding) | |||
| * [Compiled models](../performance/advanced-performance-topics.md#compiled-models) | |||
There was a problem hiding this comment.
Please use xref to page uid instead of referencing md file.
Resolves #3437