GRANT privilege [, ...] ON object [, ...] TO { PUBLIC | GROUP group | username }
The possible privileges are:
Access all of the columns of a specific table/view.
Insert data into all columns of a specific table.
Update all columns of a specific table.
Delete rows from a specific table.
Define rules on the table/view (See CREATE RULE statement).
Grant all privileges.
The name of an object to which to grant access. The possible objects are:
table
view
sequence
index
A short form representing all users.
A group to whom to grant privileges. In the current release, the group must be created explicitly as described below.
The name of a user to whom grant privileges. PUBLIC is a short form representing all users.
Message returned if successful.
Message returned if the specified object is not available or if it is impossible to give privileges to the specified group or users.
GRANT allows the creator of an object to give specific permissions to all users (PUBLIC) or to a certain user or group. Users other than the creator don't have any access permission unless the creator GRANTs permissions, after the object is created.
Once a user has a privilege on an object, he is enabled to exercise that privilege. There is no need to GRANT privileges to the creator of an object, the creator automatically holds ALL privileges, and can also drop the object.
Use the psql \z command for further information about permissions on existing objects:
Database = lusitania +------------------+---------------------------------------------+ | Relation | Grant/Revoke Permissions | +------------------+---------------------------------------------+ | mytable | {"=rw","miriam=arwR","group todos=rw"} | +------------------+---------------------------------------------+ Legend: uname=arwR -- privileges granted to a user group gname=arwR -- privileges granted to a GROUP =arwR -- privileges granted to PUBLIC r -- SELECT w -- UPDATE/DELETE a -- INSERT R -- RULE arwR -- ALL
Tip: Currently, to create a GROUP you have to insert data manually into table pg_group as:
INSERT INTO pg_group VALUES ('todos'); CREATE USER miriam IN GROUP todos;Refer to REVOKE statements to revoke access privileges.
-- grant insert privilege to all users on table films: -- GRANT INSERT ON films TO PUBLIC;
-- grant all privileges to user manuel on view kinds: -- GRANT ALL ON kinds TO manuel;
The SQL92 syntax for GRANT allows setting privileges for individual columns within a table, and allows setting a privilege to grant the same privileges to others.
GRANT privilege [, ...] ON object [ ( column [, ...] ) ] [, ...] TO { PUBLIC | username [, ...] } [ WITH GRANT OPTION ]Fields are compatible with the those in the Postgres implementation, with the following additions:
SQL92 permits additional privileges to be specified:
Allowed to reference some or all of the columns of a specific table/view in integrity constraints.
Allowed to use a domain, character set, collation or translation. If an object specifies anything other than a table/view, privilege must specify only USAGE.
Tip: Currently, to grant privileges in Postgres to only few columns, you must create a view having desired columns and then grant privileges to that view.
SQL92 allows an additional non-functional keyword:
[ TABLE ] table |
Allowed to use the specified character set.
Allowed to use the specified collation sequence.
Allowed to use the specified character set translation.
Allowed to use the specified domain.
Allowed to grant the same privilege to others.