> ## 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.

# gpudbworkerlist

> gpudbworkerlist — Kinetica Python API

<div className="kinetica-pydoc">
  <div itemprop="articleBody">
    <div id="class-gpudbworkerlist" className="section">
      <h1>Class GPUdbWorkerList</h1>

      <div className="dl py class">
        <div className="dt sig sig-object py" id="gpudb_multihead_io.GPUdbWorkerList"> <span className="em property"><span className="k"><span className="pre">class</span></span><span className="w"> </span></span><span className="sig-prename descclassname"><span className="pre">gpudb\_multihead\_io.</span></span><span className="sig-name descname"><span className="pre">GPUdbWorkerList</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">gpudb</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">ip\_regex</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">None</span></span></span>, <span className="em sig-param"><span className="n"><span className="pre">use\_head\_node\_only</span></span><span className="o"><span className="pre">=</span></span><span className="default_value"><span className="pre">False</span></span></span><span className="sig-paren">)</span></div>

        <div className="dd">
          <p>A list of worker URLs to use for multi-head ingest.</p>
          <p>Automatically populates the <a className="reference internal" href="#gpudb_multihead_io.GPUdbWorkerList" title="gpudb_multihead_io.GPUdbWorkerList"><code className="xref py py-class docutils literal notranslate"><span className="pre">GPUdbWorkerList</span></code></a> object with the worker URLs for the GPUdb server to support multi-head ingest. (If the specified GPUdb instance has multi-head ingest disabled, the worker list will have the head node URL only and multi-head ingest will not be used.)</p>
          <p>Note that in some cases, workers may be configured to use more than one IP address, not all of which may be accessible to the client; this constructor uses the first IP returned by the server for each worker.</p>
          <p><strong>Parameters</strong></p>

          <blockquote>
            <div>
              <div className="dl simple">
                <div className="dt">gpudb (<a className="reference internal" href="/content/api/python/source/gpudb#gpudb.GPUdb" title="gpudb.GPUdb"><code className="xref py py-class docutils literal notranslate"><span className="pre">gpudb.GPUdb</span></code></a>) –</div>

                <div className="dd">
                  <p>The <a className="reference internal" href="/content/api/python/source/gpudb#gpudb.GPUdb" title="gpudb.GPUdb"><code className="xref py py-class docutils literal notranslate"><span className="pre">gpudb.GPUdb</span></code></a> client handle from which to obtain the worker URLs.</p>
                </div>

                <div className="dt">ip\_regex (<span className="em">str</span>) –</div>

                <div className="dd">
                  <p>Optional IP regular expression to match for the worker URLs.</p>
                </div>

                <div className="dt">use\_head\_node\_only (<span className="em">bool</span>) –</div>

                <div className="dd">
                  <p>Optional boolean flag indicating that only head node should be used (for whatever reason), instead of the workers utilizing the multi-head feature.</p>
                </div>
              </div>
            </div>
          </blockquote>

          <div className="dl py method">
            <div className="dt sig sig-object py" id="gpudb_multihead_io.GPUdbWorkerList.validate_ip_address"> <span className="sig-name descname"><span className="pre">validate\_ip\_address</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">ip\_address</span></span></span><span className="sig-paren">)</span></div>

            <div className="dd">
              <p>Validates the input string as an IP address (accepts IPv4 only).</p>
              <p><strong>Parameters</strong></p>

              <blockquote>
                <div>
                  <p>ip\_address String that needs to be validated.</p>
                </div>
              </blockquote>

              <p>Returns: true or false.</p>
            </div>
          </div>

          <div className="dl py method">
            <div className="dt sig sig-object py" id="gpudb_multihead_io.GPUdbWorkerList.get_worker_urls"> <span className="sig-name descname"><span className="pre">get\_worker\_urls</span></span><span className="sig-paren">(</span><span className="sig-paren">)</span></div>

            <div className="dd">
              <p>Returns a list of the URLs for the GPUdb workers.</p>
            </div>
          </div>

          <div className="dl py method">
            <div className="dt sig sig-object py" id="gpudb_multihead_io.GPUdbWorkerList.is_multihead_enabled"> <span className="sig-name descname"><span className="pre">is\_multihead\_enabled</span></span><span className="sig-paren">(</span><span className="sig-paren">)</span></div>

            <div className="dd">
              <p>Returns whether multi-head I/O is enabled at the server.</p>
            </div>
          </div>

          <div className="dl py method">
            <div className="dt sig sig-object py" id="gpudb_multihead_io.GPUdbWorkerList.get_ip_regex"> <span className="sig-name descname"><span className="pre">get\_ip\_regex</span></span><span className="sig-paren">(</span><span className="sig-paren">)</span></div>

            <div className="dd">
              <p>Returns the IP regex, if any, used to create the worker list.</p>
            </div>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>