You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -112,5 +113,31 @@ To change that, update the flag `--query-execution-timeout-sec` value to a value
112
113
113
114
Here are the [instructions](/configuration/configuration-settings#using-flags-and-config-file) on how to update the configuration.
114
115
116
+
## Storage access timeout
115
117
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.
0 commit comments