pgadmin4/docs/en_US/create_extension.rst
2016-05-13 14:43:57 +01:00

50 lines
2.1 KiB
ReStructuredText

.. _create_extension:
*******************
Create - Extension
*******************
Use the *Create - Extension* dialog to install a new extension into the current database. Each extension must have a unique name. Before you can use CREATE EXTENSION to load an extension into a database, the extension's supporting files must be installed.
The *Create - Extension* dialog allows you to implement options of the CREATE EXTENSION command through the following dialog tabs: *General* and *Definition*. The *SQL* tab displays the SQL code generated by dialog selections.
For more information about creating extensions, please see the PostgreSQL core documentation available at:
http://www.postgresql.org/docs/9.5/static/sql-createextension.html
http://www.postgresql.org/docs/current/static/extend-extensions.html
.. image:: images/create_extension_general.png
Use the fields in the *General* tab to identify an extension:
* Use the drop-down listbox in the *Name* field to select the extension.
Click the *Definition* tab to continue.
.. image:: images/create_extension_definition.png
Use the *Definition* tab to select the *Schema* and *Version*:
* Use the drop-down listbox next to *Schema* to select the name of the schema in which to install the extension's objects.
* Use the drop-down listbox next to *Version* to select the version of the extension to install.
Click the *SQL* tab to continue.
.. image:: images/create_extension_sql.png
Your entries in the *Create - Extension* dialog generate a SQL command; you can review the command on the *SQL* pane.
* Click the *Info* button (i) to access online help.
* Click the *Save* button to save work.
* Click the *Cancel* button to exit without saving work.
* Click the *Reset* button to restore configuration parameters.
Example
=======
The following is an example of the sql command generated by user selections in the *Create - Extension* dialog:
.. image:: images/create_extension_sql_example.png
The command creates the *adminpack* extension in the *pg_catalog* schema. It is version *1.0* of *adminpack*.