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

# alter_table_monitor

<div className="kinetica-pydoc">
  <div className="dl py method">
    <div className="dt sig sig-object py" id="gpudb.GPUdb.alter_table_monitor"> <span className="sig-name descname"><span className="pre">alter\_table\_monitor</span></span><span className="sig-paren">(</span><span className="em sig-param"><span className="n"><span className="pre">topic\_id</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">monitor\_updates\_map</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">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#L20620"><span className="viewcode-link"><span className="pre">\[source]</span></span></a></div>

    <div className="dd">
      <p>Alters a table monitor previously created with <a className="reference internal" href="#gpudb.GPUdb.create_table_monitor" title="gpudb.GPUdb.create_table_monitor"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.create\_table\_monitor()</span></code></a>.</p>
      <p><strong>Parameters</strong></p>

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

            <div className="dd">
              <p>The topic ID returned by <a className="reference internal" href="#gpudb.GPUdb.create_table_monitor" title="gpudb.GPUdb.create_table_monitor"><code className="xref py py-meth docutils literal notranslate"><span className="pre">GPUdb.create\_table\_monitor()</span></code></a>.</p>
            </div>

            <div className="dt">monitor\_updates\_map (<span className="em">dict of str to str</span>) –</div>

            <div className="dd">
              <p>Map containing the properties of the table monitor to be updated. Error if empty. Allowed keys are:</p>

              <ul>
                <li>
                  <p><strong>schema\_name</strong> – Updates the schema name. If <span className="em">schema\_name</span> doesn’t exist, an error will be thrown. If <span className="em">schema\_name</span> is empty, then the user’s default schema will be used.</p>
                </li>

                <li>
                  <p><strong>max\_consecutive\_failures</strong> – Updates the maximum number of consecutive failures before suspending the stream. A value of ‘-1’ to disables auto-suspend. This value is by rank and not overall.</p>
                </li>

                <li>
                  <p><strong>notifications</strong> – Updates the state of the monitor. Allowed values are:</p>

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

                    <li>
                      <p>suspend</p>
                    </li>
                  </ul>

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

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

            <div className="dd">
              <p>Optional parameters. 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">topic\_id (<span className="em">str</span>) –</div>

            <div className="dd">
              <p>Value of input parameter <span className="em">topic\_id</span>.</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>