Skip to content

Commit 0f97d86

Browse files
Update migration instructions for BFF V4 upgrade
Added note about breaking changes for database schema.
1 parent 749decd commit 0f97d86

1 file changed

Lines changed: 7 additions & 2 deletions

File tree

src/content/docs/bff/upgrading/bff-v3-to-v4.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -133,7 +133,7 @@ You can configure the location of your `index.html` by specifying:
133133

134134
### Server Side Sessions Database Migrations
135135

136-
When using the server side sessions feature backed by the `Duende.BFF.EntityFramework` package, you will need to script [Entity Framework database migrations](/bff/fundamentals/session/server-side-sessions.mdx#entity-framework-migrations) and apply these changes to your database.
136+
When using the server side sessions feature backed by the `Duende.BFF.EntityFramework` package, you will need to script [Entity Framework database migrations](/bff/fundamentals/session/server-side-sessions.mdx#entity-framework-migrations) and apply these changes to your database.
137137

138138
```shell
139139
dotnet ef migrations add BFFUserSessionsV4 -o Migrations -c SessionDbContext
@@ -155,4 +155,9 @@ CREATE UNIQUE INDEX "IX_UserSessions_PartitionKey_SessionId" ON "UserSessions" (
155155

156156
DROP INDEX "IX_UserSessions_ApplicationName_Key";
157157
CREATE UNIQUE INDEX "IX_UserSessions_PartitionKey_Key" ON "UserSessions" ("PartitionKey", "Key");
158-
```
158+
```
159+
160+
:::note
161+
This is a breaking database schema change. If you have multiple BFF V3 appliations that share the same database table,
162+
then you either need to update all BFF Applications to V4 at the same time or use a new database for the upgraded BFF V4 application.
163+
:::

0 commit comments

Comments
 (0)