Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
87 changes: 87 additions & 0 deletions docs/en_US/directory_dialog.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
.. _directory_dialog:

*************************
`Directory Dialog`:index:
*************************

Use the Directory dialog to Create an alias for a file system directory path.
To create directories, you must have the CREATE ANY DIRECTORY system privilege.
When you create a directory, you are automatically granted READ and WRITE privileges
on the directory, and you can grant READ and WRITE privileges to other users and roles.
The superuser can also grant these privileges to other users and roles.

Please note that directories are supported when connected to EDB Postgres Advanced Server.
For more information about using directories, please see the EDB Postgres Advanced Server Guide, available at:

https://www.enterprisedb.com/docs/epas/latest/epas_compat_sql/


The *Directory* dialog organizes the definition of a directory through the
following tabs: *General*, *Definition*, *Security*, and *SQL*.
The *SQL* tab displays the SQL code generated by dialog selections.

.. image:: images/directory_general.png
:alt: Directory general tab
:align: center

Use the fields on the *General* tab to specify directory attributes:

* Use the *Name* field to add a directory alias name. This name will be displayed in the object explorer.
* Select the owner of the directory from the drop-down listbox in the *Owner*
field.

Click the *Definition* tab to continue.

.. image:: images/directory_definition.png
:alt: Directory dialog definition tab
:align: center

* Use the *Location* field to specify a fully qualified directory path represented
by the alias name. The CREATE DIRECTORY command doesn't create the operating system directory.
The physical directory must be created independently using operating system commands.

Click the *Security* tab to continue.

.. image:: images/directory_security.png
:alt: Directory dialog security tab
:align: center

NOTE:- This *Security* tab will be only available for EPAS 17.

Use the *Security* tab to assign privileges for the directory.

Use the *Privileges* panel to assign security privileges. Click the *Add* icon
(+) to assign a set of privileges:

* Select the name of the role from the drop-down listbox in the *Grantee* field.
* The current user, who is the default grantor for granting the privilege, is displayed in the *Grantor* 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.

Click the *Add* icon to assign additional sets of privileges; to discard a
privilege, click the trash icon to the left of the row and confirm deletion in
the *Delete Row* popup.

Click the *SQL* tab to continue.

Your entries in the *Directory* dialog generate a SQL command (see an example
below). Use the *SQL* tab for review; revisit or switch tabs to make any changes
to the SQL command.

Example
*******

The following is an example of the sql command generated by user selections in
the *Directory* dialog:

.. image:: images/directory_sql.png
:alt: Directory dialog sql tab
:align: center

The example shown demonstrates creating a directory named *test1*. It has a
*location* value equal to */home/test_dir*.

* Click the *Info* button (i) to access online help.
* Click the *Save* button to save work.
* Click the *Close* button to exit without saving work.
* Click the *Reset* button to restore configuration parameters.
Binary file added docs/en_US/images/directory_definition.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en_US/images/directory_general.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en_US/images/directory_security.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/en_US/images/directory_sql.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 2 additions & 1 deletion docs/en_US/managing_cluster_objects.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,4 +20,5 @@ database, right-click on the *Databases* node, and select *Create Database...*
tablespace_dialog
replica_nodes_dialog
pgd_replication_group_dialog
role_reassign_dialog
role_reassign_dialog
directory_dialog
2 changes: 1 addition & 1 deletion docs/en_US/resource_group_dialog.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ connected to EDB Postgres Advanced Server; for more information about using
resource groups, please see the EDB Postgres Advanced Server Guide, available
at:

http://www.enterprisedb.com/
https://www.enterprisedb.com/docs/epas/latest/epas_compat_sql/

Fields used to create a resource group are located on the *General* tab. The
*SQL* tab displays the SQL code generated by your selections on the *Resource
Expand Down
3 changes: 3 additions & 0 deletions web/pgadmin/browser/server_groups/servers/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -331,6 +331,9 @@ def register(self, app, options):
from .tablespaces import blueprint as module
self.submodules.append(module)

from .directories import blueprint as module
self.submodules.append(module)

from .replica_nodes import blueprint as module
self.submodules.append(module)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Identity columns are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Identity columns are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"description": "Create Table API Test",
Expand Down Expand Up @@ -111,7 +111,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 110000,
"skip_msg": "Hash Partition are not supported by PPAS/PG 11.0 and below."
"skip_msg": "Hash Partition are not supported by EPAS/PG 11.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -150,7 +150,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -204,7 +204,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -241,7 +241,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -297,7 +297,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 110000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -344,7 +344,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -383,7 +383,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"is_partitioned": true,
Expand Down Expand Up @@ -434,7 +434,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Identity columns are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Identity columns are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"table_name": "abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrstuvwxyz123",
Expand Down Expand Up @@ -493,7 +493,7 @@
"is_positive_test": false,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Identity columns are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Identity columns are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"table_name": "",
Expand Down Expand Up @@ -553,7 +553,7 @@
"is_positive_test": false,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Identity columns are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Identity columns are not supported by EPAS/PG 10.0 and below."
},
"test_data": {
"description": "Create Table API Test",
Expand Down Expand Up @@ -1164,7 +1164,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "range",
"mode": "create"
},
Expand All @@ -1184,7 +1184,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "range",
"mode": "multilevel"
},
Expand All @@ -1204,7 +1204,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "list",
"mode": "create"
},
Expand All @@ -1224,7 +1224,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "list",
"mode": "multilevel"
},
Expand All @@ -1244,7 +1244,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "range",
"mode": "detach"
},
Expand All @@ -1264,7 +1264,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "list",
"mode": "detach"
},
Expand All @@ -1284,7 +1284,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "range",
"mode": "attach"
},
Expand All @@ -1304,7 +1304,7 @@
"inventory_data": {
"is_partition": true,
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below.",
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below.",
"partition_type": "list",
"mode": "attach"
},
Expand Down Expand Up @@ -2145,7 +2145,7 @@
"is_positive_test": true,
"inventory_data": {
"server_min_version": 100000,
"skip_msg": "Partitioned table are not supported by PPAS/PG 10.0 and below."
"skip_msg": "Partitioned table are not supported by EPAS/PG 10.0 and below."
},
"test_data": {},
"mocking_required": false,
Expand Down
Loading
Loading