pgd commit-scope create
=======================

概要
----

``pgd commit-scope create`` コマンドは、 EDB
Postgres分散クラスターにコミットスコープを作成するために使用されます。

構文
----

.. code:: plaintext

   pgd commit-scope <COMMIT_SCOPE> create [OPTIONS] <RULE_DEFINITION> [GROUP_NAME]

``<COMMIT_SCOPE>`` は、作成するコミットスコープの名前です。

``<RULE_DEFINITION>``
は、コミットスコープを定義するルールです。ルールは、トランザクションがコミットされたとみなされるために満たされる必要がある条件を指定します。ルール構文の詳細については、
:ref:`Commit scopes <Commit scopes>` および :ref:`Commit scope rules <Commit scope rules>` を参照してください。

オプションの\ ``[GROUP_NAME]``
は、コミットスコープが属するグループの名前です。省略すると、デフォルトのトップレベルグループが設定されます。

オプション
----------

コマンド固有のオプションはありません。 `Global Options <https://www.enterprisedb.com/docs/pgd/latest/reference/cli/command_ref/#global-options>`_ を参照してください。

例
--

コミットスコープの作成
^^^^^^^^^^^^^^^^^^^^^^

次の例では、 ``dc1_subgroup``
グループにルール\ ``ANY 2 (dc1) on replicated group commit``
を使用して\ ``abc1`` という名前のコミットスコープを作成します。

.. code:: shell

   pgd commit-scope abc1 create "ANY 2 (dc1_subgroup) SYNCHRONOUS COMMIT" dc1_subgroup
   __OUTPUT__
   Command executed successfully

コミットスコープを確認します。

.. code:: shell

   pgd commit-scope abc1 show
   __OUTPUT__
   Commit Scope Group Name   Rule Definition
   - ----------- ------------ ---------------------------------------
   abc1         dc1_subgroup ANY 2 (dc1_subgroup) SYNCHRONOUS COMMIT

トップレベルグループでのコミットスコープの作成
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

次の例では、トップレベルグループにルール\ ``ANY 2 (dc1_subgroup) SYNCHRONOUS COMMIT``
を使用して\ ``abc2`` という名前のコミットスコープを作成します。

.. code:: shell

   pgd commit-scope abc2 create "ANY 2 (dc1_subgroup) SYNCHRONOUS COMMIT"
   __OUTPUT__
   Command executed successfully

コミットスコープを確認します。

.. code:: shell

   pgd commit-scope abc2 show
   __OUTPUT__
   Commit Scope Group Name  Rule Definition
   - ----------- ----------- ---------------------------------------
   abc2         democluster ANY 2 (dc1_subgroup) SYNCHRONOUS COMMIT
