Merge bcde4ab4a5 into 8032e21418

docs/de/docs/tutorial/dependencies/index.md

@@ -155,6 +155,12 @@ Wenn Ihnen das nichts sagt, lesen Sie den [Async: *„In Eile?“*](../../async.
 
 ///
 
+/// warning | Warnung
+
+Wenn du dich über mehrere Schritte in einer Anfrage hinweg auf `ContextVar`-Werte verlassen musst, **verwende eine async-Abhängigkeit** oder einen anderen Ansatz. Dies liegt daran, dass synchrone Abhängigkeiten im Hauptthread ausgeführt werden, während `async`-Abhängigkeiten im selben Thread-Pool wie derjenige, der die Anfrage bearbeitet, ausgeführt werden. Da `ContextVar` thread-lokalen Speicher bereitstellt, sind alle Werte, die innerhalb einer synchronen Abhängigkeit gesetzt werden, im restlichen Anfrageverlauf nicht verfügbar.
+
+///
+
 ## Integriert in OpenAPI
 
 Alle Requestdeklarationen, -validierungen und -anforderungen Ihrer Abhängigkeiten (und Unterabhängigkeiten) werden in dasselbe OpenAPI-Schema integriert.

docs/en/docs/tutorial/dependencies/index.md

@@ -156,6 +156,12 @@ If you don't know, check the [Async: *"In a hurry?"*](../../async.md#in-a-hurry)
 
 ///
 
+/// warning
+
+If you need to rely on `ContextVar` values across multiple steps in a request, **use an async dependency** or another approach. This is because sync dependencies are executed in the mainthread*, while `async` dependencies run in the same thread pool as the one handling the request. As `ContextVar` provides thread-local storage, any value set inside a sync dependency will not be available in the rest of the request handling.
+
+///
+
 ## Integrated with OpenAPI
 
 All the request declarations, validations and requirements of your dependencies (and sub-dependencies) will be integrated in the same OpenAPI schema.

docs/es/docs/tutorial/dependencies/index.md

@@ -156,6 +156,12 @@ Si no lo sabes, revisa la sección [Async: *"¿Con prisa?"*](../../async.md#in-a
 
 ///
 
+/// warning | Advertencia
+
+Si necesitas depender de valores de `ContextVar` a lo largo de múltiples pasos en una solicitud, **usa una dependencia async** u otro enfoque. Esto se debe a que las dependencias sync se ejecutan en el hilo principal, mientras que las dependencias `async` se ejecutan en el mismo grupo de hilos que maneja la solicitud. Como `ContextVar` proporciona almacenamiento local de hilos, cualquier valor establecido dentro de una dependencia sync no estará disponible en el resto del manejo de la solicitud.
+
+///
+
 ## Integración con OpenAPI
 
 Todas las declaraciones de request, validaciones y requisitos de tus dependencias (y sub-dependencias) se integrarán en el mismo esquema de OpenAPI.

docs/ja/docs/tutorial/dependencies/index.md

@@ -118,6 +118,12 @@ common_parameters --> read_users
 
 ///
 
+/// warning | 警告
+
+リクエストの複数のステップにわたって `ContextVar` 値に依存する必要がある場合は、**async 依存関係**または他のアプローチを使用してください。これは、同期依存関係がメインスレッドで実行されるのに対し、`async` 依存関係はリクエストを処理するのと同じスレッドプールで実行されるためです。`ContextVar` はスレッドローカルストレージを提供するため、同期依存関係内で設定された値はリクエスト処理の残りの部分では利用できません。
+
+///
+
 ## OpenAPIとの統合
 
 依存関係（およびサブ依存関係）のすべてのリクエスト宣言、検証、および要件は、同じOpenAPIスキーマに統合されます。

docs/ko/docs/tutorial/dependencies/index.md

@@ -156,6 +156,12 @@ commons: Annotated[dict, Depends(common_parameters)]
 
 ///
 
+/// warning | 경고
+
+요청의 여러 단계에 걸쳐 `ContextVar` 값을 사용해야 하는 경우, **async 종속성** 또는 다른 접근 방식을 사용하세요. 이는 동기 종속성이 메인 스레드에서 실행되는 반면, `async` 종속성은 요청을 처리하는 동일한 스레드 풀에서 실행되기 때문입니다. `ContextVar`는 스레드 로컬 저장소를 제공하므로, 동기 종속성 내에서 설정된 값은 요청 처리의 나머지 부분에서 사용할 수 없습니다.
+
+///
+
 ## OpenAPI와 통합
 
 모든 요청 선언, 검증과 의존성(및 하위 의존성)에 대한 요구 사항은 동일한 OpenAPI 스키마에 통합됩니다.

docs/pt/docs/tutorial/dependencies/index.md

@@ -156,6 +156,12 @@ Caso você não conheça, veja em [Async: *"Com Pressa?"*](../../async.md#com-pr
 
 ///
 
+/// warning | Aviso
+
+Se você precisar depender de valores de `ContextVar` em várias etapas de uma solicitação, **use uma dependência async** ou outra abordagem. Isso ocorre porque as dependências síncronas são executadas no thread principal, enquanto as dependências `async` são executadas no mesmo pool de threads que está lidando com a solicitação. Como `ContextVar` fornece armazenamento local de threads, qualquer valor definido dentro de uma dependência síncrona não estará disponível no restante do manuseio da solicitação.
+
+///
+
 ## Integrando com OpenAPI
 
 Todas as declarações de requisições, validações e requisitos para suas dependências (e sub-dependências) serão integradas em um mesmo esquema OpenAPI.

docs/ru/docs/tutorial/dependencies/index.md

@@ -150,6 +150,12 @@ commons: Annotated[dict, Depends(common_parameters)]
 
 ///
 
+/// warning | Предупреждение
+
+Если вам нужно полагаться на значения `ContextVar` на нескольких этапах запроса, **используйте async зависимость** или другой подход. Это связано с тем, что синхронные зависимости выполняются в основном потоке, в то время как `async` зависимости выполняются в том же пуле потоков, что и обработка запроса. Поскольку `ContextVar` предоставляет локальное хранилище для потоков, любые значения, установленные внутри синхронной зависимости, не будут доступны в остальной части обработки запроса.
+
+///
+
 ## Интеграция с OpenAPI
 
 Все заявления о запросах, валидаторы, требования ваших зависимостей (и подзависимостей) будут интегрированы в соответствующую OpenAPI-схему.

docs/zh/docs/tutorial/dependencies/index.md

@@ -118,6 +118,18 @@ common_parameters --> read_users
 
 ///
 
+/// note | 笔记
+
+如果你不知道，请查看文档中关于 `async` 和 `await` 的 [Async: *"赶时间？"*](../../async.md#in-a-hurry){.internal-link target=_blank} 部分。
+
+///
+
+/// warning | 警告
+
+如果你需要在请求的多个步骤中依赖 `ContextVar` 值，**使用 async 依赖**或其他方法。这是因为同步依赖在主线程中执行，而 `async` 依赖在处理请求的同一线程池中运行。由于 `ContextVar` 提供线程本地存储，在同步依赖中设置的任何值在请求处理的其余部分中将不可用。
+
+///
+
 ## 与 OpenAPI 集成
 
 依赖项及子依赖项的所有请求声明、验证和需求都可以集成至同一个 OpenAPI 概图。