Google Git
Sign in
apache / ignite-website / 3a95526b51fdcd47e0cef43fccfea9035813fe27 / . / docs / ignite3 / 3.1.0 / administrators-guide / handling-exceptions.html
blob: bb12c400bf42db850762cb5b372e1936298be695 [file] [log] [blame]
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<!-- Bugyard widget embed -->
<script type="text/javascript">
!function(){
if("function" != typeof window.bugyard){
var a = function(){ a.c(arguments) };
a.q = [], a.c = function(b){ a.q.push(b) };
window.bugyard = a;
var b = document.createElement("script");
b.setAttribute("data-bugyard", "610961912c35ff001493163a");
b.setAttribute("async", "async");
b.setAttribute("defer", "defer");
b.setAttribute("src", "/assets/js/bugyard.min.js");
document.getElementsByTagName("head")[0].appendChild(b);
}
}();
window.bugyard("hideButton");
</script>
<!-- Bugyard widget embed -->
<link rel="preload" href='/assets/js/code-tabs.js?1' as="script" crossorigin>
<link rel="preload" href='/assets/js/page-nav.js' as="script" crossorigin>
<link rel="preload" href='/assets/js/docs-menu.js?20201005' as="script" crossorigin>
<style>:root{--gg-red:#ec1c24;--gg-orange:#ec1c24;--gg-orange-dark:#bc440b;--gg-orange-filter:invert(47%) sepia(61%) saturate(1950%) hue-rotate(345deg) brightness(100%) contrast(95%);--gg-dark-gray:#333333;--orange-line-thickness:3px;--block-code-background:rgba(241, 241, 241, 20%);--inline-code-background:rgba(241, 241, 241, 90%);--padding-top:25px;--link-color:#ec1c24;--body-background:#fcfcfc}header{min-height:var(--header-height);background:#fff;box-shadow:0 4px 10px 0 #eee,0 0 4px 0 #d5d5d5;z-index:1}header>.container{display:grid;grid-template-columns:auto auto 1fr auto auto auto;grid-template-areas:'left-toggle home nav ver api search lang';grid-template-rows:40px;flex-direction:row;align-items:center;justify-content:flex-start;padding:12px 20px;max-width:1400px;margin:0 auto}header nav>ul{padding:0;margin:0;list-style:none;display:inherit}header .dropdown{display:none;position:fixed;top:calc(var(--header-height) - 12px);width:auto;background:#fff;box-shadow:0 4px 4px 0 rgba(0,0,0,.24),0 0 4px 0 rgba(0,0,0,.12);border-radius:4px;padding-top:10px;padding-bottom:12px;z-index:2}header .dropdown li{display:flex}header .dropdown a{color:grey!important;font-size:16px;padding-top:5px;padding-bottom:4px}header .menu{border:none;background:0 0;width:40px;height:40px;margin-right:12px;grid-area:left-toggle}header .menu img{width:18px;height:12px}header .search-close,header .top-nav-toggle{background:0 0;border:none;padding:0;width:36px;height:36px;display:inline-flex;align-items:center;justify-content:center;color:var(--gg-dark-gray);font-size:26px}header .search-toggle{grid-area:search}header .top-nav-toggle{grid-area:top-toggle}header .home{grid-area:home;margin-right:auto}header .home img{height:36px}header #api-docs{grid-area:api;margin:0;display:flex}header #api-docs .dropdown{padding:.5em 0}header #api-docs a{padding:9px 14px;color:var(--gg-dark-gray)!important;text-decoration:none;white-space:nowrap}header #api-docs .dropdown-item a{font-weight:400;display:block;width:100%;min-width:150px}header #lang-selector li{list-style:none;display:flex;padding:9px 14px}header #lang-selector li a{display:flex;color:#000;align-items:center}header #lang-selector li a span{font-size:10px;margin-left:5px}header #lang-selector li a img{width:25px}header #lang-selector li .dropdown{margin-left:-70px}header #lang-selector li .dropdown .dropdown-item{padding:0 1em;margin-bottom:8px}header #lang-selector li .dropdown .dropdown-item a span{font-size:14px}header .search{margin-left:auto;margin-right:20px;grid-area:search}header .search input[type=search]{color:var(--gg-dark-gray);background:rgba(255,255,255,.8);border:1px solid #ccc;padding:10px 15px;font-family:inherit;max-width:148px;height:37px;font-size:14px;-webkit-appearance:unset;appearance:unset}header #version-selector{list-style:none;grid-area:ver;line-height:28px;border-radius:0;margin-right:10px;border:none;color:var(--gg-dark-gray);padding:5px 16px 5px 10px;white-space:nowrap;font-size:14px;width:auto;text-align:right;box-sizing:border-box;text-align-last:right;-moz-appearance:none;-webkit-appearance:none;appearance:none;direction:rtl}header #version-selector option{direction:ltr}header>nav{grid-area:nav;font-size:18px;display:flex;flex-direction:row;margin:0 20px}header #lang-selector{grid-area:lang}header .search-close{margin-right:10px}@media (max-width:600px){header .search{margin-right:5px}header .search input[type=search]{max-width:110px}}header:not(.narrow-header) .search-close,header:not(.narrow-header) .top-nav-toggle{display:none}@media (max-width:670px){header>.container{grid-template-columns:auto 1fr auto;grid-template-areas:'left-toggle home search' 'ver api lang'}header #lang-selector li{justify-content:flex-end}}pre,pre.rouge{padding:8px 15px;background:var(--block-code-background)!important;border-radius:5px;border:1px solid #e5e5e5;overflow-x:auto;min-height:36px;line-height:18px;color:#545454}code{color:#545454}pre.rouge code{background:0 0!important}:not(pre)>code{background:var(--inline-code-background);padding:.1em .5em;background-clip:padding-box;border-radius:3px;color:#545454;font-size:90%}.listingblock .content{position:relative}.highlight{color:#586e75}.highlight .c1{color:#657b83}.highlight .nt{color:#b58900}.highlight .o{color:#93a1a1}.highlight .k{color:#6c71c4}.highlight .kt{color:#cb4b16}.highlight .s,.highlight .s1{color:#859900}.highlight .nc{color:#b58900}.highlight .na{color:#268bd2}body{font-family:'Open Sans',sans-serif}h1,h2{color:#000;font-weight:400;font-family:'Open Sans'}h1{font-size:36px;line-height:40px}a{text-decoration:none;color:var(--link-color)}section{color:#545454}.admonitionblock .icon .title{display:none}body{--header-height:64px;--promotion-bar-height:35px;--footer-height:104px;--footer-gap:60px;padding:0;margin:0;display:flex;flex-direction:column;min-height:100vh;background-color:var(--body-background);font-family:'Open Sans',sans-serif}body>section{flex:1}header{position:-webkit-sticky;position:sticky;top:0;z-index:2}*{box-sizing:border-box}@media (max-width:670px){body{--header-height:97px}}.left-nav{padding:10px 20px;width:289px;overflow-y:auto;top:calc(var(--header-height) + var(--promotion-bar-height));height:calc(100vh - var(--header-height) - var(--promotion-bar-height));font-family:'Open Sans';padding-top:var(--padding-top);background-color:var(--body-background)}.left-nav li{list-style:none}.left-nav a,.left-nav button{text-decoration:none;color:#757575;font-size:16px;display:inline-flex;width:100%;margin:2px 0;padding:.25em .375em;background:0 0;border:none;font:inherit;text-align:left}.left-nav a.active{color:var(--link-color)}.left-nav .nav-group{margin-left:6px;font-size:14px}.left-nav nav{border-left:2px solid #ddd;margin-bottom:5px}.left-nav nav.collapsed{display:none}.left-nav nav>li>a,.left-nav nav>li>button{padding-left:20px;text-align:left}.left-nav nav>li>a.active{border-left:var(--orange-line-thickness) solid var(--active-color);padding-left:calc(20px - var(--orange-line-thickness))}.left-nav nav.sub_pages{border:none}.left-nav nav.sub_pages a{padding-left:32px}.left-nav .state-indicator{margin-left:auto;margin-top:5px;width:6.2px;height:10px;flex:0 0 auto;filter:invert(49%) sepia(4%) saturate(5%) hue-rotate(23deg) brightness(92%) contrast(90%)}.left-nav button.expanded .state-indicator{transform:rotate(90deg)}.right-nav{width:289px;padding:12px 26px;overflow-y:auto;height:calc(100vh - var(--header-height));top:0;position:-webkit-sticky;position:sticky;display:flex;flex-direction:column;font-family:'Open sans';padding-top:var(--padding-top);background-color:#fff}.right-nav ul{list-style:none;padding:0;margin:0}.right-nav li{padding:0}.right-nav a{--border-width:0px;font-size:14px;color:#757575;padding-left:calc(15px * var(--nesting-level) + 8px - var(--border-width));margin:.3em 0;display:inline-block}.right-nav .sectlevel1{border-left:2px solid #ddd}.right-nav .sectlevel1{--nesting-level:0}.right-nav .sectlevel2{--nesting-level:1}.right-nav .sectlevel3{--nesting-level:2}@media (max-width:1200px){.right-nav{width:230px}}.right-nav footer{font-size:12px;padding:calc(var(--footer-gap) * .3) 0 5px;text-align:left;margin:auto 0 0}section.page-docs{display:grid;grid-template-columns:auto 1fr auto;grid-template-rows:100%;grid-template-areas:'left-nav content right-nav';line-height:20px;max-width:1440px;margin:auto;width:100%}section.page-docs>article{border-left:1px solid #eee;background-color:#fff;padding:0 50px 30px;grid-area:content;overflow:hidden;font-family:sans-serif;font-size:16px;color:#545454;line-height:1.6em}section.page-docs>article h1,section.page-docs>article h2{font-family:'Open Sans'}@media (max-width:800px){section.page-docs>article{padding-left:15px;padding-right:15px}}section.page-docs .edit-link{position:relative;top:10px;right:10px;float:right;padding-top:calc(var(--header-height) + var(--padding-top));margin-top:calc((-1 * var(--header-height)))}section.page-docs h1,section.page-docs h2{margin-bottom:0}section.page-docs h2[id]{margin-top:var(--margin-top);margin-bottom:calc(var(--margin-top) * .5);z-index:-1}section.page-docs .title{font-style:italic}section.page-docs h2[id]{--margin-top:1.2em}.left-nav{bottom:0;position:-webkit-sticky;position:sticky}.left-nav{grid-area:left-nav}.right-nav{grid-area:right-nav}.left-nav__overlay{display:none;background:rgba(0,0,0,.5);z-index:1;position:fixed;top:var(--header-height);bottom:0;left:0;right:0}@media (max-width:990px){body:not(.hide-left-nav) .left-nav__overlay{display:block}nav.left-nav{background:#fafafa;grid-area:left-nav;box-shadow:0 4px 4px 0 rgba(0,0,0,.24),0 0 4px 0 rgba(0,0,0,.12);min-height:calc(100vh - var(--header-height));max-height:calc(100vh - var(--header-height));position:fixed;bottom:0;top:var(--header-height);z-index:2}section.page-docs>article{grid-column-start:left-nav;grid-column-end:content;grid-row:content}}@media (max-width:800px){nav.right-nav{display:none}}:target:before{content:"";display:block;margin-top:calc(var(--header-height) * -1);height:var(--header-height);width:1px}@media (min-width:600px) and (max-width:900px){:target:before{content:"";display:block;width:1px;margin-top:-150px;height:150px}}
#header #promotion-bar { background-color: #333333; padding: 8px; }
#header #promotion-bar p { font-size: 14px; line-height: 1.4em; font-weight: 600; padding: 0; margin: 0; color: #f0f0f0; text-align: center;}
#header #promotion-bar p a { color: #FCB903; } </style>
<meta name="ignite-version" content="3.1.0" />
<title>Handling Exceptions | Ignite Documentation</title>
<link rel="canonical" href="/docs/latest/administrators-guide/handling-exceptions" />
<link rel="shortcut icon" href="/favicon.ico">
<meta name='viewport' content='width=device-width, height=device-height, initial-scale=1.0, minimum-scale=1.0'>
<link rel="preload" as="style" href="/assets/css/fonts.css" />
<link rel="stylesheet" href="/assets/css/fonts.css" media="print" onload="this.media='all'">
<noscript>
<link rel="stylesheet" href="/assets/css/fonts.css">
</noscript>
<link href="/docs/pagefind/pagefind-ui.css" rel="stylesheet">
<script src="/docs/pagefind/pagefind-ui.js"></script>
<script>
window.addEventListener('DOMContentLoaded', () => {
new PagefindUI({
element: "#search",
showSubResults: true,
showImages: false,
});
});
</script>
<script src="/assets/js/mermaid.min.js"></script>
<script>
document.addEventListener('DOMContentLoaded', function () {
const blocks = document.querySelectorAll('.mermaid');
if (blocks.length) {
mermaid.initialize({ startOnLoad: false });
mermaid.run();
}
});
</script>
<script>
// AnchorJS - v4.2.0 - 2019-01-01
// https://github.com/bryanbraun/anchorjs
// Copyright (c) 2019 Bryan Braun; Licensed MIT
!function(A,e){"use strict";"function"==typeof define&&define.amd?define([],e):"object"==typeof module&&module.exports?module.exports=e():(A.AnchorJS=e(),A.anchors=new A.AnchorJS)}(this,function(){"use strict";return function(A){function f(A){A.icon=A.hasOwnProperty("icon")?A.icon:"",A.visible=A.hasOwnProperty("visible")?A.visible:"hover",A.placement=A.hasOwnProperty("placement")?A.placement:"right",A.ariaLabel=A.hasOwnProperty("ariaLabel")?A.ariaLabel:"Anchor",A.class=A.hasOwnProperty("class")?A.class:"",A.base=A.hasOwnProperty("base")?A.base:"",A.truncate=A.hasOwnProperty("truncate")?Math.floor(A.truncate):64,A.titleText=A.hasOwnProperty("titleText")?A.titleText:""}function p(A){var e;if("string"==typeof A||A instanceof String)e=[].slice.call(document.querySelectorAll(A));else{if(!(Array.isArray(A)||A instanceof NodeList))throw new Error("The selector provided to AnchorJS was invalid.");e=[].slice.call(A)}return e}this.options=A||{},this.elements=[],f(this.options),this.isTouchDevice=function(){return!!("ontouchstart"in window||window.DocumentTouch&&document instanceof DocumentTouch)},this.add=function(A){var e,t,i,n,o,s,a,r,c,h,l,u,d=[];if(f(this.options),"touch"===(l=this.options.visible)&&(l=this.isTouchDevice()?"always":"hover"),A||(A="h2, h3, h4, h5, h6"),0===(e=p(A)).length)return this;for(function(){if(null===document.head.querySelector("style.anchorjs")){var A,e=document.createElement("style");e.className="anchorjs",e.appendChild(document.createTextNode("")),void 0===(A=document.head.querySelector('[rel="stylesheet"], style'))?document.head.appendChild(e):document.head.insertBefore(e,A),e.sheet.insertRule(" .anchorjs-link { opacity: 0; text-decoration: none; -webkit-font-smoothing: antialiased; -moz-osx-font-smoothing: grayscale; }",e.sheet.cssRules.length),e.sheet.insertRule(" *:hover > .anchorjs-link, .anchorjs-link:focus { opacity: 1; }",e.sheet.cssRules.length),e.sheet.insertRule(" [data-anchorjs-icon]::after { content: attr(data-anchorjs-icon); }",e.sheet.cssRules.length),e.sheet.insertRule(' @font-face { font-family: "anchorjs-icons"; src: url(data:n/a;base64,AAEAAAALAIAAAwAwT1MvMg8yG2cAAAE4AAAAYGNtYXDp3gC3AAABpAAAAExnYXNwAAAAEAAAA9wAAAAIZ2x5ZlQCcfwAAAH4AAABCGhlYWQHFvHyAAAAvAAAADZoaGVhBnACFwAAAPQAAAAkaG10eASAADEAAAGYAAAADGxvY2EACACEAAAB8AAAAAhtYXhwAAYAVwAAARgAAAAgbmFtZQGOH9cAAAMAAAAAunBvc3QAAwAAAAADvAAAACAAAQAAAAEAAHzE2p9fDzz1AAkEAAAAAADRecUWAAAAANQA6R8AAAAAAoACwAAAAAgAAgAAAAAAAAABAAADwP/AAAACgAAA/9MCrQABAAAAAAAAAAAAAAAAAAAAAwABAAAAAwBVAAIAAAAAAAIAAAAAAAAAAAAAAAAAAAAAAAMCQAGQAAUAAAKZAswAAACPApkCzAAAAesAMwEJAAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAAAAAAAAAAAAAQAAg//0DwP/AAEADwABAAAAAAQAAAAAAAAAAAAAAIAAAAAAAAAIAAAACgAAxAAAAAwAAAAMAAAAcAAEAAwAAABwAAwABAAAAHAAEADAAAAAIAAgAAgAAACDpy//9//8AAAAg6cv//f///+EWNwADAAEAAAAAAAAAAAAAAAAACACEAAEAAAAAAAAAAAAAAAAxAAACAAQARAKAAsAAKwBUAAABIiYnJjQ3NzY2MzIWFxYUBwcGIicmNDc3NjQnJiYjIgYHBwYUFxYUBwYGIwciJicmNDc3NjIXFhQHBwYUFxYWMzI2Nzc2NCcmNDc2MhcWFAcHBgYjARQGDAUtLXoWOR8fORYtLTgKGwoKCjgaGg0gEhIgDXoaGgkJBQwHdR85Fi0tOAobCgoKOBoaDSASEiANehoaCQkKGwotLXoWOR8BMwUFLYEuehYXFxYugC44CQkKGwo4GkoaDQ0NDXoaShoKGwoFBe8XFi6ALjgJCQobCjgaShoNDQ0NehpKGgobCgoKLYEuehYXAAAADACWAAEAAAAAAAEACAAAAAEAAAAAAAIAAwAIAAEAAAAAAAMACAAAAAEAAAAAAAQACAAAAAEAAAAAAAUAAQALAAEAAAAAAAYACAAAAAMAAQQJAAEAEAAMAAMAAQQJAAIABgAcAAMAAQQJAAMAEAAMAAMAAQQJAAQAEAAMAAMAAQQJAAUAAgAiAAMAAQQJAAYAEAAMYW5jaG9yanM0MDBAAGEAbgBjAGgAbwByAGoAcwA0ADAAMABAAAAAAwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAH//wAP) format("truetype"); }',e.sheet.cssRules.length)}}(),t=document.querySelectorAll("[id]"),i=[].map.call(t,function(A){return A.id}),o=0;o<e.length;o++)if(this.hasAnchorJSLink(e[o]))d.push(o);else{if(e[o].hasAttribute("id"))n=e[o].getAttribute("id");else if(e[o].hasAttribute("data-anchor-id"))n=e[o].getAttribute("data-anchor-id");else{for(c=r=this.urlify(e[o].textContent),a=0;void 0!==s&&(c=r+"-"+a),a+=1,-1!==(s=i.indexOf(c)););s=void 0,i.push(c),e[o].setAttribute("id",c),n=c}n.replace(/-/g," "),(h=document.createElement("a")).className="anchorjs-link "+this.options.class,h.setAttribute("aria-label",this.options.ariaLabel),h.setAttribute("data-anchorjs-icon",this.options.icon),this.options.titleText&&(h.title=this.options.titleText),u=document.querySelector("base")?window.location.pathname+window.location.search:"",u=this.options.base||u,h.href=u+"#"+n,"always"===l&&(h.style.opacity="1"),""===this.options.icon&&(h.style.font="1em/1 anchorjs-icons","left"===this.options.placement&&(h.style.lineHeight="inherit")),"left"===this.options.placement?(h.style.position="absolute",h.style.marginLeft="-1em",h.style.paddingRight="0.5em",e[o].insertBefore(h,e[o].firstChild)):(h.style.paddingLeft="0.375em",e[o].appendChild(h))}for(o=0;o<d.length;o++)e.splice(d[o]-o,1);return this.elements=this.elements.concat(e),this},this.remove=function(A){for(var e,t,i=p(A),n=0;n<i.length;n++)(t=i[n].querySelector(".anchorjs-link"))&&(-1!==(e=this.elements.indexOf(i[n]))&&this.elements.splice(e,1),i[n].removeChild(t));return this},this.removeAll=function(){this.remove(this.elements)},this.urlify=function(A){return this.options.truncate||f(this.options),A.trim().replace(/\'/gi,"").replace(/[& +$,:;=?@"#{}|^~[`%!'<>\]\.\/\(\)\*\\\n\t\b\v]/g,"-").replace(/-{2,}/g,"-").substring(0,this.options.truncate).replace(/^-+|-+$/gm,"").toLowerCase()},this.hasAnchorJSLink=function(A){var e=A.firstChild&&-1<(" "+A.firstChild.className+" ").indexOf(" anchorjs-link "),t=A.lastChild&&-1<(" "+A.lastChild.className+" ").indexOf(" anchorjs-link ");return e||t||!1}}});
</script>
</head>
<body>
<header>
<!--#include virtual="/includes/promotion_banner.html" -->
<div class="container">
<button type='button' class='menu' title='Docs menu'>
<img src="/assets/images/menu-icon.svg" width="18" height="12" alt="menu icon" />
</button>
<div class='home'>
<a href="/" class='home' title='Apache Ignite home'>
<img src="/assets/images/apache_ignite_logo.svg" alt="Apache Ignite logo" width="103" height="36" >
</a>
</div>
<select id="product-selector">
<option value="/docs/ignite2/latest" >Ignite 2</option>
<option value="/docs/ignite3/latest"selected>Ignite 3</option>
</select>
<select id="version-selector">
<option value="3.1.0">3.1.0</option>
</select>
<nav id="api-docs"><ul>
<li><a href="#">APIs</a>
<nav class='dropdown'>
<ul>
<li class="dropdown-item"><a href="/releases/ignite3/3.1.0/javadoc/">Java</a></li>
<li class="dropdown-item"><a href="/releases/ignite3/3.1.0/dotnetdoc/">C#/.NET</a></li>
<li class="dropdown-item"><a href="/releases/ignite3/3.1.0/cppdoc/">C++</a></li>
<li class="dropdown-item"><a href="/releases/ignite3/3.1.0/openapi.yaml">OpenAPI</a></li>
</ul>
</nav>
</li>
<li><a href="#">Examples</a>
<nav class="dropdown">
<ul>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/examples" target="_blank" rel="noopener" title="Apache Ignite Java examples">Java</a></li>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/modules/platforms/dotnet/examples" target="_blank" rel="noopener" title="Apache Ignite C#/.NET examples">C#/.NET</a></li>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/modules/platforms/cpp/examples" target="_blank" rel="noopener" title="Apache Ignite C++ examples">C++</a></li>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/modules/platforms/python/examples" target="_blank" rel="noopener" title="Apache Ignite Python examples">Python</a></li>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/modules/platforms/nodejs/examples" target="_blank" rel="noopener" title="Apache Ignite NodeJS examples">NodeJS</a></li>
<li class="dropdown-item"><a href="https://github.com/apache/ignite/tree/master/modules/platforms/php/examples" target="_blank" rel="noopener" title="Apache Ignite PHP examples">PHP</a></li>
</ul>
</nav>
</li></ul>
</nav>
<div id="search-button"></div>
<nav id="lang-selector"><ul>
<li><a href="#"><img src="/assets/images/icon_lang_en_75x75.jpg" alt="English language icon" width="25" height="25" /><span>▼</span></a>
<nav class="dropdown">
<li class="dropdown-item"><a href="/docs/latest/" ><img src="/assets/images/icon_lang_en_75x75.jpg" alt="English language icon" width="25" height="25" /><span>English</span></a></li>
<li class="dropdown-item"><a href="https://www.ignite-service.cn/doc/java/" target="_blank" rel="noopener"><img src="/assets/images/icon_lang_cn_75x75.jpg" width="25" height="25" alt="Chinese language icon" /><span>Chinese</span></a></li>
</nav>
</li></ul>
</nav>
<button type='button' class='top-nav-toggle'>⋮</button>
</div>
<div id="search-wrapper">
<div id="search"></div>
</div>
</header>
<link rel="stylesheet" href="/assets/css/docs.css">
<section class='page-docs'>
<nav class='left-nav' data-swiftype-index='false'>
<li>
<a href="/docs/ignite3/latest/index" class='' >About Apache Ignite 3</a>
</li>
<li>
<button type='button' class='group-toggle collapsed '>Installation<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group collapsed'>
<li>
<a href="/docs/ignite3/latest/installation/installing-using-zip"
class=''
>Installing Using ZIP Archive</a>
</li>
<li>
<a href="/docs/ignite3/latest/installation/deb-rpm"
class=''
>Installing DEB or RPM package</a>
</li>
<li>
<a href="/docs/ignite3/latest/installation/installing-using-docker"
class=''
>Installing Docker</a>
</li>
<li>
<a href="/docs/ignite3/latest/installation/migration-from-ai3-1"
class=''
>Migration From Ignite 3.0</a>
</li>
<li>
<button
type='button'
class='collapsed '>Migration From Ignite 2<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/installation/migration-from-ai2/config" class=''>Configuration Migration</a></li>
<li><a href="/docs/ignite3/latest/installation/migration-from-ai2/persistent-migration" class=''>Persistent Data Migration</a></li>
<li><a href="/docs/ignite3/latest/installation/migration-from-ai2/ai2-functions" class=''>SQL Function Comparison</a></li>
</nav>
</li>
</nav>
</li>
<li>
<button type='button' class='group-toggle collapsed '>Getting Started<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group collapsed'>
<li>
<a href="/docs/ignite3/latest/quick-start/getting-started-guide"
class=''
>Quick Start</a>
</li>
<li>
<a href="/docs/ignite3/latest/quick-start/start-cluster"
class=''
>Start Ignite 3 Cluster</a>
</li>
<li>
<a href="/docs/ignite3/latest/quick-start/explore-sql"
class=''
>Explore SQL Capabilities</a>
</li>
<li>
<a href="/docs/ignite3/latest/quick-start/persist-data"
class=''
>Persist Your Data</a>
</li>
<li>
<a href="/docs/ignite3/latest/quick-start/java-api"
class=''
>Use Java API</a>
</li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/quick-start/embedded-mode" class='' >Embedded Mode</a>
</li>
<li>
<a href="/docs/ignite3/latest/ignite-cli-tool" class='' >Ignite CLI Tool</a>
</li>
<li>
<button type='button' class='group-toggle collapsed '>Developers Guide<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group collapsed'>
<li>
<a href="/docs/ignite3/latest/developers-guide/table-api"
class=''
>Table API</a>
</li>
<li>
<button
type='button'
class='collapsed '>Clients<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/developers-guide/clients/overview" class=''>Overview</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/java" class=''>Java Clients</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/dotnet" class=''>.NET Clients</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/cpp" class=''>C++ Clients</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/python" class=''>Python Clients</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/ado" class=''>ADO.NET Integration</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/linq" class=''>.NET LINQ Queries</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/clients/jdbc-driver" class=''>JDBC Driver</a></li>
</nav>
</li>
<li>
<button
type='button'
class='collapsed '>Working with SQL<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/developers-guide/sql/calcite-based-sql-engine" class=''>Introduction</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/sql-api" class=''>SQL API</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/jdbc-driver" class=''>JDBC Driver</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/odbc/odbc-driver" class=''>ODBC Driver</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/odbc/connection-string" class=''>ODBC Connection String</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/odbc/querying-modifying-data" class=''>Querying and Modifying Data</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/sql/odbc/specification" class=''>Standard Conformance</a></li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/developers-guide/java-to-tables"
class=''
>Tables from Java Classes</a>
</li>
<li>
<button
type='button'
class='collapsed '>Distributed Computing<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/developers-guide/compute/compute" class=''>Compute API</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/compute/serialization" class=''>Serialization</a></li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/developers-guide/transactions"
class=''
>Transactions</a>
</li>
<li>
<a href="/docs/ignite3/latest/developers-guide/data-streamer"
class=''
>Data Streaming</a>
</li>
<li>
<a href="/docs/ignite3/latest/developers-guide/code-deployment/code-deployment"
class=''
>Code Deployment</a>
</li>
<li>
<button
type='button'
class='collapsed '>Events<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/developers-guide/events/overview" class=''>Overview</a></li>
<li><a href="/docs/ignite3/latest/developers-guide/events/events-list" class=''>Events List</a></li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/developers-guide/rest/rest-api"
class=''
>REST API</a>
</li>
</nav>
</li>
<li>
<button type='button' class='group-toggle expanded '>Administrator's Guide<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group expanded'>
<li>
<button
type='button'
class='collapsed '>Ignite Configuration<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/administrators-guide/config/node-config" class=''>Node Configuration Parameters</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/config/cluster-config" class=''>Cluster Configuration Parameters</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/config/cli-config" class=''>CLI Configuration</a></li>
</nav>
</li>
<li>
<button
type='button'
class='collapsed '>Distributed Storage<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/administrators-guide/storage/storage-overview" class=''>Storage Overview</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/storage-profiles" class=''>Storage Profiles</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/data-partitions" class=''>Data Partitions</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/distribution-zones" class=''>Distribution Zones</a></li>
</nav>
</li>
<li>
<button
type='button'
class='collapsed '>Storage Engines<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/administrators-guide/storage/engines/storage-engines" class=''>Storage Engines Overview</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/engines/aipersist" class=''>AIPersist Engine</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/engines/rocksdb" class=''>RocksDB Engine</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/storage/engines/aimem" class=''>AIMem Engine</a></li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/lifecycle"
class=''
>Cluster Lifecycle</a>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/colocation"
class=''
>Data Colocation</a>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/disaster-recovery"
class=''
>Disaster Recovery for Partitions</a>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/system-groups-recovery"
class=''
>Disaster Recovery for System Groups</a>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/cluster-security"
class=''
>Cluster Security</a>
</li>
<li>
<button
type='button'
class='collapsed '>Security and Authentication<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/administrators-guide/security/ssl-tls" class=''>SSL/TLS</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/security/authentication" class=''>Authentication</a></li>
</nav>
</li>
<li>
<button
type='button'
class='collapsed '>Metrics and Monitoring<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/administrators-guide/metrics/configuring-metrics" class=''>Configuring Metrics</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/metrics/metrics-list" class=''>Metrics List</a></li>
<li><a href="/docs/ignite3/latest/administrators-guide/metrics/system-views" class=''>System Views</a></li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/administrators-guide/handling-exceptions"
class='active'
>Handling Exceptions</a>
</li>
</nav>
</li>
<li>
<button type='button' class='group-toggle collapsed '>SQL Reference<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group collapsed'>
<li>
<a href="/docs/ignite3/latest/sql-reference/ddl"
class=''
>Data Definition Language (DDL)</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/dml"
class=''
>Data Manipulation Language (DML)</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/transactions"
class=''
>Transactions</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/distribution-zones"
class=''
>Distribution Zones</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/data-types"
class=''
>Data Types</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/operators-and-functions"
class=''
>Supported Operators and Functions</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/operational-commands"
class=''
>Operational Commands</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/grammar-reference"
class=''
>Grammar Reference</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/keywords"
class=''
>Keywords</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-reference/sql-conformance"
class=''
>SQL Conformance</a>
</li>
<li>
<button
type='button'
class='collapsed '>Explain Statement<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class="sub_pages collapsed">
<li><a href="/docs/ignite3/latest/sql-reference/explain-statement" class=''>Explain Statement</a></li>
<li><a href="/docs/ignite3/latest/sql-reference/explain-operators-list" class=''>List Of Operators</a></li>
</nav>
</li>
</nav>
</li>
<li>
<button type='button' class='group-toggle collapsed '>SQL Performance Tuning<img class="state-indicator" src="/assets/images/left-nav-arrow.svg" width="6" height="10"></button>
<nav class='nav-group collapsed'>
<li>
<a href="/docs/ignite3/latest/sql-tuning/sql-tuning"
class=''
>SQL Performance Tuning</a>
</li>
<li>
<a href="/docs/ignite3/latest/sql-tuning/using-explain"
class=''
>Improving Queries</a>
</li>
</nav>
</li>
<li>
<a href="/docs/ignite3/latest/general-tips" class='' >General Configuration Tips</a>
</li>
<li>
<a href="/docs/ignite3/latest/glossary/glossary" class='' >Glossary</a>
</li>
</nav>
<div class="left-nav__overlay"></div>
<article data-swiftype-index='true'>
<a class='edit-link' href="https://github.com/apache/ignite-3/tree/main/docs/_docs/administrators-guide/handling-exceptions.adoc" target="_blank">Edit</a>
<h1>Handling Exceptions</h1>
<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p>This section outlines basic exceptions that can be generated by Apache Ignite and provides basic instructions for handling them.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="finding-stack-trace-information">Finding Stack Trace Information</h2>
<div class="sectionbody">
<div class="paragraph">
<p>When the exception happens, Apache Ignite provides a UUID of the specific exception, but not a full stack trace. For a full stack trace, check cluster logs.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="authentication-exceptions">Authentication Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-AUTHENTICATION-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Authentication error caused by unsupported authentication type.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the client configuration and use the supported configuration type.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-AUTHENTICATION-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Authentication error caused by invalid credentials.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check and correct user credentials.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-AUTHENTICATION-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Basic authentication provider is not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Configure basic authentication provider.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="catalog-exceptions">Catalog Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CATALOG-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Command to the catalog has not passed the validation.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">See the exception message for details. Typically, this is either caused by incorrect DDL query (same as IGN-SQL-4) or an internal Apache Ignite error.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="client-exceptions">Client Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Connection to client failed. This error is usually caused by incorrect address or connection timeout.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message. If a timeout occurred, make sure the timeout values in client and server configurations allow for long-running requests.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An issue occurred with connection protocol. This error can be caused by using an incompatible client version or data corruption.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message. If data corruption occurred, recover the data. If client versions are not compatible, use the correct client version.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Protocol version does not support a specific feature. Typically this is caused by version mismatch between client and server.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Update the client or the server to a newer version or do not use incompatible features.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to find the table by ID.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check if the table ID is correct.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error occurred with client configuration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information and fix the client configuration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cluster ID mismatch. This error can be caused by the client connecting to multiple different clusters.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check client configuration to make sure all endpoints belong to the same cluster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Client SSL configuration is not valid.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information. Make sure SSL configuration matches server-side configuration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Client handshake message error. This is usually caused by the client trying to connect to a wrong endpoint (for example, REST) or a non-Apache Ignite process is trying to connect to a Apache Ignite endpoint.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information. If the issue is with client, check and fix client configuration. If a third-party client is trying to connect, check what it is and fix the configuration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CLIENT-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Server to client request failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the network connectivity, client availability, and server logs for errors.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="code-deployment-exceptions">Code Deployment Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Access attempt to a non-existing deployment unit.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the deployment unit is specified correctly.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Duplicate deployment unit.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure deployment unit is unique. Update deployment unit name or version.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deployment unit content read error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the error message for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deployment unit is unavailable for computing.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the error message for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deployment unit zip deploy error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Verify the deployment package is not corrupted and retry deployment.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CODEDEPLOY-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deployment unit write to fs error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check file system permissions and available disk space.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="common-configuration-exceptions">Common Configuration Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMMONCFG-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Configuration apply failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the config for errors and ensure the path to the config file is correct.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMMONCFG-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Configuration parse error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check cluster logs for syntax errors in the config file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMMONCFG-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Configuration validation error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Correct invalid or inconsistent configuration parameters and retry startup.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="common-exceptions">Common Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation was stopped because node is stopping.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check that the cluster is up and running and try again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation was stopped because the component is not started.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for the node to complete the startup process and start all components.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation failed because an illegal argument or argument in a wrong format has been passed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for additional information. Specific actions depend on the operation that triggered the error.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation failed because SSL could not be configured.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information and update the configuration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation failed because a node has left the cluster.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Wait for the node to return to the cluster, or use a different node.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation failed because the cursor is already closed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message to find out why the cursor was closed before the operation.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error occurred while closing resources.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message to find out why the resource was closed before the operation.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">An error occurred while marshalling or unmarshalling objects.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check object serialization logic and ensure all involved classes are compatible.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The method cannot return a null value.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Verify the method’s implementation and ensure it returns a valid non-null result.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-CMN-65535</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Internal error has occurred.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This an unexpected internal error in Apache Ignite. In most cases, receiving it indicates a bug.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="compute-exceptions">Compute Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Classpath error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for additional information and fix the classpath error.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Class loader error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Most likely, this is caused by an internal error in Apache Ignite.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to initialize the job class.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Execution queue overflow.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Increase the <code>compute.queueMaxSize</code> configuration parameter to allow for larger queue.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compute job status transition error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the operation or check job status.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to cancel compute job.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the error message and fix the issue in it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compute job result not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the specified job ID exists.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compute job state cannot be retrieved.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the specified job ID exists. If it does, check the node logs for additional information.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compute job failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for more information on the reason for failure.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-10</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to resolve primary replica for colocated execution.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for additional information.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-11</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to change job priority.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message for additional information.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-12</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Specified node is not found in the cluster.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the specified node ID is correct and the node with the ID is in the cluster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-13</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Incompatible types for argument or result in compute job.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure that defined compute job argument and result marshallers match on both server and client sides.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-14</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Compute job cancelled.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Run the job again.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-COMPUTE-15</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Platform compute executor error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check executor logs for the issue.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="critical-workers-exceptions">Critical Workers Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-WORKERS-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">System worker does not update its heartbeat for a long time. Typically, this means that the node has stalled or is running slowly.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart the node.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-WORKERS-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">System-critical operation timed out.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart the node.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="distribution-zone-exceptions">Distribution Zone Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-DISTRZONES-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Distribution zone is not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the distribution zone name used. Most likely, it is incorrect.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-DISTRZONES-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Empty data nodes.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Add data nodes to the distribution zone.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="disaster-recovery-exceptions">Disaster Recovery Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Partition ID is not in valid range.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message. Most likely, the specified partition ID is not correct.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Nodes were not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message. Most likely, the specified node ID is not correct.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to recover partition states.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the operation. If it fails again, check the exception message for more information.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cluster is under load.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the operation when the cluster has less load.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error when not enough alive nodes to perform restart with clean up.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start additional nodes or restore failed ones before retrying recovery.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-RECOVERY-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error when node names are not in valid set.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check cluster configuration and correct invalid node names.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="embedded-api-exceptions">Embedded API Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-EMBEDDED-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cluster is not yet initialized.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Initialize the cluster before performing operations.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-EMBEDDED-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cluster initialization failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check initialization logs and fix configuration or resource issues.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-EMBEDDED-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Node not started.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Start the node before performing operations.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-EMBEDDED-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Node start failed.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check startup logs and configuration for errors, then retry startup.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="garbage-collector-exceptions">Garbage Collector Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-GC-14</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Garbage collector closed error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restart the node to reinitialize the garbage collector.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="index-exceptions">Index Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-IDX-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to find the specified index.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the index exists.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-IDX-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Specified index already exists.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the index does not exist when creating it.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="marshalling-exceptions">Marshalling Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-MARSHALLING-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Marshalling error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check serialization logic and class compatibility.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-MARSHALLING-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Unsupported object type error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use only supported object types for serialization.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-MARSHALLING-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Unmarshalling error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Verify data format and class versions match between nodes.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="metastorage-exceptions">Metastorage Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to start the underlying key value storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check storage configuration and ensure the storage path is accessible.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to restore the underlying key value storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Verify backup integrity and retry restoration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to compact the underlying key value storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check storage health and retry compaction.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to perform an operation on the underlying key value storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check storage logs and system resources, then retry the operation.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to perform an operation within a specified time period.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check storage logs and system resources, then retry the operation.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to perform a read operation on the underlying key value storage because the revision has already been compacted.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the read with a newer revision.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-META-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to start a node because metastorage has diverged as a result of <a href="/docs/ignite3/latest/administrators-guide/system-groups-recovery#metastorage-group">MG recovery</a>.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Clear the node of data and add it to the cluster as a blank node.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="network-exceptions">Network Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NETWORK-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The node with the specified ID is not in the physical topology.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the error message and node ID. Update node ID if it is incorrect. If the node is offline, check why and bring it back online.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NETWORK-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Port is already in use.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Most likely, Apache Ignite tried to access the port occupied by a different process. Change the port or free it, and then restart the node.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">IGN-NETWORK-3</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">File transfer error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check network connectivity and retry the file transfer.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">IGN-NETWORK-4</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">File validation error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Ensure the file is not corrupted.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NETWORK-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Recipient node has left the physical topology.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the error message. The node is unavailable and need to be brought back into the cluster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NETWORK-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Could not resolve address. Most likely, the IP address specified in the operation is not available locally.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Change the node configuration to make the address available or use a different IP address.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="node-configuration-exceptions">Node Configuration Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NODECFG-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to read configuration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure that the node has access to the configuration file.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NODECFG-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to create a configuration file.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check if the node has write permissions to the folder where configuration is.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NODECFG-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to write configuration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check if the node has write permissions to the folder where configuration is.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NODECFG-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to parse configuration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure the configuration file is correct.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-NODECFG-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Node was unable to pass the validation step.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Fix the invalid or mismatched configuration and retry joining the cluster.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="placement-driver-exceptions">Placement Driver Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-PLACEMENTDRIVER-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Primary replica await timeout error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Increase the timeout.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-PLACEMENTDRIVER-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Primary replica await error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check replica status and cluster connectivity.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-PLACEMENTDRIVER-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error that occurs if there are no assignments for a group.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Ensure replicas are assigned to the group and assign if needed.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="replicator-exceptions">Replicator Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Default error for the replication procedure.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the logs and take action depending on the cause.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica with the same identifier already exists.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica start error. Check the logs for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replication timeout error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Potential causes include prolonged replica startup, network issues, or node failures. Check the logs for error cause. Make sure that every partition group has a majority of nodes online.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The replication level tried to handle an unsupported request.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure there are no nodes having incompatible versions in the cluster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica is not ready to handle the request.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This can be caused by the replica unavailability or the primary replica absence. Check the logs for details related to the replica start issues. If the error is caused by the primary replica absence, make sure that partition groups are operational, check the logs for problems related to primary replica negotiation for the specific replication group.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica is not the current primary replica.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This error indicates that the request was routed to a node that is not the current primary replica lease holder. Retry the operation, as it should automatically redirect to the correct lease holder. If primary replicas are changing frequently, verify that there are no node failures, network issues, or JVM/GC pauses causing primary replica expiration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to close cursor.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">General error, check the logs for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica is already stopping.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replica is being stopped, probably due to the node stop or rebalancing. No action is required unless this behavior is unexpected. Otherwise check the logs for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REP-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Replication group overloaded exception code.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Reduce load or increase resources for the replication group.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="rest-service-exceptions">REST Service Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-REST-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Cluster has not yet been initialized or the node is in the process of stopping.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Initialize the cluster and restart the node.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="sql-exceptions">SQL Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exception is thrown when a query doesn&#8217;t intend to return any rows (for example, a DML or a DDL query).</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Change the request to not expect the result from the query.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exception is thrown when the specified schema cannot be found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure you use the existing schema name.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Statement parsing error. This error is returned when an SQL statement string is not valid according to syntax rules.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message and correct issues in the query.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Statement validation error. Although statement is grammatically correct, the semantic is in question. For example, this can happen when the statement refers to relations that do not exist or describes a prohibited action.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message and correct the query.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Constraint violation error such as primary key violation or NOT NULL.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message and correct the query.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Statement canceled error. Statement is canceled due to timeout, admin action, etc.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message to find out the specific reason.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime error. Errors caused by programming errors in SQL statement itself, such errors happen during statement execution. For example, this can be caused by numeric overflow errors or type conversion errors.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message and fix the issue.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">SQL engine was unable to map query on current cluster topology. This may be due to a variety of reasons, but most probably because of all nodes hosting certain system view or a table partition went offline.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the exception message. In most scenarios, you can rerun the query when the cluster is stable.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-SQL-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Execution of transaction control statement inside an external transaction is forbidden.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Do not use transaction control statements like <code>BEGIN TRANSACTION</code> or <code>COMMIT</code> in external transactions, including JDBC with disabled autocommit mode.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="storage-exceptions">Storage Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-STORAGE-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A disaster has occurred, followed by an attempt to recover from the disaster. This caused inconsistent index state in the cluster metadata.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Wait until the index is rebuilt automatically.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-STORAGE-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A disaster has occurred, which led to data corruption in the persistent storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Restore the data from a backup or introduce a new node instead of the broken one (this may lead to data loss if the replication factor is too low).</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="table-exceptions">Table Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Table already exists.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure to use the table name that does not exist on the cluster.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Table not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the table name and, if necessary, create it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Column already exists.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Make sure to use the column name that does not exist in the table.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Column not found.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Check the column name and, if necessary, create it.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Schema version mismatch.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The request uses a different schema than the table.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TBL-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Partition type not supported.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Use a supported partition type.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="sect1">
<h2 id="transactions-exceptions">Transactions Exceptions</h2>
<div class="sectionbody">
<table class="tableblock frame-all grid-all stripes-even stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Exception Code</th>
<th class="tableblock halign-left valign-top">Description</th>
<th class="tableblock halign-left valign-top">Recommended Action</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-1</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Default error for transaction state storage.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">General error, check the logs and take action depending on the cause. Make sure there are no disk errors.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-2</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Storage is stopped.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Storage is stopped due to the node stop or replica stop. No action is required unless this behavior is unexpected. Otherwise check the log for details.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-3</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Unexpected transaction state on state change.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This can happen when trying to commit an already aborted transaction or roll back a committed one. No action is required.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-4</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to acquire a lock on a key due to a conflict.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The lock is held by another transaction. Retry the operation or change the deadlock prevention policy.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-5</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to acquire a lock on a key within the timeout.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The lock is held by another transaction. Make sure that the other transaction is not hanging, kill it if necessary; or retry the operation.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-6</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to commit a transaction.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Take actions depending on the cause. Make sure that all partitions in the cluster have a majority of nodes online in their groups.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-7</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to roll back a transaction.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Take actions depending on the cause. Make sure that all partitions in the cluster have a majority of nodes online in their groups.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-8</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to put read-write operation into read-only transaction.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The read-write operations within read-only transactions are not possible.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-9</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transaction state storage rebalancing error.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Fix the cause of the rebalancing error, make sure there are no disk errors.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-10</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failed to create a read-only transaction with a timestamp older than the data available in the tables.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the transaction with newer read timestamp. Increase data availability time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-11</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failure due to an incompatible schema change.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The transaction tried to access data within incompatible schema. Retry the transaction.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-12</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failure due to primary replica expiration.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the transaction. Make sure there are no node failures, network issues or JVM/GC pauses that can cause the primary replica expiration.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-13</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transaction already finished.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">This can be caused by any operation within a finished (committed or aborted) transaction. Doesn&#8217;t require any specific action.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-14</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Failure due to a stale operation of a completed transaction.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error that occurs when a stale operation of a transaction is detected. Try to rerun the transaction, if necessary.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-15</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Error occurred when trying to execute an operation in a read-only transaction on a node that has already destroyed data for read timestamp of the transaction.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Retry the transaction with newer read timestamp. Increase data availability time.</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IGN-TX-16</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Operation failed because the transaction is already finished with timeout.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Verify transaction timeout settings and ensure operations are executed before the transaction expires.</p></td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="copyright">
© 2025 The Apache Software Foundation.<br/>
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.
</div>
</article>
<nav class="right-nav" data-swiftype-index='false'>
<div class="toc-wrapper">
<ul class="sectlevel1">
<li><a href="#finding-stack-trace-information">Finding Stack Trace Information</a></li>
<li><a href="#authentication-exceptions">Authentication Exceptions</a></li>
<li><a href="#catalog-exceptions">Catalog Exceptions</a></li>
<li><a href="#client-exceptions">Client Exceptions</a></li>
<li><a href="#code-deployment-exceptions">Code Deployment Exceptions</a></li>
<li><a href="#common-configuration-exceptions">Common Configuration Exceptions</a></li>
<li><a href="#common-exceptions">Common Exceptions</a></li>
<li><a href="#compute-exceptions">Compute Exceptions</a></li>
<li><a href="#critical-workers-exceptions">Critical Workers Exceptions</a></li>
<li><a href="#distribution-zone-exceptions">Distribution Zone Exceptions</a></li>
<li><a href="#disaster-recovery-exceptions">Disaster Recovery Exceptions</a></li>
<li><a href="#embedded-api-exceptions">Embedded API Exceptions</a></li>
<li><a href="#garbage-collector-exceptions">Garbage Collector Exceptions</a></li>
<li><a href="#index-exceptions">Index Exceptions</a></li>
<li><a href="#marshalling-exceptions">Marshalling Exceptions</a></li>
<li><a href="#metastorage-exceptions">Metastorage Exceptions</a></li>
<li><a href="#network-exceptions">Network Exceptions</a></li>
<li><a href="#node-configuration-exceptions">Node Configuration Exceptions</a></li>
<li><a href="#placement-driver-exceptions">Placement Driver Exceptions</a></li>
<li><a href="#replicator-exceptions">Replicator Exceptions</a></li>
<li><a href="#rest-service-exceptions">REST Service Exceptions</a></li>
<li><a href="#sql-exceptions">SQL Exceptions</a></li>
<li><a href="#storage-exceptions">Storage Exceptions</a></li>
<li><a href="#table-exceptions">Table Exceptions</a></li>
<li><a href="#transactions-exceptions">Transactions Exceptions</a></li>
</ul>
</div>
<nav class="promo-nav">
<!--#include virtual="/includes/docs_rightnav_promotion.html" -->
<!--a href="#" data-trigger-bugyard-feedback="true" id="doc-feedback-btn">Docs Feedback</a-->
</nav>
</nav>
</section>
<script type='module' src='/assets/js/code-copy-to-clipboard.js' async crossorigin></script>
<script>
// inits deep anchors -- needs to be done here because of https://www.bryanbraun.com/anchorjs/#dont-run-it-too-late
anchors.add('.page-docs h1, .page-docs h2, .page-docs h3:not(.discrete), .page-docs h4, .page-docs h5');
anchors.options = {
placement: 'right',
visible: 'always'
};
</script>
<script type='module' src='/assets/js/index.js?1763137387' async crossorigin></script>
<script type='module' src='/assets/js/versioning.js?1763137387' async crossorigin></script>
<script type='module' src='/assets/js/railroad-diagram.js?1763137387' async></script>
<script type='module' src='/assets/js/search.js?1763137387' defer crossorigin></script>
<link rel="stylesheet" href="/assets/css/styles.css?1763137387" media="print" onload="this.media='all'">
<noscript><link media="all" rel="stylesheet" href="/assets/css/styles.css?1763137387"></noscript>
<link rel="stylesheet" href="/assets/css/docsearch.min.css" media="print" onload="this.media='all'">
<noscript><link media="all" rel="stylesheet" href="/assets/css/docsearch.min.css"></noscript>
</body>
</html>