> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# kill_proc

<div className="kinetica-pydoc">
  <div className="dl py method">
    <div className="dt sig sig-object py" id="gpudb.GPUdb.kill_proc"> <span className="sig-name descname"><span className="pre">kill\_proc</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">run\_id</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">''</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">options</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">{"{"}{"}"}</span></span></span><span className="sig-paren">)</span><a href="https://github.com/kineticadb/kinetica-api-python/blob/master/gpudb/gpudb.py#L36015"><span className="viewcode-link"><span className="pre">\[source]</span></span></a></div>

    <div className="dd">
      <p>Kills a running proc instance.</p>
      <p><strong>Parameters</strong></p>

      <div className="blockquote">
        <div>
          <div className="dl">
            <div className="dt">run\_id (<span className="em">str</span>) –</div>

            <div className="dd">
              <p>The run ID of a running proc instance. If a proc with a matching run ID is not found or the proc instance has already completed, no procs will be killed. If not specified, all running proc instances will be killed. The default value is ‘’.</p>
            </div>

            <div className="dt">options (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Optional parameters. Allowed keys are:</p>

              <ul>
                <li>
                  <p><strong>run\_tag</strong> – If input parameter <span className="em">run\_id</span> is specified, kill the proc instance that has a matching run ID and a matching run tag that was provided to <a className="reference internal" href="#gpudb.GPUdb.execute_proc" title="gpudb.GPUdb.execute_proc"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.execute\_proc()</span></code></a>. If input parameter <span className="em">run\_id</span> is not specified, kill the proc instance(s) where a matching run tag was provided to <a className="reference internal" href="#gpudb.GPUdb.execute_proc" title="gpudb.GPUdb.execute_proc"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.execute\_proc()</span></code></a>. The default value is ‘’.</p>
                </li>

                <li>
                  <p><strong>clear\_execute\_at\_startup</strong> – If <span className="em">true</span>, kill and remove the instance of the proc matching the auto-start run ID that was created to run when the database is started. The auto-start run ID was returned from <a className="reference internal" href="#gpudb.GPUdb.execute_proc" title="gpudb.GPUdb.execute_proc"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.execute\_proc()</span></code></a> and can be retrieved using <a className="reference internal" href="#gpudb.GPUdb.show_proc" title="gpudb.GPUdb.show_proc"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.show\_proc()</span></code></a>. Allowed values are:</p>

                  <ul className="simple">
                    <li>
                      <p>true</p>
                    </li>

                    <li>
                      <p>false</p>
                    </li>
                  </ul>

                  <p>The default value is ‘false’.</p>
                </li>
              </ul>

              <p>The default value is an empty dict ( {"{"}{"}"} ).</p>
            </div>
          </div>
        </div>
      </div>

      <p><strong>Returns</strong></p>

      <div className="blockquote">
        <div>
          <p>A dict with the following entries–</p>

          <div className="dl simple">
            <div className="dt">run\_ids (<span className="em">list of str</span>) –</div>

            <div className="dd">
              <p>List of run IDs of proc instances that were killed.</p>
            </div>

            <div className="dt">info (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Additional information.</p>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>