Skip to content

Commit 071dcc3

Browse files
authored
Update in-memory.mdx
1 parent 5aab30b commit 071dcc3

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

docs/source/routing/performance/caching/in-memory.mdx

+5-4
Original file line numberDiff line numberDiff line change
@@ -86,12 +86,13 @@ If the router is using distributed caching for query plans, the warm-up phase wi
8686

8787
</MinVersion>
8888

89-
With router v1.61.0+ and v2.x+, you can pass the `Apollo-Expose-Query-Plan` header to return query plans in the GraphQL response extensions. You must set the header to one of the following values:
89+
With router v1.61.0+ and v2.x+, if you have enabled exposing query plans via `--dev` mode or `plugins.experimental.expose_query_plan: true`, you can pass the `Apollo-Expose-Query-Plan` header to return query plans in the GraphQL response extensions. You must set the header to one of the following values:
9090

91-
- `true`: Returns a human-readable string and JSON blob of the query plan.
92-
- `dry-run`: Generates the query plan without executing the query. After generation, query plans are saved to your configured cache locations, making it useful for pre-warming internal or external caches.
91+
- `true`: Returns a human-readable string and JSON blob of the query plan while still executing the query to fetch data.
92+
- `dry-run`: Generates the query plan and aborts without executing the query.
93+
94+
After using `dry-run`, query plans are saved to your configured cache locations, making it useful for pre-warming internal or external caches. Using real, mirrored, or similar to production operations is a great way to warmup the caches before transitioning traffic to new router instances.
9395

94-
This lets you warm up query plan caches with real, mirrored, or similar to production operations before transitioning traffic to new router instances.
9596
## Caching automatic persisted queries (APQ)
9697

9798
[Automatic Persisted Queries (**APQ**)](/apollo-server/performance/apq/) enable GraphQL clients to send a server the _hash_ of their query string, _instead of_ sending the query string itself. When query strings are very large, this can significantly reduce network usage.

0 commit comments

Comments
 (0)