Browse Source

docs: translate contextvar warning

Signed-off-by: JP-Ellis <[email protected]>
pull/13453/head
JP-Ellis 4 weeks ago
parent
commit
bcde4ab4a5
No known key found for this signature in database GPG Key ID: F162288C8BA20FCE
  1. 6
      docs/de/docs/tutorial/dependencies/index.md
  2. 6
      docs/es/docs/tutorial/dependencies/index.md
  3. 6
      docs/ja/docs/tutorial/dependencies/index.md
  4. 6
      docs/ko/docs/tutorial/dependencies/index.md
  5. 6
      docs/pt/docs/tutorial/dependencies/index.md
  6. 6
      docs/ru/docs/tutorial/dependencies/index.md
  7. 12
      docs/zh/docs/tutorial/dependencies/index.md

6
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.

6
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.

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

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

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

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

6
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.

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

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

12
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 概图。

Loading…
Cancel
Save