Skip to content

Commit f0dc6b9

Browse files
Query resources and storage access timeout (#1180)
* touch * access timeout * removed file * add fix --------- Co-authored-by: katarinasupe <supe.katarina@gmail.com>
1 parent 351391b commit f0dc6b9

File tree

1 file changed

+28
-1
lines changed

1 file changed

+28
-1
lines changed

pages/help-center/errors/transactions.mdx

Lines changed: 28 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ import {CommunityLinks} from '/components/social-card/CommunityLinks'
1212
While working with Memgraph, you can encounter various transaction errors. Here are some of them, along with the instructions on how to handle them:
1313
- [Conflicting transactions](#conflicting-transaction)
1414
- [Transaction timeout](#transaction-timeout)
15+
- [Storage access timeout](#storage-access-timeout)
1516

1617
## Conflicting transactions
1718

@@ -112,5 +113,31 @@ To change that, update the flag `--query-execution-timeout-sec` value to a value
112113

113114
Here are the [instructions](/configuration/configuration-settings#using-flags-and-config-file) on how to update the configuration.
114115

116+
## Storage access timeout
115117

116-
<CommunityLinks/>
118+
### Error messages
119+
120+
Here are the storage access error messages you might encounter:
121+
122+
1. **Cannot access storage, unique access query is running. Try again later.**
123+
2. **Cannot get unique access to the storage. Try stopping other queries that are running in parallel.**
124+
125+
### Understanding storage access timeout
126+
127+
Storage access timeouts occur during query preparation when the query execution engine cannot get the required type of access to the storage. There are two types of storage access:
128+
129+
- **Shared access**: Multiple queries can have shared access at the same time, but shared access cannot be granted while a query with unique access is running.
130+
- **Unique access**: Only one query can have unique access at a time, and no other query can have any type of access during that period.
131+
132+
These timeouts prevent worker starvation and database blocking that could occur if queries were to wait indefinitely for storage access.
133+
134+
### Handling storage access timeout
135+
136+
When you encounter a storage access timeout:
137+
138+
1. Check for long-running queries that might be blocking storage access.
139+
2. Consider breaking down complex queries that require unique access into smaller operations.
140+
3. Retry the query after other queries have completed.
141+
4. If possible, schedule queries requiring unique access during periods of lower database activity.
142+
143+
<CommunityLinks/>

0 commit comments

Comments
 (0)