pgd commit-scope drop
=====================

Synopsis
--------

The ``pgd commit-scope drop`` command is used to drop a commit scope
from the EDB Postgres Distributed cluster.

Users and roles
^^^^^^^^^^^^^^^

Requires the ``bdr_superuser`` role. See :ref:`User roles <User roles>`  .

Syntax
------

.. code:: plaintext

   pgd commit-scope <COMMIT_SCOPE> drop [OPTIONS] [GROUP_NAME]

Where ``<COMMIT_SCOPE>`` is the name of the commit scope to drop.

The optional ``[GROUP_NAME]`` is the name of the group to which the
commit scope belongs. If omitted, it defaults to the top-level group.
Note that the name of the group must match the group name the commit
scope was created with.

Options
-------

No command specific options. See `Global Options <https://www.enterprisedb.com/docs/pgd/latest/reference/cli/command_ref/#global-options>`_  .

Examples
--------

Drop a Commit Scope
^^^^^^^^^^^^^^^^^^^

The following example drops the commit scope named ``abc2`` from the
top-level group:

.. code:: shell

   pgd commit-scope abc2 drop
   __OUTPUT__
   Command executed successfully

Drop a Commit Scope from a Group
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

The following example drops the commit scope named ``abc1`` from the
``dc1_subgroup`` group:

.. code:: shell

   pgd commit-scope abc1 drop dc1_subgroup
   __OUTPUT__
   Command executed successfully