Tool: PQ Lifecycle Operations

[chipkent]

PQ Lifecycle Operations:

• ControllerClient.add_query(config) - Create new persistent query
• ControllerClient.delete_query(serials) - Delete persistent queries
• ControllerClient.modify_query(config, restart) - Modify PQ configuration
• ControllerClient.restart_query(serials) - Restart one or more PQs
• ControllerClient.stop_query(serials) - Stop running PQs
• ControllerClient.start_and_wait(serial, timeout) - Start PQ and wait for ready state
• ControllerClient.stop_and_wait(serial, timeout) - Stop PQ and wait for terminal state

[chipkent]

These may be needed:

PQ Configuration Generation:

• ControllerClient.make_temporary_config(...) - Create temporary InteractiveConsole query config
  Parameters: name, heap_size_gb, server, extra_jvm_args, extra_environment_vars, engine, auto_delete_timeout, admin_groups, viewer_groups
• ControllerClient.generate_disabled_scheduler() - Generate disabled scheduler config

[chipkent]

Persistent Query Management (Critical for Enterprise)
Essential PQ Operations (Add these 8 tools)
pq_list - List all persistent queries with status

Maps to: ControllerClient.subscribe() + ControllerClient.map()
Returns: List of PQ serials, names, states, heap sizes, owners
pq_details - Get detailed PQ information

Maps to: ControllerClient.get(serial)
Returns: Full PQ configuration and state
pq_create - Create new persistent query

Maps to: ControllerClient.add_query(config)
Parameters: name, heap_size_gb, engine, jvm_args, env_vars, auto_delete_timeout, admin_groups, viewer_groups
pq_delete - Delete persistent query(s)

Maps to: ControllerClient.delete_query(serials)
pq_start - Start persistent query

Maps to: ControllerClient.start_and_wait(serial, timeout)
pq_stop - Stop persistent query

Maps to: ControllerClient.stop_and_wait(serial, timeout)
pq_restart - Restart persistent query

Maps to: ControllerClient.restart_query(serials)
pq_modify - Modify PQ configuration

Maps to: ControllerClient.modify_query(config, restart)
Parameters: serial, new config, whether to restart
Impact: Enables full PQ lifecycle management via MCP