From 76778369f061971d0b1ea30efdf2150ca6f5042e Mon Sep 17 00:00:00 2001 From: June Kim Date: Sun, 10 May 2026 08:41:04 -0700 Subject: [PATCH 1/2] Add hint with docs link to ResourceExhaustion errors Per discussion #29790: enhances ResourceExhaustion error hints to guide users on resolving limit violations. The hint now tells users to either drop an existing resource or contact support to request a limit increase, and links to the system variables documentation for reference. All current resource limits are Materialize-controlled (not org-admin configurable), so the hint uniformly directs users to contact support rather than attempt ALTER SYSTEM SET. The docs link provides reference information about the limit system. --- src/adapter/src/error.rs | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/adapter/src/error.rs b/src/adapter/src/error.rs index 9bc067698dc82..ac7d4c6c3837a 100644 --- a/src/adapter/src/error.rs +++ b/src/adapter/src/error.rs @@ -525,7 +525,8 @@ impl AdapterError { .into(), ), AdapterError::ResourceExhaustion { resource_type, .. } => Some(format!( - "Drop an existing {resource_type} or contact support to request a limit increase." + "Drop an existing {resource_type}, or contact support to request a limit increase. \ + For more information about system variable limits, see https://materialize.com/docs/sql/alter-system-set/#system-variables" )), AdapterError::StatementTimeout => Some( "Consider increasing the maximum allowed statement duration for this session by \ From e778b46ae36dbdd8c5fc1f9781b1a2c052516052 Mon Sep 17 00:00:00 2001 From: June Kim Date: Sun, 10 May 2026 11:17:14 -0700 Subject: [PATCH 2/2] Fix docs URL anchor and terminology --- src/adapter/src/error.rs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/adapter/src/error.rs b/src/adapter/src/error.rs index ac7d4c6c3837a..c3a1cb22e169a 100644 --- a/src/adapter/src/error.rs +++ b/src/adapter/src/error.rs @@ -526,7 +526,7 @@ impl AdapterError { ), AdapterError::ResourceExhaustion { resource_type, .. } => Some(format!( "Drop an existing {resource_type}, or contact support to request a limit increase. \ - For more information about system variable limits, see https://materialize.com/docs/sql/alter-system-set/#system-variables" + For more information about resource limits, see https://materialize.com/docs/sql/alter-system-set/#other-configuration-parameters" )), AdapterError::StatementTimeout => Some( "Consider increasing the maximum allowed statement duration for this session by \