GRANT { { SELECT | INSERT | UPDATE | DELETE | TRUNCATE | REFERENCES | TRIGGER }
    [,...] | ALL [ PRIVILEGES ] }
    ON { [ TABLE ] table_name [, ...]
         | ALL TABLES IN SCHEMA schema_name [, ...] }
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { SELECT | INSERT | UPDATE | REFERENCES } ( column [, ...] )
    [,...] | ALL [ PRIVILEGES ] ( column [, ...] ) }
    ON [ TABLE ] table_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { USAGE | SELECT | UPDATE }
    [,...] | ALL [ PRIVILEGES ] }
    ON { SEQUENCE sequence_name [, ...]
         | ALL SEQUENCES IN SCHEMA schema_name [, ...] }
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { CREATE | CONNECT | TEMPORARY | TEMP } [,...] | ALL [ PRIVILEGES ] }
    ON DATABASE database_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { USAGE | ALL [ PRIVILEGES ] }
    ON FOREIGN DATA WRAPPER fdw_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { USAGE | ALL [ PRIVILEGES ] }
    ON FOREIGN SERVER server_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { EXECUTE | ALL [ PRIVILEGES ] }
    ON { FUNCTION function_name ( [ [ argmode ] [ arg_name ] arg_type [, ...] ] ) [, ...]
         | ALL FUNCTIONS IN SCHEMA schema_name [, ...] }
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { USAGE | ALL [ PRIVILEGES ] }
    ON LANGUAGE lang_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { SELECT | UPDATE } [,...] | ALL [ PRIVILEGES ] }
    ON LARGE OBJECT loid [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { { CREATE | USAGE } [,...] | ALL [ PRIVILEGES ] }
    ON SCHEMA schema_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT { CREATE | ALL [ PRIVILEGES ] }
    ON TABLESPACE tablespace_name [, ...]
    TO { [ GROUP ] role_name | PUBLIC } [, ...] [ WITH GRANT OPTION ]

GRANT role_name [, ...] TO role_name [, ...] [ WITH ADMIN OPTION ]

描述

GRANT命令有两个基本变种：一个变种是给数据库对象(表、字段、视图、序列、数据库、foreign-data wrapper、foreign server、函数、 过程语言、模式、表空间)赋予权限；一个变种是赋予一个角色中的成员关系。 这些变种在很多方面都非常类似，但是它们之间的区别也有足够理由来分开描述。

注意

REVOKE命令用于删除访问权限。

自PostgreSQL8.1，用户和群组的概念已经被到统一到 一个称作角色的单一类型的实体。因此，不再需要使用关键字GROUP来 确认被授权者是一个用户还是一个用户。GROUP在命令中仍然允许， 但这是一个噪音码字。

一个用户可能在一列上执行SELECT, INSERT等等，若该用户 持有对指定列或者其整个表的权限。在表级别授予权限并且之后对一列撤销权限，这可能 无法达成您的希望：表级别的授权是不受列级别操作的影响。

如果非对象所有者企图在对象上GRANT权限，而该用户没有该对象上指定的权限， 那么命令将立即失败。 只要有某些可用的权限，该命令就会继续，但是它只授予那些该用户有授权选项的权限。 如果没有可用的授权选项，那么GRANT ALL PRIVILEGES形式将发出一个警告信息， 其它命令形式将发出在命令中提到的、但是没有授权选项的那些权限相关的警告信息。 这些语句原则上也适用于对象所有者，但是因为所有者总是被认为拥有所有授权选项， 所以这种情况永远不会发生在所有者身上。

要注意数据库超级用户可以访问所有对象，而不会受对象的权限设置影响。这个特点类似 Unix系统的root的权限。 和root一样，除了必要的情况，总是以超级用户身份进行操作是不明智的做法。

如果一个超级用户选择发出一个GRANT或REVOKE命令，那么这条命 令将是以被影响对象的所有者的形式执行的。特别是，通过这种方法赋与的权限将显得好像是 由对象所有者赋与的。对于角色成员关系，成员关系的赋与就会像是通过包含角色自己赋与的一样。

GRANT和REVOKE也可以不由被影响对象的所有者来执行，而是由拥有 该对象的角色的一个成员来执行， 或者是一个在该对象上持有WITH GRANT OPTION权限的角色的成员。在这种 情况下，该权限将被纪录为是由实际拥有该对象或者持有WITH GRANT OPTION 权限的对象赋与的。比如，如果表t1被角色g1拥有，并且u1 是g1的一个成员，然后u1可以把t1的权限赋予u2， 但是这些权限将表现为是由g1直接赋予的。任何g1角色的成员都可以在之后撤销这些权限。

如果执行GRANT的角色所持有的所需权限是通过角色成员关系间接获得的， 那么究竟是那个角色将被纪录为赋予权限的角色就是未知的。在这种情况下， 最好的方法是使用SET ROLE成为你想执行GRANT命令的指定角色。

在一个表上授权许可不会自动扩展许可到任何表使用的序列，包括关联到SERIAL列上的 序列。序列上的权限必须另行设置。

使用psql's \dp命令 来获取关于对表和列的现有权限的信息。例如：

=> \dp mytable
                              Access privileges
 Schema |  Name   | Type  |   Access privileges   | Column access privileges 
--------+---------+-------+-----------------------+--------------------------
 public | mytable | table | miriam=arwdDxt/miriam | col1:
                          : =r/miriam             :   miriam_rw=rw/miriam
                          : admin=arw/miriam        
(1 row)

\dp显示的条目会被这样解释执行:

rolename=xxxx -- privileges granted to a role
        =xxxx -- privileges granted to PUBLIC

            r -- SELECT ("read")
            w -- UPDATE ("write")
            a -- INSERT ("append")
            d -- DELETE
            D -- TRUNCATE
            x -- REFERENCES
            t -- TRIGGER
            X -- EXECUTE
            U -- USAGE
            C -- CREATE
            c -- CONNECT
            T -- TEMPORARY
      arwdDxt -- ALL PRIVILEGES (for tables, varies for other objects)
            * -- grant option for preceding privilege

        /yyyy -- role that granted this privilege

用户miriam在建完mytable表之后再做下面的语句，就可以得到上面 例子的结果：

GRANT SELECT ON mytable TO PUBLIC;
GRANT SELECT, UPDATE, INSERT ON mytable TO admin;
GRANT SELECT (col1), UPDATE (col1) ON mytable TO miriam_rw;

对于非表对象有可以显示其权限的其他\d命令。

若"Access privileges"列对于给定对象是空的，这意味着对象有默认权限（也就是说， 其权限列是空的）。默认权限总是包括对所有者的所有权限，并且包含依赖对象类型的 一些对PUBLIC的权限，如上所述。 一个对象上的第一个GRANT或者REVOKE将实例化默认的特权 （生产，例如{miriam=arwdDxt/miriam}）并且然后根据每个特定请求来 更改他们。类似地，条目仅仅对于没有非默认权限的列显示"Column access privileges"。 权限受ALTER DEFAULT PRIVILEGES命令影响的对象总是显示为带有包含 ALTER影响的显式权限条目。

请注意所有者的隐含授权选项没有在显示出来的访问权限里标记出来。只有在授权选项明确 地授予某人之后，才会显示一个*。

示例

把表films的插入权限赋予所有用户：

GRANT INSERT ON films TO PUBLIC;

赋予用户manuel对视图kinds的所有权限：

GRANT ALL PRIVILEGES ON kinds TO manuel;

请注意，如果上面的命令由超级用户或者kinds的所有者执行， 那么它实际上会赋予所有权限，如果由其他人执行，那么它会赋予这个"其他人"拥有 授权选项的所有权限。

把角色admins的成员关系赋与用户joe：

GRANT admins TO joe;

兼容性

根据SQL标准，在ALL PRIVILEGES里的PRIVILEGES 关键字是必须的。SQL标准不支持在一条命令里对多个表设置权限。

PostgreSQL允许一个对象所有者撤销它自己的普通权限： 比如，一个表所有者可以让自己对这个表是只读的，方法是撤销自己的INSERT， UPDATE，DELETE权限。根据SQL标准， 这是不可能的。原因是PostgreSQL把所有者的权限当作 由所有者给自己赋予的；因此也可以撤销他们。在SQL标准里，所有者的权限是假设为 "_SYSTEM"实体赋予的。因为所有者不是"_SYSTEM"，所以他不能撤销这些权限。

SQL 标准对其它类型的对象提供了一个 USAGE 权限：字符集、校勘、转换、域。

在数据库、表空间、模式、语言、序列上的权限是PostgreSQL扩展。

又见

REVOKE, ALTER DEFAULT PRIVILEGES