RELOAD PLUGIN

Enterprise

Plugins are developed against the open-source questdb library and run only on QuestDB Enterprise.

Learn more

Unloads and immediately reloads a plugin in a single operation. Requires PLUGIN ADMIN permission.

Syntax

RELOAD PLUGIN plugin_name;
  • plugin_name — the JAR filename, with or without the .jar extension. May be quoted or unquoted.

Description

RELOAD PLUGIN is equivalent to UNLOAD PLUGIN followed by LOAD PLUGIN, but expressed as a single command. The same dependency and PLUGIN ADMIN permission checks apply. The compiled query cache is flushed twice — once after unload, once after load.

If the reload fails during the load phase (for example because a dependency is missing or the onLoad callback throws), the plugin is left in an unloaded state. The error message indicates the original cause.

Use RELOAD PLUGIN to pick up an updated JAR without needing two commands. The JAR file on disk is re-read on every load, so replacing the file and running RELOAD PLUGIN is sufficient to apply an update.

Example

Reload a plugin after updating its JAR
RELOAD PLUGIN 'my-plugin-1.0.0';

See also