ALTER TOOL Statement in Confluent Cloud for Apache Flink

Modify an existing tool’s configuration. Use the CREATE TOOL statement to create a tool.

Syntax

ALTER TOOL [IF EXISTS] [catalog.][database.]tool_name
SET (key1=val1[,key=val]*)

Description

Modify an existing tool’s configuration. You can rename the tool, update its options, or reset specific options to their defaults.

Operations

Rename Tool

Rename a tool to a new name:

ALTER TOOL old_tool_name RENAME TO new_tool_name;

Set Options

Update tool options:

ALTER TOOL tool_name SET (
  'description' = 'Updated tool description',
  'request_timeout' = '60'
);

Parameters

  • IF EXISTS (Optional): Do not throw an error if the tool does not exist
  • catalog.database (STRING, Optional): Optional catalog and database name
  • tool_name (STRING): Name of the tool to modify
  • tool_name1 (STRING): New name for the tool (RENAME operation)
  • key1=val1 (STRING): Key-value pairs for option updates (SET operation)
  • key1 (STRING): Option names to reset (RESET operation)

Example

Update tool options:

ALTER TOOL mcp_server SET (
  'description' = 'Updated MCP server for weather data',
  'request_timeout' = '120'
);