hasura/graphql-engine
1
0
Fork 0
mirror of https://github.com/hasura/graphql-engine.git synced 2024-11-09 13:25:23 +03:00
Code Issues Projects Releases Wiki Activity

docs: update multiple mutations in a request

Browse Source 
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/5969
GitOrigin-RevId: a739dd8a17a62e614219f785c9ba708f2ebf3e8f
This commit is contained in:
Rob Dominguez 2022-09-22 07:20:02 -05:00 committed by hasura-bot
parent 1319304170
commit 8eaa447bbb
1 changed files with 15 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/docs/mutations/postgres/multiple-mutations.mdx
View File

@ -16,14 +16,19 @@ import GraphiQLIDE from '@site/src/components/GraphiQLIDE';
## Execution
If multiple mutations are part of the same request, they are executed
**sequentially** in a single **transaction**. If any of the mutations
fail, all the executed mutations will be rolled back.
If multiple mutations are part of the same request, they are executed **sequentially** in a single **transaction**. If
any of the mutations fail, all the executed mutations will be rolled back.
:::info Note
In requests where a [Remote Schema](/remote-schemas/index.mdx) or [Action](/actions/index.mdx) is present, and a
mutation fails, rollback is not possible. Any mutations executed before the failed mutation will still succeed.
:::
## Run multiple top level mutations in the same request
**Example:** Delete all `article` objects written by an author and
update the `author` object:
**Example:** Delete all `article` objects written by an author and update the `author` object:
<GraphiQLIDE
query={`mutation reset_author {
@ -46,7 +51,7 @@ update the `author` object:
}
}
}`}
response={`{
response={`{
"data": {
"delete_article": {
"affected_rows": 2
@ -66,11 +71,10 @@ response={`{
## Insert an object and a nested object in the same mutation
If you are trying to insert multiple objects which have relationships
between them, you can use nested inserts.
If you are trying to insert multiple objects which have relationships between them, you can use nested inserts.
**Example:** Insert a new `article` object with its `author` and return
the inserted article object with its author in the response:
**Example:** Insert a new `article` object with its `author` and return the inserted article object with its author in
the response:
<GraphiQLIDE
query={`mutation insert_article {
@ -98,7 +102,7 @@ the inserted article object with its author in the response:
}
}
}`}
response={`{
response={`{
"data": {
"insert_article": {
"affected_rows": 2,