pgadmin4/docs/en_US/schema_dialog.rst

62 lines
2.9 KiB
ReStructuredText
Raw Normal View History

2016-05-20 20:39:21 +00:00
*************
Schema Dialog
*************
2016-05-13 13:43:57 +00:00
2016-05-20 20:39:21 +00:00
Use the *Schema* dialog to define a schema. A schema is the organizational workhorse of a database, similar to directories or namespaces. To create a schema, you must be a database superuser or have the CREATE privilege.
2016-05-13 13:43:57 +00:00
2016-05-20 20:39:21 +00:00
The *Schema* dialog allows you to implement options of the CREATE SCHEMA command. For more information about the CREATE SCHEMA command, please see:
2016-05-13 13:43:57 +00:00
http://www.postgresql.org/docs/current/static/sql-createschema.html
2016-05-20 20:39:21 +00:00
The *Schema* dialog organizes the development of schema through the following dialog tabs: *General* and *Security*. The *SQL* tab displays the SQL code generated by dialog selections.
2016-05-13 13:43:57 +00:00
2016-05-20 20:39:21 +00:00
.. image:: images/schema_general.png
2016-05-13 13:43:57 +00:00
Use the fields on the *General* tab to identify the schema.
* Use the *Name* field to add a descriptive name for the schema.
* Select the owner of the schema from the drop-down listbox in the *Owner* field.
* Store notes about the schema in the *Comments* field.
Click the *Security* tab to continue.
2016-05-20 20:39:21 +00:00
.. image:: images/schema_security.png
2016-05-13 13:43:57 +00:00
Use the *Security* tab to assign privileges and security labels for the schema.
Click *Add* to assign a set of privileges in the *Privileges* panel:
* Select the name of the role from the drop-down listbox in the *Grantee* field.
* Click inside the *Privileges* field. Check the boxes to the left of one or more privileges to grant the selected privileges to the specified user.
* Select the name of the role that is granting the privilege from the drop-down listbox in the *Grantor* field. The default grantor is the owner of the schema.
To discard a privilege, click the trash icon to the left of the row and confirm deletion in the *Delete Row* popup.
Click *Add* to assign a security label in the *Security Labels* panel:
* Specify a security label provider in the *Provider* field. The named provider must be loaded and must consent to the proposed labeling operation.
* Specify a a security label in the *Security Label* field. The meaning of a given label is at the discretion of the label provider. PostgreSQL places no restrictions on whether or how a label provider must interpret security labels; it merely provides a mechanism for storing them.
To discard a security label, click the trash icon to the left of the row and confirm deletion in the *Delete Row* popup.
Click the *SQL* tab to continue.
2016-05-20 20:39:21 +00:00
.. image:: images/schema_sql.png
2016-05-13 13:43:57 +00:00
2016-05-20 20:39:21 +00:00
Your entries in the *Schema* dialog generate a SQL command; you can review the command on the *SQL* pane.
2016-05-13 13:43:57 +00:00
* 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
=======
2016-05-20 20:39:21 +00:00
The following is an example of the sql command generated by selections made in the *Schema dialog*:
2016-05-13 13:43:57 +00:00
2016-05-20 20:39:21 +00:00
.. image:: images/schema_sql_example.png
2016-05-13 13:43:57 +00:00
The example creates a schema named hr; the command grants *USAGE* privileges to *public*.