docs/build/plain-html/topics/impala_runtime_filter_mode.html - impala - Git at Google

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html
   PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

 <meta name="copyright" content="(C) Copyright 2023" />
 <meta name="DC.rights.owner" content="(C) Copyright 2023" />
 <meta name="DC.Type" content="concept" />
 <meta name="DC.Title" content="RUNTIME_FILTER_MODE Query Option (Impala 2.5 or higher only)" />
 <meta name="DC.Relation" scheme="URI" content="../topics/impala_set.html" />
 <meta name="prodname" content="Impala" />
 <meta name="prodname" content="Impala" />
 <meta name="version" content="Impala 3.4.x" />
 <meta name="version" content="Impala 3.4.x" />
 <meta name="DC.Format" content="XHTML" />
 <meta name="DC.Identifier" content="runtime_filter_mode" />
 <link rel="stylesheet" type="text/css" href="../commonltr.css" />
 <title>RUNTIME_FILTER_MODE Query Option (Impala 2.5 or higher only)</title>
 </head>
 <body id="runtime_filter_mode">


   <h1 class="title topictitle1" id="ariaid-title1">RUNTIME_FILTER_MODE Query Option (<span class="keyword">Impala 2.5</span> or higher only)</h1>


   <div class="body conbody">

     <p class="p">

     </p>


     <p class="p">
       The <code class="ph codeph">RUNTIME_FILTER_MODE</code> query option
       adjusts the settings for the runtime filtering feature.
       It turns this feature on and off, and controls how
       extensively the filters are transmitted between hosts.
     </p>


     <p class="p">
       <strong class="ph b">Type:</strong> numeric (0, 1, 2)
       or corresponding mnemonic strings (<code class="ph codeph">OFF</code>, <code class="ph codeph">LOCAL</code>, <code class="ph codeph">GLOBAL</code>).
     </p>


     <p class="p">
       <strong class="ph b">Default:</strong> 2 (equivalent to <code class="ph codeph">GLOBAL</code>); formerly was 1 / <code class="ph codeph">LOCAL</code>, in <span class="keyword">Impala 2.5</span>
     </p>


     <p class="p">
         <strong class="ph b">Added in:</strong> <span class="keyword">Impala 2.5.0</span>
       </p>


     <p class="p">
         <strong class="ph b">Usage notes:</strong>
       </p>


     <p class="p">
       In <span class="keyword">Impala 2.6</span> and higher, the default is <code class="ph codeph">GLOBAL</code>.
       This setting is recommended for a wide variety of workloads, to provide best
       performance with <span class="q">"out of the box"</span> settings.
     </p>


     <p class="p">
       The lowest setting of <code class="ph codeph">LOCAL</code> does a similar level of optimization
       (such as partition pruning) as in earlier Impala releases.
       This setting was the default in <span class="keyword">Impala 2.5</span>,
       to allow for a period of post-upgrade testing for existing workloads.
       This setting is suitable for workloads with non-performance-critical queries,
       or if the coordinator node is under heavy CPU or memory pressure.
     </p>


     <p class="p">
       You might change the setting to <code class="ph codeph">OFF</code> if your workload contains
       many queries involving partitioned tables or joins that do not experience a performance
       increase from the runtime filters feature. If the overhead of producing the runtime filters
       outweighs the performance benefit for queries, you can turn the feature off entirely.
     </p>


     <p class="p">
         <strong class="ph b">Related information:</strong>
       </p>

     <p class="p">
       <a class="xref" href="impala_partitioning.html#partitioning">Partitioning for Impala Tables</a> for details about runtime filtering.
       <a class="xref" href="impala_disable_row_runtime_filtering.html#disable_row_runtime_filtering">DISABLE_ROW_RUNTIME_FILTERING Query Option (Impala 2.5 or higher only)</a>,
       <a class="xref" href="impala_runtime_bloom_filter_size.html#runtime_bloom_filter_size">RUNTIME_BLOOM_FILTER_SIZE Query Option (Impala 2.5 or higher only)</a>,
       <a class="xref" href="impala_runtime_filter_wait_time_ms.html#runtime_filter_wait_time_ms">RUNTIME_FILTER_WAIT_TIME_MS Query Option (Impala 2.5 or higher only)</a>,
       and
       <a class="xref" href="impala_max_num_runtime_filters.html#max_num_runtime_filters">MAX_NUM_RUNTIME_FILTERS Query Option (Impala 2.5 or higher only)</a>
       for tuning options for runtime filtering.
     </p>


   </div>

 <div class="related-links">
 <div class="familylinks">
 <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/impala_set.html">SET Statement</a></div>
 </div>
 </div></body>
 </html>
	<?xml version="1.0" encoding="UTF-8"?>
	<!DOCTYPE html
	PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
	<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

	<meta name="copyright" content="(C) Copyright 2023" />
	<meta name="DC.rights.owner" content="(C) Copyright 2023" />
	<meta name="DC.Type" content="concept" />
	<meta name="DC.Title" content="RUNTIME_FILTER_MODE Query Option (Impala 2.5 or higher only)" />
	<meta name="DC.Relation" scheme="URI" content="../topics/impala_set.html" />
	<meta name="prodname" content="Impala" />
	<meta name="prodname" content="Impala" />
	<meta name="version" content="Impala 3.4.x" />
	<meta name="version" content="Impala 3.4.x" />
	<meta name="DC.Format" content="XHTML" />
	<meta name="DC.Identifier" content="runtime_filter_mode" />
	<link rel="stylesheet" type="text/css" href="../commonltr.css" />
	<title>RUNTIME_FILTER_MODE Query Option (Impala 2.5 or higher only)</title>
	</head>
	<body id="runtime_filter_mode">


	<h1 class="title topictitle1" id="ariaid-title1">RUNTIME_FILTER_MODE Query Option (<span class="keyword">Impala 2.5</span> or higher only)</h1>




	<div class="body conbody">

	<p class="p">

	</p>


	<p class="p">
	The <code class="ph codeph">RUNTIME_FILTER_MODE</code> query option
	adjusts the settings for the runtime filtering feature.
	It turns this feature on and off, and controls how
	extensively the filters are transmitted between hosts.
	</p>


	<p class="p">
	<strong class="ph b">Type:</strong> numeric (0, 1, 2)
	or corresponding mnemonic strings (<code class="ph codeph">OFF</code>, <code class="ph codeph">LOCAL</code>, <code class="ph codeph">GLOBAL</code>).
	</p>


	<p class="p">
	<strong class="ph b">Default:</strong> 2 (equivalent to <code class="ph codeph">GLOBAL</code>); formerly was 1 / <code class="ph codeph">LOCAL</code>, in <span class="keyword">Impala 2.5</span>
	</p>


	<p class="p">
	<strong class="ph b">Added in:</strong> <span class="keyword">Impala 2.5.0</span>
	</p>


	<p class="p">
	<strong class="ph b">Usage notes:</strong>
	</p>


	<p class="p">
	In <span class="keyword">Impala 2.6</span> and higher, the default is <code class="ph codeph">GLOBAL</code>.
	This setting is recommended for a wide variety of workloads, to provide best
	performance with <span class="q">"out of the box"</span> settings.
	</p>


	<p class="p">
	The lowest setting of <code class="ph codeph">LOCAL</code> does a similar level of optimization
	(such as partition pruning) as in earlier Impala releases.
	This setting was the default in <span class="keyword">Impala 2.5</span>,
	to allow for a period of post-upgrade testing for existing workloads.
	This setting is suitable for workloads with non-performance-critical queries,
	or if the coordinator node is under heavy CPU or memory pressure.
	</p>


	<p class="p">
	You might change the setting to <code class="ph codeph">OFF</code> if your workload contains
	many queries involving partitioned tables or joins that do not experience a performance
	increase from the runtime filters feature. If the overhead of producing the runtime filters
	outweighs the performance benefit for queries, you can turn the feature off entirely.
	</p>


	<p class="p">
	<strong class="ph b">Related information:</strong>
	</p>

	<p class="p">
	<a class="xref" href="impala_partitioning.html#partitioning">Partitioning for Impala Tables</a> for details about runtime filtering.
	<a class="xref" href="impala_disable_row_runtime_filtering.html#disable_row_runtime_filtering">DISABLE_ROW_RUNTIME_FILTERING Query Option (Impala 2.5 or higher only)</a>,
	<a class="xref" href="impala_runtime_bloom_filter_size.html#runtime_bloom_filter_size">RUNTIME_BLOOM_FILTER_SIZE Query Option (Impala 2.5 or higher only)</a>,
	<a class="xref" href="impala_runtime_filter_wait_time_ms.html#runtime_filter_wait_time_ms">RUNTIME_FILTER_WAIT_TIME_MS Query Option (Impala 2.5 or higher only)</a>,
	and
	<a class="xref" href="impala_max_num_runtime_filters.html#max_num_runtime_filters">MAX_NUM_RUNTIME_FILTERS Query Option (Impala 2.5 or higher only)</a>
	for tuning options for runtime filtering.
	</p>


	</div>

	<div class="related-links">
	<div class="familylinks">
	<div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="../topics/impala_set.html">SET Statement</a></div>
	</div>
	</div></body>
	</html>