Skip to content

Commit

Permalink
Apply suggestions from review comments
Browse files Browse the repository at this point in the history
  • Loading branch information
djw-m committed Oct 2, 2023
1 parent c2d1a2a commit 3fd07b4
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions product_docs/docs/pgd/5/terminology.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,15 @@ There are many terms you will come across in EDB Postgres Distributed that you m

#### Asynchronous replication

Copies data to cluster members after the transaction completes on the origin node. Asynchronous replication can provide higher performance and lower latency than synchronous replication. However, asynchronous replication can see a lag in how long changes take to appear in the various cluster members. While the cluster will be [eventually consistent](#eventual-consistency), there will be potential for nodes to be apparently out of sync with each other.
A type of replication that copies data to other PGD cluster members after the transaction completes on the origin node. Asynchronous replication can provide higher performance and lower latency than [synchronous replication](#synchrous-replication). However, asynchronous replication can see a lag in how long changes take to appear in the various cluster members. While the cluster will be [eventually consistent](#eventual-consistency), there will be potential for nodes to be apparently out of sync with each other.

#### Commit scopes

Rules for managing how transactions are committed between the nodes and groups of a PGD cluster. Used to configure [synchronous replication](#synchronous-replication), [Group Commit](#group-commit), [CAMO](#camo-or-commit-at-most-once), [Eager](#eager), lag control and other PGD features.

#### CAMO or commit-at-most-once

High value transactions in some applications require that the application is able to not only confirm that the transaction has been committed but that the transaction is only committed once or not at all. To ensure this happens in PGD, CAMO can be enabled allowing the application to actively participate in the transaction.
High value transactions in some applications require that the application successfully commited exactly once, and in the event of failover and retrying, only one. To ensure this happens in PGD, CAMO can be enabled allowing the application to actively participate in the transaction.

#### Conflicts

Expand All @@ -35,7 +35,7 @@ Data Definition Language - The subset of SQL commands that deal with the definin

#### DML

Data Manipulation Language - The subset of SQL commands that deal with manipulating the data held within a database. DML statements can create, modify and delete rows within tables in the database. Common DML commands are INSERT, UPDATE and DELETE. SELECT is also often referred to as DML, although it is actually part of the
Data Manipulation Language - The subset of SQL commands that deal with manipulating the data held within a database. DML statements can create, modify and delete rows within tables in the database. Common DML commands are INSERT, UPDATE and DELETE.


#### Eager
Expand Down Expand Up @@ -64,7 +64,7 @@ A Kubernetes cluster is a group of machines that work together to run containeri

#### Logical replication

A more efficient method of replicating changes in the database. Rather than duplicate the originating database’s disk blocks, logical replication instead sees the DML commands - inserts, deletes and updates,- published to all systems that have subscribed to see the changes. Each subscriber then applies the changes locally. Logical replication is not able to support most DDL
A more efficient method of replicating changes in the database. While physical streaming replication duplicate the originating database’s disk blocks, logical replication instead sees the DML commands - inserts, deletes and updates,- published to all systems that have subscribed to see the changes. Each subscriber then applies the changes locally. Logical replication is not able to support most DDL

#### Node

Expand All @@ -83,7 +83,7 @@ A group of multiple redundant database systems and proxies arranged to avoid sin

### PGD node

In a PGD cluster, there are nodes which run databases and participate in the PG Cluster. A typical PGD node will run a Postgres database and the BDR extension and optionally a PGD Proxy service. PGD Nodes may also be referred to as data nodes which suggests they store data, though some PGD Nodes, specifically [witness nodes](#witness-nodes) do not do that.
In a PGD cluster, there are nodes which run databases and participate in the PGD Cluster. A typical PGD node will run a Postgres database and the BDR extension and optionally a PGD Proxy service. PGD Nodes may also be referred to as data nodes which suggests they store data, though some PGD Nodes, specifically [witness nodes](#witness-nodes) do not do that.

#### Physical replication

Expand Down Expand Up @@ -127,7 +127,7 @@ A traditional computing approach of increasing a resource (CPU, memory, storage,

#### Witness nodes

To resolve clusters or groups of nodes coming to a consensus, there needs to be an odd number of data nodes. Where resources are limited, a witness node can be used to create an odd number of data nodes, participating in cluster decisions but not replicating the data. Not holding the data means it is not able to operate as a standby server.
Witness nodes primarily serve to help the cluster establish a consensus. An odd number of data nodes are needed to establish a consensus and, where resources are limited, a witness node can be used to participate in cluster decisions but not replicate the data. Not holding the data means it cannot operate as a standby server or provide majorities in synchronous commits.


#### Write leader
Expand Down

0 comments on commit 3fd07b4

Please sign in to comment.