===========
ALTER GROUP
===========


.. container:: refentry
   :name: SQL-ALTERGROUP

   .. container:: titlepage

   .. container:: refnamediv

      .. rubric:: ALTER GROUP
         :name: alter-group

      ALTER GROUP — 更改角色名称或者成员关系

   .. container:: refsynopsisdiv

      .. rubric:: 大纲
         :name: 大纲

      .. code:: synopsis

         ALTER GROUP role_specification ADD USER user_name [, ... ]
         ALTER GROUP role_specification DROP USER user_name [, ... ]

         其中 role_specification 可以是：

             role_name
           | CURRENT_USER
           | SESSION_USER

         ALTER GROUP group_name RENAME TO new_name

   .. container:: refsect1
      :name: id-1.9.3.15.5

      .. rubric:: 描述
         :name: 描述

      ``ALTER GROUP``\ 更改一个用户组的属性。
      这是一个被废弃的命令，不过为了向后兼容还是会被接受，因为组（以及用户）
      已经被更一般的角色概念替代了。

      前两个变体向一个组增加用户或者从一个组中移除用户（为了这个目的，
      任何角色都可以扮演“用户”或者“组”）。这些变体
      实际上等效于在被称为“组”的角色中授予或者回收成员关系，
      因此最好的方法是使用\ `GRANT <sql-grant.html>`__\ 或者
      `REVOKE <sql-revoke.html>`__\ 。

      第三种变体会更改该组的名称。这恰好等效于用\ `ALTER
      ROLE <sql-alterrole.html>`__ 重命名该角色。

   .. container:: refsect1
      :name: id-1.9.3.15.6

      .. rubric:: 参数
         :name: 参数

      .. container:: variablelist

         *``group_name``*
            要修改的组（角色）的名称。

         *``user_name``*
            要被加入到该组或者从该组移除的用户（角色）。这些用户必须已经存在，
            ``ALTER GROUP``\ 不会创建或者删除用户。

         *``new_name``*
            该组的新名称。

   .. container:: refsect1
      :name: id-1.9.3.15.7

      .. rubric:: 示例
         :name: 示例

      向一个组增加用户：

      .. code:: programlisting

         ALTER GROUP staff ADD USER karl, john;

      从一个组移除一个用户：

      .. code:: programlisting

         ALTER GROUP workers DROP USER beth;

   .. container:: refsect1
      :name: id-1.9.3.15.8

      .. rubric:: 兼容性
         :name: 兼容性

      在 SQL 标准中没有\ ``ALTER GROUP``\ 语句。

   .. container:: refsect1
      :name: id-1.9.3.15.9

      .. rubric:: 另见
         :name: 另见

      `GRANT <sql-grant.html>`__, `REVOKE <sql-revoke.html>`__, `ALTER
      ROLE <sql-alterrole.html>`__