diff --git a/docs/release-notes.md b/docs/release-notes.md
index 9096a9f3f..b3912de5e 100644
--- a/docs/release-notes.md
+++ b/docs/release-notes.md
@@ -1,5 +1,9 @@
## Next
+* Update SQL with SQLAlchemy tutorial at https://fastapi.tiangolo.com/tutorial/sql-databases/ using the new official `request.state`.
+
+* Upgrade Starlette to version `0.11.1` and add required compatibility changes. PR #44.
+
## 0.5.1
* Add section about helping and getting help with **FastAPI**.
diff --git a/docs/src/sql_databases/tutorial001.py b/docs/src/sql_databases/tutorial001.py
index 4657b53a3..552e0f5da 100644
--- a/docs/src/sql_databases/tutorial001.py
+++ b/docs/src/sql_databases/tutorial001.py
@@ -55,13 +55,13 @@ app = FastAPI()
@app.get("/users/{user_id}")
def read_user(request: Request, user_id: int):
- user = get_user(request._scope["db"], user_id=user_id)
+ user = get_user(request.state.db, user_id=user_id)
return user
@app.middleware("http")
-async def close_db(request, call_next):
- request._scope["db"] = Session()
+async def close_db(request: Request, call_next):
+ request.state.db = Session()
response = await call_next(request)
- request._scope["db"].close()
+ request.state.db.close()
return response
diff --git a/docs/tutorial/sql-databases.md b/docs/tutorial/sql-databases.md
index 2a7588140..fdeb8752d 100644
--- a/docs/tutorial/sql-databases.md
+++ b/docs/tutorial/sql-databases.md
@@ -102,15 +102,12 @@ The middleware we will create (just a function) will create a new SQLAlchemy `Se
{!./src/sql_databases/tutorial001.py!}
```
-### About `request._scope`
+### About `request.state`
-`request._scope` is a "private property" of each request. We normally shouldn't need to use a "private property" from a Python object.
+`request.state` is a property of each Starlette `Request` object, it is there to store arbitrary objects attached to the request itself, like the database session in this case.
-But we need to attach the session to the request to be able to ensure a single session/database-connection is used through all the request, and then closed afterwards.
+For us in this case, it helps us ensuring a single session/database-connection is used through all the request, and then closed afterwards (in the middleware).
-In the near future, Starlette will have a way to attach custom objects to each request.
-
-When that happens, this tutorial will be updated to use the new official way of doing it.
## Create a `CustomBase` model