graphql-engine/docs/graphql/core/guides
Auke Booij 7bead93827 server: remove remnants of query plan caching (fix #1795)
Query plan caching was introduced by - I believe - hasura/graphql-engine#1934 in order to reduce the query response latency. During the development of PDV in hasura/graphql-engine#4111, it was found out that the new architecture (for which query plan caching wasn't implemented) performed comparably to the pre-PDV architecture with caching. Hence, it was decided to leave query plan caching until some day in the future when it was deemed necessary.

Well, we're in the future now, and there still isn't a convincing argument for query plan caching. So the time has come to remove some references to query plan caching from the codebase. For the most part, any code being removed would probably not be very well suited to the post-PDV architecture of query execution, so arguably not much is lost.

Apart from simplifying the code, this PR will contribute towards making the GraphQL schema generation more modular, testable, and easier to profile. I'd like to eventually work towards a situation in which it's easy to generate a GraphQL schema parser *in isolation*, without being connected to a database, and then parse a GraphQL query *in isolation*, without even listening any HTTP port. It is important that both of these operations can be examined in detail, and in isolation, since they are two major performance bottlenecks, as well as phases where many important upcoming features hook into.

Implementation

The following have been removed:
- The entirety of `server/src-lib/Hasura/GraphQL/Execute/Plan.hs`
- The core phases of query parsing and execution no longer have any references to query plan caching. Note that this is not to be confused with query *response* caching, which is not affected by this PR. This includes removal of the types:
- - `Opaque`, which is replaced by a tuple. Note that the old implementation was broken and did not adequately hide the constructors.
- - `QueryReusability` (and the `markNotReusable` method). Notably, the implementation of the `ParseT` monad now consists of two, rather than three, monad transformers.
- Cache-related tests (in `server/src-test/Hasura/CacheBoundedSpec.hs`) have been removed .
- References to query plan caching in the documentation.
- The `planCacheOptions` in the `TenantConfig` type class was removed. However, during parsing, unrecognized fields in the YAML config get ignored, so this does not cause a breaking change. (Confirmed manually, as well as in consultation with @sordina.)
- The metrics no longer send cache hit/miss messages.

There are a few places in which one can still find references to query plan caching:

- We still accept the `--query-plan-cache-size` command-line option for backwards compatibility. The `HASURA_QUERY_PLAN_CACHE_SIZE` environment variable is not read.

https://github.com/hasura/graphql-engine-mono/pull/1815

GitOrigin-RevId: 17d92b254ec093c62a7dfeec478658ede0813eb7
2021-07-27 11:52:43 +00:00
..
code-editor-integrations docs: update paths for core and cloud (#5665) 2020-08-25 21:51:21 +05:30
data-modelling docs: pluralise query names, schema / table names 2021-02-17 11:13:54 +00:00
faq server: remove remnants of query plan caching (fix #1795) 2021-07-27 11:52:43 +00:00
integrations docs: add trailing slash to blog links, update header link 2021-03-02 09:27:14 +00:00
monitoring docs: add cloud references 2021-07-22 13:24:31 +00:00
postgres docs: add a guide on importing data from a CSV file into PG (close #494) 2021-02-02 10:44:36 +00:00
sample-apps Fix case of GitHub 2020-11-17 19:29:41 +05:30
auditing-tables.rst docs: update paths for core and cloud (#5665) 2020-08-25 21:51:21 +05:30
docker-networking.rst docs: update docker windows hostname 2021-05-07 13:02:40 +00:00
export-graphql-schema.rst docs: add multiple databases and metadata separation docs (#586) 2021-02-23 12:01:19 +00:00
index.rst docs: add basic FAQs 2021-06-23 11:30:45 +00:00
mysql-preview.rst docs: update getting started for 2.0 2021-06-23 08:10:12 +00:00
telemetry.rst docs: update paths for core and cloud (#5665) 2020-08-25 21:51:21 +05:30
upgrade-hasura-v2.rst docs: update docker guides with 2.0 changes 2021-06-23 11:21:55 +00:00