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

# alterTableMonitor

<div className="kinetica-javadoc">
  <ul className="member-list">
    <li>
      <div className="section detail" id="alterTableMonitor(com.gpudb.protocol.AlterTableMonitorRequest)">
        <h3>alterTableMonitor</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorResponse" title="class in com.gpudb.protocol">AlterTableMonitorResponse</a></span> <span className="element-name">alterTableMonitor</span><wbr /><span className="parameters">(<a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest" title="class in com.gpudb.protocol">AlterTableMonitorRequest</a> request)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>
        <div className="block">Alters a table monitor previously created with <a href="#createTableMonitor(com.gpudb.protocol.CreateTableMonitorRequest)"><code>createTableMonitor</code></a>.</div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>request</code> - <a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest" title="class in com.gpudb.protocol"><code>Request</code></a> object containing the parameters for the operation.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>

    <li>
      <div className="section detail" id="alterTableMonitor(java.lang.String,java.util.Map,java.util.Map)">
        <h3>alterTableMonitor</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorResponse" title="class in com.gpudb.protocol">AlterTableMonitorResponse</a></span> <span className="element-name">alterTableMonitor</span><wbr /><span className="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> topicId, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link">Map</a>\<<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>,<wbr /><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>> monitorUpdatesMap, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link">Map</a>\<<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>,<wbr /><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>> options)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>
        <div className="block">Alters a table monitor previously created with <a href="#createTableMonitor(java.lang.String,java.util.Map)"><code>createTableMonitor</code></a>.</div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>topicId</code> - The topic ID returned by <a href="#createTableMonitor(java.lang.String,java.util.Map)"><code>createTableMonitor</code></a>.</div>

          <div className="dd">
            <code>monitorUpdatesMap</code> - Map containing the properties of the table monitor to be updated. Error if empty.

            <ul>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a>: Updates the schema name. If <a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> doesn't exist, an error will be thrown. If <a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#SCHEMA_NAME"><code>SCHEMA\_NAME</code></a> is empty, then the user's default schema will be used. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#MAX_CONSECUTIVE_FAILURES"><code>MAX\_CONSECUTIVE\_FAILURES</code></a>: 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. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#NOTIFICATIONS"><code>NOTIFICATIONS</code></a>: Updates the state of the monitor. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#RESUME"><code>RESUME</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorRequest.MonitorUpdatesMap#SUSPEND"><code>SUSPEND</code></a> </li>
                </ul>

                The default value is an empty <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link"><code>Map</code></a>.
              </li>
            </ul>
          </div>

          <div className="dd"><code>options</code> - Optional parameters. The default value is an empty <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link"><code>Map</code></a>.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/AlterTableMonitorResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>
  </ul>
</div>