/en/sql-reference/functions/error-handling-functions/ Recent content in Error-handling functions on OpenText Analytics Database 26.2.x Hugo -- gohugo.io /en/sql-reference/functions/error-handling-functions/throw-error/ Mon, 01 Jan 0001 00:00:00 +0000 /en/sql-reference/functions/error-handling-functions/throw-error/ <p>Returns a user-defined error message.</p> <p>In a multi-node cluster, race conditions might cause the order of error messages to differ.</p> <h2 id="behavior-type">Behavior type</h2> <a class="glosslink" href="../../../../en/glossary/immutable-invariant-functions/" title="">Immutable</a> <h2 id="syntax">Syntax</h2> <pre tabindex="0"><code>THROW_ERROR ( <span class="code-variable">message</span> ) </code></pre><h2 id="parameters">Parameters</h2> <dl> <dt><em><code>message</code></em></dt> <dd>The VARCHAR string to return.</dd> </dl> <h2 id="examples">Examples</h2> <p>Return an error message when a CASE statement is met:</p> <pre tabindex="0"><code>=&gt; CREATE TABLE pitcher_err (some_text varchar); CREATE TABLE =&gt; COPY pitcher_err FROM STDIN; Enter data to be copied followed by a newline. End with a backslash and a period on a line by itself. &gt;&gt; big foo value &gt;&gt; bigger foo other value &gt;&gt; bar another foo value &gt;&gt; \. =&gt; SELECT (CASE WHEN true THEN THROW_ERROR(&#39;Failure!!!&#39;) ELSE some_text END) FROM pitcher_err; ERROR 7137: USER GENERATED ERROR: Failure!!! </code></pre><p>Return an error message when a CASE statement using <a href="../../../../en/sql-reference/functions/match-and-search-functions/regular-expression-functions/regexp-like/#">REGEXP_LIKE</a> is met:</p> <pre tabindex="0"><code> =&gt; SELECT (CASE WHEN REGEXP_LIKE(some_text, &#39;other&#39;) THEN THROW_ERROR(&#39;Failure at &#34;&#39; || some_text || &#39;&#34;&#39;) END) FROM pitcher_err; ERROR 4566: USER GENERATED ERROR: Failure at &#34;bar another foo value&#34; </code></pre>