Installing and Uninstalling a Plugin Using SQL Commands

Creating a Plugin

Connect to the database where a plugin needs to be created as user root and run the following SQL statements:

select control_extension('create','<EXTENSION_NAME>', '<SCHEMA>');

• EXTENSION_NAME indicates the plugin name. For more information, see Supported Plugins.
• SCHEMA indicates the name of the schema where the plugin is created. If this parameter is not specified, the public schema is used by default.

Example:

-- Specify the public schema for creating the plugin.
select control_extension('create','postgis', 'public');
       control_extension       
 ------------------------------
  create postgis successfully.
 (1 row)
-- If the schema parameter is not specified, the default schema is public.
select control_extension('create', 'postgis');
      control_extension       
------------------------------
 create postgis successfully.
(1 row)

Deleting a Plugin

Connect to the database where a plugin needs to be created as user root and run the following SQL statements:

select control_extension('drop','<EXTENSION_NAME>', '<SCHEMA>');

• EXTENSION_NAME indicates the plugin name. For more information, see Supported Plugins.
• SCHEMA indicates the schema name. This parameter does not matter much when you delete a plugin, so you do not need to specify this parameter.

Example:

select control_extension('drop','postgis');
      control_extension      
 ----------------------------
  drop postgis successfully.
 (1 row)

Common Errors

• Error 1

  ERROR:  permission denied for function control_extension

  Solution: Use root to run the control_extension function.

• Error 2

  ERROR:  function control_extension(unknown, unknown) is not unique

  Solution: Add the schema parameter in the function. If the schema is not specified, there may be functions with the same name, causing execution failures.

• Error 3

  ERROR:  function control_extension(unknown, unknown) does not exist

  Solution: Do not create plugins in the postgres database. The control_extension function does not exist in the postgres database because this database is used as an O&M database.