Documentation Home
MySQL 9.2 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 40.8Mb
PDF (A4) - 40.9Mb
Man Pages (TGZ) - 259.7Kb
Man Pages (Zip) - 366.9Kb
Info (Gzip) - 4.1Mb
Info (Zip) - 4.1Mb


MySQL 9.2 Reference Manual  / ...  / MySQL Server Administration  / MySQL Components  /  Installing and Uninstalling Components

7.5.1 Installing and Uninstalling Components

Components must be loaded into the server before they can be used. MySQL supports manual component loading at runtime and automatic loading during server startup.

While a component is loaded, information about it is available as described inSection 7.5.2, “Obtaining Component Information”.

TheINSTALL COMPONENT andUNINSTALL COMPONENT SQL statements enable component loading and unloading. For example:

INSTALL COMPONENT 'file://component_validate_password';UNINSTALL COMPONENT 'file://component_validate_password';

A loader service handles component loading and unloading, and also registers loaded components in themysql.component system table.

The SQL statements for component manipulation affect server operation and themysql.component system table as follows:

  • INSTALL COMPONENT loads components into the server. The components become active immediately. The loader service also registers loaded components in themysql.component system table. For subsequent server restarts, the loader service loads any components listed inmysql.component during the startup sequence. This occurs even if the server is started with the--skip-grant-tables option. The optionalSET clause permits setting component system-variable values when you install components.

  • UNINSTALL COMPONENT deactivates components and unloads them from the server. The loader service also unregisters the components from themysql.component system table so that the server no longer loads them during its startup sequence for subsequent restarts.

Compared to the correspondingINSTALL PLUGIN statement for server plugins, theINSTALL COMPONENT statement for components offers the significant advantage that it is not necessary to know any platform-specific file name suffix for naming the component. This means that a givenINSTALL COMPONENT statement can be executed uniformly across platforms.

A component when installed may also automatically install related loadable functions. If so, the component when uninstalled also automatically uninstalls those functions.