Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Trying to improve doc. of execution-pipline.md by correcting and... #497

Open
wants to merge 1 commit into
base: dev
Choose a base branch
from

Conversation

valbers
Copy link
Collaborator

@valbers valbers commented Sep 22, 2024

rephrasing.


As result of GraphQL query execution, a dictionary with resolved values will be returned. It contains following fields:
The result of a GraphQL query execution is a dictionary with resolved values. This dictionary contains the following fields:
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actually, now it is a GQLResponse object

type GQLResponse =
    { DocumentId: int
      Data : Output Skippable
      Errors : GQLProblemDetails list Skippable }

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The result of a GraphQL query execution is a dictionary with resolved values. This dictionary contains the following fields:
The result of a GraphQL query execution is a `GQLResponse` object with the following fields:

Comment on lines +55 to +57
- `documentId`: which is the hash code of the query's AST document - it can be used to implement execution plan caching (persistent queries).
- `data`: with a formated GraphQL response matching the requested query.
- `errors`: optional. If it has been provided, it will contain a list of errors that occured during query execution.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `documentId`: which is the hash code of the query's AST document - it can be used to implement execution plan caching (persistent queries).
- `data`: with a formated GraphQL response matching the requested query.
- `errors`: optional. If it has been provided, it will contain a list of errors that occured during query execution.
- `documentId`: which is the hash code of the query's AST document - it can be used to implement execution plan caching (persistent queries).
- `data`: optional, a formatted GraphQL response matching the requested query (`KeyValuePair seq`). Absent in case of an error that does not allow continuing processing and returning any GraphQL results.
- `errors`: optional, contains a list of errors (`GQLProblemDetails`) that occurred during query execution.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants