Commit 941697c3 authored by Andres Freund's avatar Andres Freund

snapshot scalability: Introduce dense array of in-progress xids.

The new array contains the xids for all connected backends / in-use
PGPROC entries in a dense manner (in contrast to the PGPROC/PGXACT
arrays which can have unused entries interspersed).

This improves performance because GetSnapshotData() always needs to
scan the xids of all live procarray entries and now there's no need to
go through the procArray->pgprocnos indirection anymore.

As the set of running top-level xids changes rarely, compared to the
number of snapshots taken, this substantially increases the likelihood
of most data required for a snapshot being in l2 cache.  In
read-mostly workloads scanning the xids[] array will sufficient to
build a snapshot, as most backends will not have an xid assigned.

To keep the xid array dense ProcArrayRemove() needs to move entries
behind the to-be-removed proc's one further up in the array. Obviously
moving array entries cannot happen while a backend sets it
xid. I.e. locking needs to prevent that array entries are moved while
a backend modifies its xid.

To avoid locking ProcArrayLock in GetNewTransactionId() - a fairly hot
spot already - ProcArrayAdd() / ProcArrayRemove() now needs to hold
XidGenLock in addition to ProcArrayLock. Adding / Removing a procarray
entry is not a very frequent operation, even taking 2PC into account.

Due to the above, the dense array entries can only be read or modified
while holding ProcArrayLock and/or XidGenLock. This prevents a
concurrent ProcArrayRemove() from shifting the dense array while it is
accessed concurrently.

While the new dense array is very good when needing to look at all
xids it is less suitable when accessing a single backend's xid. In
particular it would be problematic to have to acquire a lock to access
a backend's own xid. Therefore a backend's xid is not just stored in
the dense array, but also in PGPROC. This also allows a backend to
only access the shared xid value when the backend had acquired an
xid.

The infrastructure added in this commit will be used for the remaining
PGXACT fields in subsequent commits. They are kept separate to make
review easier.

Author: Andres Freund <andres@anarazel.de>
Reviewed-By: default avatarRobert Haas <robertmhaas@gmail.com>
Reviewed-By: default avatarThomas Munro <thomas.munro@gmail.com>
Reviewed-By: default avatarDavid Rowley <dgrowleyml@gmail.com>
Discussion: https://postgr.es/m/20200301083601.ews6hz5dduc3w2se@alap3.anarazel.de
parent 2ba5b2db
...@@ -11,12 +11,12 @@ ...@@ -11,12 +11,12 @@
* shared buffer content lock on the buffer containing the tuple. * shared buffer content lock on the buffer containing the tuple.
* *
* NOTE: When using a non-MVCC snapshot, we must check * NOTE: When using a non-MVCC snapshot, we must check
* TransactionIdIsInProgress (which looks in the PGXACT array) * TransactionIdIsInProgress (which looks in the PGPROC array)
* before TransactionIdDidCommit/TransactionIdDidAbort (which look in * before TransactionIdDidCommit/TransactionIdDidAbort (which look in
* pg_xact). Otherwise we have a race condition: we might decide that a * pg_xact). Otherwise we have a race condition: we might decide that a
* just-committed transaction crashed, because none of the tests succeed. * just-committed transaction crashed, because none of the tests succeed.
* xact.c is careful to record commit/abort in pg_xact before it unsets * xact.c is careful to record commit/abort in pg_xact before it unsets
* MyPgXact->xid in the PGXACT array. That fixes that problem, but it * MyProc->xid in the PGPROC array. That fixes that problem, but it
* also means there is a window where TransactionIdIsInProgress and * also means there is a window where TransactionIdIsInProgress and
* TransactionIdDidCommit will both return true. If we check only * TransactionIdDidCommit will both return true. If we check only
* TransactionIdDidCommit, we could consider a tuple committed when a * TransactionIdDidCommit, we could consider a tuple committed when a
...@@ -956,7 +956,7 @@ HeapTupleSatisfiesDirty(HeapTuple htup, Snapshot snapshot, ...@@ -956,7 +956,7 @@ HeapTupleSatisfiesDirty(HeapTuple htup, Snapshot snapshot,
* coding where we tried to set the hint bits as soon as possible, we instead * coding where we tried to set the hint bits as soon as possible, we instead
* did TransactionIdIsInProgress in each call --- to no avail, as long as the * did TransactionIdIsInProgress in each call --- to no avail, as long as the
* inserting/deleting transaction was still running --- which was more cycles * inserting/deleting transaction was still running --- which was more cycles
* and more contention on the PGXACT array. * and more contention on ProcArrayLock.
*/ */
static bool static bool
HeapTupleSatisfiesMVCC(HeapTuple htup, Snapshot snapshot, HeapTupleSatisfiesMVCC(HeapTuple htup, Snapshot snapshot,
...@@ -1459,7 +1459,7 @@ HeapTupleSatisfiesNonVacuumable(HeapTuple htup, Snapshot snapshot, ...@@ -1459,7 +1459,7 @@ HeapTupleSatisfiesNonVacuumable(HeapTuple htup, Snapshot snapshot,
* HeapTupleSatisfiesMVCC) and, therefore, any hint bits that can be set * HeapTupleSatisfiesMVCC) and, therefore, any hint bits that can be set
* should already be set. We assume that if no hint bits are set, the xmin * should already be set. We assume that if no hint bits are set, the xmin
* or xmax transaction is still running. This is therefore faster than * or xmax transaction is still running. This is therefore faster than
* HeapTupleSatisfiesVacuum, because we don't consult PGXACT nor CLOG. * HeapTupleSatisfiesVacuum, because we consult neither procarray nor CLOG.
* It's okay to return false when in doubt, but we must return true only * It's okay to return false when in doubt, but we must return true only
* if the tuple is removable. * if the tuple is removable.
*/ */
......
...@@ -251,10 +251,10 @@ enforce, and it assists with some other issues as explained below.) The ...@@ -251,10 +251,10 @@ enforce, and it assists with some other issues as explained below.) The
implementation of this is that GetSnapshotData takes the ProcArrayLock in implementation of this is that GetSnapshotData takes the ProcArrayLock in
shared mode (so that multiple backends can take snapshots in parallel), shared mode (so that multiple backends can take snapshots in parallel),
but ProcArrayEndTransaction must take the ProcArrayLock in exclusive mode but ProcArrayEndTransaction must take the ProcArrayLock in exclusive mode
while clearing MyPgXact->xid at transaction end (either commit or abort). while clearing the ProcGlobal->xids[] entry at transaction end (either
(To reduce context switching, when multiple transactions commit nearly commit or abort). (To reduce context switching, when multiple transactions
simultaneously, we have one backend take ProcArrayLock and clear the XIDs commit nearly simultaneously, we have one backend take ProcArrayLock and
of multiple processes at once.) clear the XIDs of multiple processes at once.)
ProcArrayEndTransaction also holds the lock while advancing the shared ProcArrayEndTransaction also holds the lock while advancing the shared
latestCompletedXid variable. This allows GetSnapshotData to use latestCompletedXid variable. This allows GetSnapshotData to use
...@@ -278,12 +278,12 @@ present in the ProcArray, or not running anymore. (This guarantee doesn't ...@@ -278,12 +278,12 @@ present in the ProcArray, or not running anymore. (This guarantee doesn't
apply to subtransaction XIDs, because of the possibility that there's not apply to subtransaction XIDs, because of the possibility that there's not
room for them in the subxid array; instead we guarantee that they are room for them in the subxid array; instead we guarantee that they are
present or the overflow flag is set.) If a backend released XidGenLock present or the overflow flag is set.) If a backend released XidGenLock
before storing its XID into MyPgXact, then it would be possible for another before storing its XID into ProcGlobal->xids[], then it would be possible for
backend to allocate and commit a later XID, causing latestCompletedXid to another backend to allocate and commit a later XID, causing latestCompletedXid
pass the first backend's XID, before that value became visible in the to pass the first backend's XID, before that value became visible in the
ProcArray. That would break ComputeXidHorizons, as discussed below. ProcArray. That would break ComputeXidHorizons, as discussed below.
We allow GetNewTransactionId to store the XID into MyPgXact->xid (or the We allow GetNewTransactionId to store the XID into ProcGlobal->xids[] (or the
subxid array) without taking ProcArrayLock. This was once necessary to subxid array) without taking ProcArrayLock. This was once necessary to
avoid deadlock; while that is no longer the case, it's still beneficial for avoid deadlock; while that is no longer the case, it's still beneficial for
performance. We are thereby relying on fetch/store of an XID to be atomic, performance. We are thereby relying on fetch/store of an XID to be atomic,
...@@ -382,12 +382,13 @@ Top-level transactions do not have a parent, so they leave their pg_subtrans ...@@ -382,12 +382,13 @@ Top-level transactions do not have a parent, so they leave their pg_subtrans
entries set to the default value of zero (InvalidTransactionId). entries set to the default value of zero (InvalidTransactionId).
pg_subtrans is used to check whether the transaction in question is still pg_subtrans is used to check whether the transaction in question is still
running --- the main Xid of a transaction is recorded in the PGXACT struct, running --- the main Xid of a transaction is recorded in ProcGlobal->xids[],
but since we allow arbitrary nesting of subtransactions, we can't fit all Xids with a copy in PGPROC->xid, but since we allow arbitrary nesting of
in shared memory, so we have to store them on disk. Note, however, that for subtransactions, we can't fit all Xids in shared memory, so we have to store
each transaction we keep a "cache" of Xids that are known to be part of the them on disk. Note, however, that for each transaction we keep a "cache" of
transaction tree, so we can skip looking at pg_subtrans unless we know the Xids that are known to be part of the transaction tree, so we can skip looking
cache has been overflowed. See storage/ipc/procarray.c for the gory details. at pg_subtrans unless we know the cache has been overflowed. See
storage/ipc/procarray.c for the gory details.
slru.c is the supporting mechanism for both pg_xact and pg_subtrans. It slru.c is the supporting mechanism for both pg_xact and pg_subtrans. It
implements the LRU policy for in-memory buffer pages. The high-level routines implements the LRU policy for in-memory buffer pages. The high-level routines
......
...@@ -285,15 +285,15 @@ TransactionIdSetPageStatus(TransactionId xid, int nsubxids, ...@@ -285,15 +285,15 @@ TransactionIdSetPageStatus(TransactionId xid, int nsubxids,
* updates for multiple backends so that the number of times XactSLRULock * updates for multiple backends so that the number of times XactSLRULock
* needs to be acquired is reduced. * needs to be acquired is reduced.
* *
* For this optimization to be safe, the XID in MyPgXact and the subxids * For this optimization to be safe, the XID and subxids in MyProc must be
* in MyProc must be the same as the ones for which we're setting the * the same as the ones for which we're setting the status. Check that
* status. Check that this is the case. * this is the case.
* *
* For this optimization to be efficient, we shouldn't have too many * For this optimization to be efficient, we shouldn't have too many
* sub-XIDs and all of the XIDs for which we're adjusting clog should be * sub-XIDs and all of the XIDs for which we're adjusting clog should be
* on the same page. Check those conditions, too. * on the same page. Check those conditions, too.
*/ */
if (all_xact_same_page && xid == MyPgXact->xid && if (all_xact_same_page && xid == MyProc->xid &&
nsubxids <= THRESHOLD_SUBTRANS_CLOG_OPT && nsubxids <= THRESHOLD_SUBTRANS_CLOG_OPT &&
nsubxids == MyPgXact->nxids && nsubxids == MyPgXact->nxids &&
memcmp(subxids, MyProc->subxids.xids, memcmp(subxids, MyProc->subxids.xids,
......
...@@ -351,7 +351,7 @@ AtAbort_Twophase(void) ...@@ -351,7 +351,7 @@ AtAbort_Twophase(void)
/* /*
* This is called after we have finished transferring state to the prepared * This is called after we have finished transferring state to the prepared
* PGXACT entry. * PGPROC entry.
*/ */
void void
PostPrepare_Twophase(void) PostPrepare_Twophase(void)
...@@ -463,7 +463,7 @@ MarkAsPreparingGuts(GlobalTransaction gxact, TransactionId xid, const char *gid, ...@@ -463,7 +463,7 @@ MarkAsPreparingGuts(GlobalTransaction gxact, TransactionId xid, const char *gid,
proc->waitStatus = PROC_WAIT_STATUS_OK; proc->waitStatus = PROC_WAIT_STATUS_OK;
/* We set up the gxact's VXID as InvalidBackendId/XID */ /* We set up the gxact's VXID as InvalidBackendId/XID */
proc->lxid = (LocalTransactionId) xid; proc->lxid = (LocalTransactionId) xid;
pgxact->xid = xid; proc->xid = xid;
Assert(proc->xmin == InvalidTransactionId); Assert(proc->xmin == InvalidTransactionId);
proc->delayChkpt = false; proc->delayChkpt = false;
pgxact->vacuumFlags = 0; pgxact->vacuumFlags = 0;
...@@ -768,7 +768,6 @@ pg_prepared_xact(PG_FUNCTION_ARGS) ...@@ -768,7 +768,6 @@ pg_prepared_xact(PG_FUNCTION_ARGS)
{ {
GlobalTransaction gxact = &status->array[status->currIdx++]; GlobalTransaction gxact = &status->array[status->currIdx++];
PGPROC *proc = &ProcGlobal->allProcs[gxact->pgprocno]; PGPROC *proc = &ProcGlobal->allProcs[gxact->pgprocno];
PGXACT *pgxact = &ProcGlobal->allPgXact[gxact->pgprocno];
Datum values[5]; Datum values[5];
bool nulls[5]; bool nulls[5];
HeapTuple tuple; HeapTuple tuple;
...@@ -783,7 +782,7 @@ pg_prepared_xact(PG_FUNCTION_ARGS) ...@@ -783,7 +782,7 @@ pg_prepared_xact(PG_FUNCTION_ARGS)
MemSet(values, 0, sizeof(values)); MemSet(values, 0, sizeof(values));
MemSet(nulls, 0, sizeof(nulls)); MemSet(nulls, 0, sizeof(nulls));
values[0] = TransactionIdGetDatum(pgxact->xid); values[0] = TransactionIdGetDatum(proc->xid);
values[1] = CStringGetTextDatum(gxact->gid); values[1] = CStringGetTextDatum(gxact->gid);
values[2] = TimestampTzGetDatum(gxact->prepared_at); values[2] = TimestampTzGetDatum(gxact->prepared_at);
values[3] = ObjectIdGetDatum(gxact->owner); values[3] = ObjectIdGetDatum(gxact->owner);
...@@ -829,9 +828,8 @@ TwoPhaseGetGXact(TransactionId xid, bool lock_held) ...@@ -829,9 +828,8 @@ TwoPhaseGetGXact(TransactionId xid, bool lock_held)
for (i = 0; i < TwoPhaseState->numPrepXacts; i++) for (i = 0; i < TwoPhaseState->numPrepXacts; i++)
{ {
GlobalTransaction gxact = TwoPhaseState->prepXacts[i]; GlobalTransaction gxact = TwoPhaseState->prepXacts[i];
PGXACT *pgxact = &ProcGlobal->allPgXact[gxact->pgprocno];
if (pgxact->xid == xid) if (gxact->xid == xid)
{ {
result = gxact; result = gxact;
break; break;
...@@ -987,8 +985,7 @@ void ...@@ -987,8 +985,7 @@ void
StartPrepare(GlobalTransaction gxact) StartPrepare(GlobalTransaction gxact)
{ {
PGPROC *proc = &ProcGlobal->allProcs[gxact->pgprocno]; PGPROC *proc = &ProcGlobal->allProcs[gxact->pgprocno];
PGXACT *pgxact = &ProcGlobal->allPgXact[gxact->pgprocno]; TransactionId xid = gxact->xid;
TransactionId xid = pgxact->xid;
TwoPhaseFileHeader hdr; TwoPhaseFileHeader hdr;
TransactionId *children; TransactionId *children;
RelFileNode *commitrels; RelFileNode *commitrels;
...@@ -1140,15 +1137,15 @@ EndPrepare(GlobalTransaction gxact) ...@@ -1140,15 +1137,15 @@ EndPrepare(GlobalTransaction gxact)
/* /*
* Mark the prepared transaction as valid. As soon as xact.c marks * Mark the prepared transaction as valid. As soon as xact.c marks
* MyPgXact as not running our XID (which it will do immediately after * MyProc as not running our XID (which it will do immediately after
* this function returns), others can commit/rollback the xact. * this function returns), others can commit/rollback the xact.
* *
* NB: a side effect of this is to make a dummy ProcArray entry for the * NB: a side effect of this is to make a dummy ProcArray entry for the
* prepared XID. This must happen before we clear the XID from MyPgXact, * prepared XID. This must happen before we clear the XID from MyProc /
* else there is a window where the XID is not running according to * ProcGlobal->xids[], else there is a window where the XID is not running
* TransactionIdIsInProgress, and onlookers would be entitled to assume * according to TransactionIdIsInProgress, and onlookers would be entitled
* the xact crashed. Instead we have a window where the same XID appears * to assume the xact crashed. Instead we have a window where the same
* twice in ProcArray, which is OK. * XID appears twice in ProcArray, which is OK.
*/ */
MarkAsPrepared(gxact, false); MarkAsPrepared(gxact, false);
...@@ -1404,7 +1401,6 @@ FinishPreparedTransaction(const char *gid, bool isCommit) ...@@ -1404,7 +1401,6 @@ FinishPreparedTransaction(const char *gid, bool isCommit)
{ {
GlobalTransaction gxact; GlobalTransaction gxact;
PGPROC *proc; PGPROC *proc;
PGXACT *pgxact;
TransactionId xid; TransactionId xid;
char *buf; char *buf;
char *bufptr; char *bufptr;
...@@ -1423,8 +1419,7 @@ FinishPreparedTransaction(const char *gid, bool isCommit) ...@@ -1423,8 +1419,7 @@ FinishPreparedTransaction(const char *gid, bool isCommit)
*/ */
gxact = LockGXact(gid, GetUserId()); gxact = LockGXact(gid, GetUserId());
proc = &ProcGlobal->allProcs[gxact->pgprocno]; proc = &ProcGlobal->allProcs[gxact->pgprocno];
pgxact = &ProcGlobal->allPgXact[gxact->pgprocno]; xid = gxact->xid;
xid = pgxact->xid;
/* /*
* Read and validate 2PC state data. State data will typically be stored * Read and validate 2PC state data. State data will typically be stored
...@@ -1726,7 +1721,7 @@ CheckPointTwoPhase(XLogRecPtr redo_horizon) ...@@ -1726,7 +1721,7 @@ CheckPointTwoPhase(XLogRecPtr redo_horizon)
for (i = 0; i < TwoPhaseState->numPrepXacts; i++) for (i = 0; i < TwoPhaseState->numPrepXacts; i++)
{ {
/* /*
* Note that we are using gxact not pgxact so this works in recovery * Note that we are using gxact not PGPROC so this works in recovery
* also * also
*/ */
GlobalTransaction gxact = TwoPhaseState->prepXacts[i]; GlobalTransaction gxact = TwoPhaseState->prepXacts[i];
......
...@@ -38,7 +38,8 @@ VariableCache ShmemVariableCache = NULL; ...@@ -38,7 +38,8 @@ VariableCache ShmemVariableCache = NULL;
* Allocate the next FullTransactionId for a new transaction or * Allocate the next FullTransactionId for a new transaction or
* subtransaction. * subtransaction.
* *
* The new XID is also stored into MyPgXact before returning. * The new XID is also stored into MyProc->xid/ProcGlobal->xids[] before
* returning.
* *
* Note: when this is called, we are actually already inside a valid * Note: when this is called, we are actually already inside a valid
* transaction, since XIDs are now not allocated until the transaction * transaction, since XIDs are now not allocated until the transaction
...@@ -65,7 +66,8 @@ GetNewTransactionId(bool isSubXact) ...@@ -65,7 +66,8 @@ GetNewTransactionId(bool isSubXact)
if (IsBootstrapProcessingMode()) if (IsBootstrapProcessingMode())
{ {
Assert(!isSubXact); Assert(!isSubXact);
MyPgXact->xid = BootstrapTransactionId; MyProc->xid = BootstrapTransactionId;
ProcGlobal->xids[MyProc->pgxactoff] = BootstrapTransactionId;
return FullTransactionIdFromEpochAndXid(0, BootstrapTransactionId); return FullTransactionIdFromEpochAndXid(0, BootstrapTransactionId);
} }
...@@ -190,10 +192,10 @@ GetNewTransactionId(bool isSubXact) ...@@ -190,10 +192,10 @@ GetNewTransactionId(bool isSubXact)
* latestCompletedXid is present in the ProcArray, which is essential for * latestCompletedXid is present in the ProcArray, which is essential for
* correct OldestXmin tracking; see src/backend/access/transam/README. * correct OldestXmin tracking; see src/backend/access/transam/README.
* *
* Note that readers of PGXACT xid fields should be careful to fetch the * Note that readers of ProcGlobal->xids/PGPROC->xid should be careful
* value only once, rather than assume they can read a value multiple * to fetch the value for each proc only once, rather than assume they can
* times and get the same answer each time. Note we are assuming that * read a value multiple times and get the same answer each time. Note we
* TransactionId and int fetch/store are atomic. * are assuming that TransactionId and int fetch/store are atomic.
* *
* The same comments apply to the subxact xid count and overflow fields. * The same comments apply to the subxact xid count and overflow fields.
* *
...@@ -219,7 +221,11 @@ GetNewTransactionId(bool isSubXact) ...@@ -219,7 +221,11 @@ GetNewTransactionId(bool isSubXact)
* answer later on when someone does have a reason to inquire.) * answer later on when someone does have a reason to inquire.)
*/ */
if (!isSubXact) if (!isSubXact)
MyPgXact->xid = xid; /* LWLockRelease acts as barrier */ {
/* LWLockRelease acts as barrier */
MyProc->xid = xid;
ProcGlobal->xids[MyProc->pgxactoff] = xid;
}
else else
{ {
int nxids = MyPgXact->nxids; int nxids = MyPgXact->nxids;
......
...@@ -1724,7 +1724,7 @@ vacuum_rel(Oid relid, RangeVar *relation, VacuumParams *params) ...@@ -1724,7 +1724,7 @@ vacuum_rel(Oid relid, RangeVar *relation, VacuumParams *params)
* *
* Note: these flags remain set until CommitTransaction or * Note: these flags remain set until CommitTransaction or
* AbortTransaction. We don't want to clear them until we reset * AbortTransaction. We don't want to clear them until we reset
* MyPgXact->xid/xmin, otherwise GetOldestNonRemovableTransactionId() * MyProc->xid/xmin, otherwise GetOldestNonRemovableTransactionId()
* might appear to go backwards, which is probably Not Good. * might appear to go backwards, which is probably Not Good.
*/ */
LWLockAcquire(ProcArrayLock, LW_EXCLUSIVE); LWLockAcquire(ProcArrayLock, LW_EXCLUSIVE);
......
This diff is collapsed.
...@@ -417,9 +417,7 @@ BackendIdGetTransactionIds(int backendID, TransactionId *xid, TransactionId *xmi ...@@ -417,9 +417,7 @@ BackendIdGetTransactionIds(int backendID, TransactionId *xid, TransactionId *xmi
if (proc != NULL) if (proc != NULL)
{ {
PGXACT *xact = &ProcGlobal->allPgXact[proc->pgprocno]; *xid = proc->xid;
*xid = xact->xid;
*xmin = proc->xmin; *xmin = proc->xmin;
} }
} }
......
...@@ -3974,9 +3974,8 @@ GetRunningTransactionLocks(int *nlocks) ...@@ -3974,9 +3974,8 @@ GetRunningTransactionLocks(int *nlocks)
proclock->tag.myLock->tag.locktag_type == LOCKTAG_RELATION) proclock->tag.myLock->tag.locktag_type == LOCKTAG_RELATION)
{ {
PGPROC *proc = proclock->tag.myProc; PGPROC *proc = proclock->tag.myProc;
PGXACT *pgxact = &ProcGlobal->allPgXact[proc->pgprocno];
LOCK *lock = proclock->tag.myLock; LOCK *lock = proclock->tag.myLock;
TransactionId xid = pgxact->xid; TransactionId xid = proc->xid;
/* /*
* Don't record locks for transactions if we know they have * Don't record locks for transactions if we know they have
......
...@@ -102,21 +102,18 @@ Size ...@@ -102,21 +102,18 @@ Size
ProcGlobalShmemSize(void) ProcGlobalShmemSize(void)
{ {
Size size = 0; Size size = 0;
Size TotalProcs =
add_size(MaxBackends, add_size(NUM_AUXILIARY_PROCS, max_prepared_xacts));
/* ProcGlobal */ /* ProcGlobal */
size = add_size(size, sizeof(PROC_HDR)); size = add_size(size, sizeof(PROC_HDR));
/* MyProcs, including autovacuum workers and launcher */ size = add_size(size, mul_size(TotalProcs, sizeof(PGPROC)));
size = add_size(size, mul_size(MaxBackends, sizeof(PGPROC)));
/* AuxiliaryProcs */
size = add_size(size, mul_size(NUM_AUXILIARY_PROCS, sizeof(PGPROC)));
/* Prepared xacts */
size = add_size(size, mul_size(max_prepared_xacts, sizeof(PGPROC)));
/* ProcStructLock */
size = add_size(size, sizeof(slock_t)); size = add_size(size, sizeof(slock_t));
size = add_size(size, mul_size(MaxBackends, sizeof(PGXACT))); size = add_size(size, mul_size(MaxBackends, sizeof(PGXACT)));
size = add_size(size, mul_size(NUM_AUXILIARY_PROCS, sizeof(PGXACT))); size = add_size(size, mul_size(NUM_AUXILIARY_PROCS, sizeof(PGXACT)));
size = add_size(size, mul_size(max_prepared_xacts, sizeof(PGXACT))); size = add_size(size, mul_size(max_prepared_xacts, sizeof(PGXACT)));
size = add_size(size, mul_size(TotalProcs, sizeof(*ProcGlobal->xids)));
return size; return size;
} }
...@@ -216,6 +213,17 @@ InitProcGlobal(void) ...@@ -216,6 +213,17 @@ InitProcGlobal(void)
MemSet(pgxacts, 0, TotalProcs * sizeof(PGXACT)); MemSet(pgxacts, 0, TotalProcs * sizeof(PGXACT));
ProcGlobal->allPgXact = pgxacts; ProcGlobal->allPgXact = pgxacts;
/*
* Allocate arrays mirroring PGPROC fields in a dense manner. See
* PROC_HDR.
*
* XXX: It might make sense to increase padding for these arrays, given
* how hotly they are accessed.
*/
ProcGlobal->xids =
(TransactionId *) ShmemAlloc(TotalProcs * sizeof(*ProcGlobal->xids));
MemSet(ProcGlobal->xids, 0, TotalProcs * sizeof(*ProcGlobal->xids));
for (i = 0; i < TotalProcs; i++) for (i = 0; i < TotalProcs; i++)
{ {
/* Common initialization for all PGPROCs, regardless of type. */ /* Common initialization for all PGPROCs, regardless of type. */
...@@ -387,7 +395,7 @@ InitProcess(void) ...@@ -387,7 +395,7 @@ InitProcess(void)
MyProc->lxid = InvalidLocalTransactionId; MyProc->lxid = InvalidLocalTransactionId;
MyProc->fpVXIDLock = false; MyProc->fpVXIDLock = false;
MyProc->fpLocalTransactionId = InvalidLocalTransactionId; MyProc->fpLocalTransactionId = InvalidLocalTransactionId;
MyPgXact->xid = InvalidTransactionId; MyProc->xid = InvalidTransactionId;
MyProc->xmin = InvalidTransactionId; MyProc->xmin = InvalidTransactionId;
MyProc->pid = MyProcPid; MyProc->pid = MyProcPid;
/* backendId, databaseId and roleId will be filled in later */ /* backendId, databaseId and roleId will be filled in later */
...@@ -571,7 +579,7 @@ InitAuxiliaryProcess(void) ...@@ -571,7 +579,7 @@ InitAuxiliaryProcess(void)
MyProc->lxid = InvalidLocalTransactionId; MyProc->lxid = InvalidLocalTransactionId;
MyProc->fpVXIDLock = false; MyProc->fpVXIDLock = false;
MyProc->fpLocalTransactionId = InvalidLocalTransactionId; MyProc->fpLocalTransactionId = InvalidLocalTransactionId;
MyPgXact->xid = InvalidTransactionId; MyProc->xid = InvalidTransactionId;
MyProc->xmin = InvalidTransactionId; MyProc->xmin = InvalidTransactionId;
MyProc->backendId = InvalidBackendId; MyProc->backendId = InvalidBackendId;
MyProc->databaseId = InvalidOid; MyProc->databaseId = InvalidOid;
......
...@@ -89,6 +89,17 @@ typedef enum ...@@ -89,6 +89,17 @@ typedef enum
* distinguished from a real one at need by the fact that it has pid == 0. * distinguished from a real one at need by the fact that it has pid == 0.
* The semaphore and lock-activity fields in a prepared-xact PGPROC are unused, * The semaphore and lock-activity fields in a prepared-xact PGPROC are unused,
* but its myProcLocks[] lists are valid. * but its myProcLocks[] lists are valid.
*
* Mirrored fields:
*
* Some fields in PGPROC (see "mirrored in ..." comment) are mirrored into an
* element of more densely packed ProcGlobal arrays. These arrays are indexed
* by PGPROC->pgxactoff. Both copies need to be maintained coherently.
*
* NB: The pgxactoff indexed value can *never* be accessed without holding
* locks.
*
* See PROC_HDR for details.
*/ */
struct PGPROC struct PGPROC
{ {
...@@ -101,6 +112,12 @@ struct PGPROC ...@@ -101,6 +112,12 @@ struct PGPROC
Latch procLatch; /* generic latch for process */ Latch procLatch; /* generic latch for process */
TransactionId xid; /* id of top-level transaction currently being
* executed by this proc, if running and XID
* is assigned; else InvalidTransactionId.
* mirrored in ProcGlobal->xids[pgxactoff] */
TransactionId xmin; /* minimal running XID as it was when we were TransactionId xmin; /* minimal running XID as it was when we were
* starting our xact, excluding LAZY VACUUM: * starting our xact, excluding LAZY VACUUM:
* vacuum must not remove tuples deleted by * vacuum must not remove tuples deleted by
...@@ -110,6 +127,9 @@ struct PGPROC ...@@ -110,6 +127,9 @@ struct PGPROC
* being executed by this proc, if running; * being executed by this proc, if running;
* else InvalidLocalTransactionId */ * else InvalidLocalTransactionId */
int pid; /* Backend's process ID; 0 if prepared xact */ int pid; /* Backend's process ID; 0 if prepared xact */
int pgxactoff; /* offset into various ProcGlobal->arrays
* with data mirrored from this PGPROC */
int pgprocno; int pgprocno;
/* These fields are zero while a backend is still starting up: */ /* These fields are zero while a backend is still starting up: */
...@@ -224,10 +244,6 @@ extern PGDLLIMPORT struct PGXACT *MyPgXact; ...@@ -224,10 +244,6 @@ extern PGDLLIMPORT struct PGXACT *MyPgXact;
*/ */
typedef struct PGXACT typedef struct PGXACT
{ {
TransactionId xid; /* id of top-level transaction currently being
* executed by this proc, if running and XID
* is assigned; else InvalidTransactionId */
uint8 vacuumFlags; /* vacuum-related flags, see above */ uint8 vacuumFlags; /* vacuum-related flags, see above */
bool overflowed; bool overflowed;
...@@ -236,6 +252,57 @@ typedef struct PGXACT ...@@ -236,6 +252,57 @@ typedef struct PGXACT
/* /*
* There is one ProcGlobal struct for the whole database cluster. * There is one ProcGlobal struct for the whole database cluster.
*
* Adding/Removing an entry into the procarray requires holding *both*
* ProcArrayLock and XidGenLock in exclusive mode (in that order). Both are
* needed because the dense arrays (see below) are accessed from
* GetNewTransactionId() and GetSnapshotData(), and we don't want to add
* further contention by both using the same lock. Adding/Removing a procarray
* entry is much less frequent.
*
* Some fields in PGPROC are mirrored into more densely packed arrays (e.g.
* xids), with one entry for each backend. These arrays only contain entries
* for PGPROCs that have been added to the shared array with ProcArrayAdd()
* (in contrast to PGPROC array which has unused PGPROCs interspersed).
*
* The dense arrays are indexed by PGPROC->pgxactoff. Any concurrent
* ProcArrayAdd() / ProcArrayRemove() can lead to pgxactoff of a procarray
* member to change. Therefore it is only safe to use PGPROC->pgxactoff to
* access the dense array while holding either ProcArrayLock or XidGenLock.
*
* As long as a PGPROC is in the procarray, the mirrored values need to be
* maintained in both places in a coherent manner.
*
* The denser separate arrays are beneficial for three main reasons: First, to
* allow for as tight loops accessing the data as possible. Second, to prevent
* updates of frequently changing data (e.g. xmin) from invalidating
* cachelines also containing less frequently changing data (e.g. xid,
* vacuumFlags). Third to condense frequently accessed data into as few
* cachelines as possible.
*
* There are two main reasons to have the data mirrored between these dense
* arrays and PGPROC. First, as explained above, a PGPROC's array entries can
* only be accessed with either ProcArrayLock or XidGenLock held, whereas the
* PGPROC entries do not require that (obviously there may still be locking
* requirements around the individual field, separate from the concerns
* here). That is particularly important for a backend to efficiently checks
* it own values, which it often can safely do without locking. Second, the
* PGPROC fields allow to avoid unnecessary accesses and modification to the
* dense arrays. A backend's own PGPROC is more likely to be in a local cache,
* whereas the cachelines for the dense array will be modified by other
* backends (often removing it from the cache for other cores/sockets). At
* commit/abort time a check of the PGPROC value can avoid accessing/dirtying
* the corresponding array value.
*
* Basically it makes sense to access the PGPROC variable when checking a
* single backend's data, especially when already looking at the PGPROC for
* other reasons already. It makes sense to look at the "dense" arrays if we
* need to look at many / most entries, because we then benefit from the
* reduced indirection and better cross-process cache-ability.
*
* When entering a PGPROC for 2PC transactions with ProcArrayAdd(), the data
* in the dense arrays is initialized from the PGPROC while it already holds
* ProcArrayLock.
*/ */
typedef struct PROC_HDR typedef struct PROC_HDR
{ {
...@@ -243,6 +310,10 @@ typedef struct PROC_HDR ...@@ -243,6 +310,10 @@ typedef struct PROC_HDR
PGPROC *allProcs; PGPROC *allProcs;
/* Array of PGXACT structures (not including dummies for prepared txns) */ /* Array of PGXACT structures (not including dummies for prepared txns) */
PGXACT *allPgXact; PGXACT *allPgXact;
/* Array mirroring PGPROC.xid for each PGPROC currently in the procarray */
TransactionId *xids;
/* Length of allProcs array */ /* Length of allProcs array */
uint32 allProcCount; uint32 allProcCount;
/* Head of list of free PGPROC structures */ /* Head of list of free PGPROC structures */
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment