PostgreSQL Source Code  git master
commit_ts.h File Reference
#include "access/xlog.h"
#include "datatype/timestamp.h"
#include "replication/origin.h"
#include "utils/guc.h"
Include dependency graph for commit_ts.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  xl_commit_ts_set
 
struct  xl_commit_ts_truncate
 

Macros

#define COMMIT_TS_ZEROPAGE   0x00
 
#define COMMIT_TS_TRUNCATE   0x10
 
#define COMMIT_TS_SETTS   0x20
 
#define SizeOfCommitTsSet
 
#define SizeOfCommitTsTruncate
 

Typedefs

typedef struct xl_commit_ts_set xl_commit_ts_set
 
typedef struct xl_commit_ts_truncate xl_commit_ts_truncate
 

Functions

bool check_track_commit_timestamp (bool *newval, void **extra, GucSource source)
 
void TransactionTreeSetCommitTsData (TransactionId xid, int nsubxids, TransactionId *subxids, TimestampTz timestamp, RepOriginId nodeid, bool write_xlog)
 
bool TransactionIdGetCommitTsData (TransactionId xid, TimestampTz *ts, RepOriginId *nodeid)
 
TransactionId GetLatestCommitTsData (TimestampTz *ts, RepOriginId *nodeid)
 
Size CommitTsShmemBuffers (void)
 
Size CommitTsShmemSize (void)
 
void CommitTsShmemInit (void)
 
void BootStrapCommitTs (void)
 
void StartupCommitTs (void)
 
void CommitTsParameterChange (bool xlrecvalue, bool pgcontrolvalue)
 
void CompleteCommitTsInitialization (void)
 
void ShutdownCommitTs (void)
 
void CheckPointCommitTs (void)
 
void ExtendCommitTs (TransactionId newestXact)
 
void TruncateCommitTs (TransactionId oldestXact)
 
void SetCommitTsLimit (TransactionId oldestXact, TransactionId newestXact)
 
void AdvanceOldestCommitTsXid (TransactionId oldestXact)
 
void commit_ts_redo (XLogReaderState *record)
 
void commit_ts_desc (StringInfo buf, XLogReaderState *record)
 
const char * commit_ts_identify (uint8 info)
 

Variables

PGDLLIMPORT bool track_commit_timestamp
 

Macro Definition Documentation

◆ COMMIT_TS_SETTS

#define COMMIT_TS_SETTS   0x20

◆ COMMIT_TS_TRUNCATE

#define COMMIT_TS_TRUNCATE   0x10

◆ COMMIT_TS_ZEROPAGE

#define COMMIT_TS_ZEROPAGE   0x00

◆ SizeOfCommitTsSet

#define SizeOfCommitTsSet
Value:
(offsetof(xl_commit_ts_set, mainxid) + \
sizeof(TransactionId))
uint32 TransactionId
Definition: c.h:455
#define offsetof(type, field)
Definition: c.h:603

Definition at line 61 of file commit_ts.h.

Referenced by commit_ts_desc(), and commit_ts_redo().

◆ SizeOfCommitTsTruncate

#define SizeOfCommitTsTruncate
Value:
sizeof(TransactionId))
uint32 TransactionId
Definition: c.h:455
#define offsetof(type, field)
Definition: c.h:603

Definition at line 70 of file commit_ts.h.

Referenced by WriteTruncateXlogRec().

Typedef Documentation

◆ xl_commit_ts_set

◆ xl_commit_ts_truncate

Function Documentation

◆ AdvanceOldestCommitTsXid()

void AdvanceOldestCommitTsXid ( TransactionId  oldestXact)

Definition at line 876 of file commit_ts.c.

References InvalidTransactionId, LW_EXCLUSIVE, LWLockAcquire(), LWLockRelease(), VariableCacheData::oldestCommitTsXid, ShmemVariableCache, and TransactionIdPrecedes().

Referenced by commit_ts_redo(), and vac_truncate_clog().

877 {
878  LWLockAcquire(CommitTsLock, LW_EXCLUSIVE);
882  LWLockRelease(CommitTsLock);
883 }
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
VariableCache ShmemVariableCache
Definition: varsup.c:34
#define InvalidTransactionId
Definition: transam.h:31
TransactionId oldestCommitTsXid
Definition: transam.h:129
bool TransactionIdPrecedes(TransactionId id1, TransactionId id2)
Definition: transam.c:300
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118

◆ BootStrapCommitTs()

void BootStrapCommitTs ( void  )

Definition at line 523 of file commit_ts.c.

Referenced by BootStrapXLOG().

524 {
525  /*
526  * Nothing to do here at present, unlike most other SLRU modules; segments
527  * are created when the server is started with this module enabled. See
528  * ActivateCommitTs.
529  */
530 }

◆ check_track_commit_timestamp()

bool check_track_commit_timestamp ( bool newval,
void **  extra,
GucSource  source 
)

◆ CheckPointCommitTs()

void CheckPointCommitTs ( void  )

Definition at line 761 of file commit_ts.c.

References CommitTsCtl, fsync_fname(), and SimpleLruFlush().

Referenced by CheckPointGuts().

762 {
763  /* Flush dirty CommitTs pages to disk */
765 
766  /*
767  * fsync pg_commit_ts to ensure that any files flushed previously are
768  * durably on disk.
769  */
770  fsync_fname("pg_commit_ts", true);
771 }
#define CommitTsCtl
Definition: commit_ts.c:79
void fsync_fname(const char *fname, bool isdir)
Definition: fd.c:581
void SimpleLruFlush(SlruCtl ctl, bool allow_redirtied)
Definition: slru.c:1103

◆ commit_ts_desc()

void commit_ts_desc ( StringInfo  buf,
XLogReaderState record 
)

Definition at line 22 of file committsdesc.c.

References appendStringInfo(), COMMIT_TS_SETTS, COMMIT_TS_TRUNCATE, COMMIT_TS_ZEROPAGE, i, xl_commit_ts_set::mainxid, xl_commit_ts_set::nodeid, xl_commit_ts_truncate::oldestXid, xl_commit_ts_truncate::pageno, palloc(), pfree(), SizeOfCommitTsSet, xl_commit_ts_set::timestamp, timestamptz_to_str(), XLogRecGetData, XLogRecGetDataLen, XLogRecGetInfo, and XLR_INFO_MASK.

23 {
24  char *rec = XLogRecGetData(record);
25  uint8 info = XLogRecGetInfo(record) & ~XLR_INFO_MASK;
26 
27  if (info == COMMIT_TS_ZEROPAGE)
28  {
29  int pageno;
30 
31  memcpy(&pageno, rec, sizeof(int));
32  appendStringInfo(buf, "%d", pageno);
33  }
34  else if (info == COMMIT_TS_TRUNCATE)
35  {
37 
38  appendStringInfo(buf, "pageno %d, oldestXid %u",
39  trunc->pageno, trunc->oldestXid);
40  }
41  else if (info == COMMIT_TS_SETTS)
42  {
43  xl_commit_ts_set *xlrec = (xl_commit_ts_set *) rec;
44  int nsubxids;
45 
46  appendStringInfo(buf, "set %s/%d for: %u",
48  xlrec->nodeid,
49  xlrec->mainxid);
50  nsubxids = ((XLogRecGetDataLen(record) - SizeOfCommitTsSet) /
51  sizeof(TransactionId));
52  if (nsubxids > 0)
53  {
54  int i;
55  TransactionId *subxids;
56 
57  subxids = palloc(sizeof(TransactionId) * nsubxids);
58  memcpy(subxids,
60  sizeof(TransactionId) * nsubxids);
61  for (i = 0; i < nsubxids; i++)
62  appendStringInfo(buf, ", %u", subxids[i]);
63  pfree(subxids);
64  }
65  }
66 }
#define COMMIT_TS_ZEROPAGE
Definition: commit_ts.h:49
#define COMMIT_TS_SETTS
Definition: commit_ts.h:51
uint32 TransactionId
Definition: c.h:455
unsigned char uint8
Definition: c.h:304
TimestampTz timestamp
Definition: commit_ts.h:55
void pfree(void *pointer)
Definition: mcxt.c:936
#define XLogRecGetData(decoder)
Definition: xlogreader.h:226
void appendStringInfo(StringInfo str, const char *fmt,...)
Definition: stringinfo.c:78
#define XLogRecGetDataLen(decoder)
Definition: xlogreader.h:227
#define SizeOfCommitTsSet
Definition: commit_ts.h:61
TransactionId oldestXid
Definition: commit_ts.h:67
#define XLogRecGetInfo(decoder)
Definition: xlogreader.h:222
#define COMMIT_TS_TRUNCATE
Definition: commit_ts.h:50
TransactionId mainxid
Definition: commit_ts.h:57
#define XLR_INFO_MASK
Definition: xlogrecord.h:62
void * palloc(Size size)
Definition: mcxt.c:835
RepOriginId nodeid
Definition: commit_ts.h:56
int i
const char * timestamptz_to_str(TimestampTz t)
Definition: timestamp.c:1710

◆ commit_ts_identify()

const char* commit_ts_identify ( uint8  info)

Definition at line 69 of file committsdesc.c.

References COMMIT_TS_SETTS, COMMIT_TS_TRUNCATE, and COMMIT_TS_ZEROPAGE.

70 {
71  switch (info)
72  {
73  case COMMIT_TS_ZEROPAGE:
74  return "ZEROPAGE";
75  case COMMIT_TS_TRUNCATE:
76  return "TRUNCATE";
77  case COMMIT_TS_SETTS:
78  return "SETTS";
79  default:
80  return NULL;
81  }
82 }
#define COMMIT_TS_ZEROPAGE
Definition: commit_ts.h:49
#define COMMIT_TS_SETTS
Definition: commit_ts.h:51
#define COMMIT_TS_TRUNCATE
Definition: commit_ts.h:50

◆ commit_ts_redo()

void commit_ts_redo ( XLogReaderState record)

Definition at line 963 of file commit_ts.c.

References AdvanceOldestCommitTsXid(), Assert, COMMIT_TS_SETTS, COMMIT_TS_TRUNCATE, COMMIT_TS_ZEROPAGE, CommitTsCtl, elog, LW_EXCLUSIVE, LWLockAcquire(), LWLockRelease(), xl_commit_ts_set::mainxid, xl_commit_ts_set::nodeid, xl_commit_ts_truncate::oldestXid, xl_commit_ts_truncate::pageno, palloc(), PANIC, pfree(), SimpleLruTruncate(), SimpleLruWritePage(), SizeOfCommitTsSet, xl_commit_ts_set::timestamp, TransactionTreeSetCommitTsData(), XLogRecGetData, XLogRecGetDataLen, XLogRecGetInfo, XLogRecHasAnyBlockRefs, XLR_INFO_MASK, and ZeroCommitTsPage().

964 {
965  uint8 info = XLogRecGetInfo(record) & ~XLR_INFO_MASK;
966 
967  /* Backup blocks are not used in commit_ts records */
968  Assert(!XLogRecHasAnyBlockRefs(record));
969 
970  if (info == COMMIT_TS_ZEROPAGE)
971  {
972  int pageno;
973  int slotno;
974 
975  memcpy(&pageno, XLogRecGetData(record), sizeof(int));
976 
977  LWLockAcquire(CommitTsControlLock, LW_EXCLUSIVE);
978 
979  slotno = ZeroCommitTsPage(pageno, false);
981  Assert(!CommitTsCtl->shared->page_dirty[slotno]);
982 
983  LWLockRelease(CommitTsControlLock);
984  }
985  else if (info == COMMIT_TS_TRUNCATE)
986  {
988 
990 
991  /*
992  * During XLOG replay, latest_page_number isn't set up yet; insert a
993  * suitable value to bypass the sanity test in SimpleLruTruncate.
994  */
995  CommitTsCtl->shared->latest_page_number = trunc->pageno;
996 
998  }
999  else if (info == COMMIT_TS_SETTS)
1000  {
1001  xl_commit_ts_set *setts = (xl_commit_ts_set *) XLogRecGetData(record);
1002  int nsubxids;
1003  TransactionId *subxids;
1004 
1005  nsubxids = ((XLogRecGetDataLen(record) - SizeOfCommitTsSet) /
1006  sizeof(TransactionId));
1007  if (nsubxids > 0)
1008  {
1009  subxids = palloc(sizeof(TransactionId) * nsubxids);
1010  memcpy(subxids,
1012  sizeof(TransactionId) * nsubxids);
1013  }
1014  else
1015  subxids = NULL;
1016 
1017  TransactionTreeSetCommitTsData(setts->mainxid, nsubxids, subxids,
1018  setts->timestamp, setts->nodeid, true);
1019  if (subxids)
1020  pfree(subxids);
1021  }
1022  else
1023  elog(PANIC, "commit_ts_redo: unknown op code %u", info);
1024 }
#define COMMIT_TS_ZEROPAGE
Definition: commit_ts.h:49
#define COMMIT_TS_SETTS
Definition: commit_ts.h:51
uint32 TransactionId
Definition: c.h:455
#define CommitTsCtl
Definition: commit_ts.c:79
static int ZeroCommitTsPage(int pageno, bool writeXlog)
Definition: commit_ts.c:542
void SimpleLruTruncate(SlruCtl ctl, int cutoffPage)
Definition: slru.c:1168
unsigned char uint8
Definition: c.h:304
#define PANIC
Definition: elog.h:53
void AdvanceOldestCommitTsXid(TransactionId oldestXact)
Definition: commit_ts.c:876
TimestampTz timestamp
Definition: commit_ts.h:55
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
void pfree(void *pointer)
Definition: mcxt.c:936
#define XLogRecGetData(decoder)
Definition: xlogreader.h:226
#define XLogRecGetDataLen(decoder)
Definition: xlogreader.h:227
#define SizeOfCommitTsSet
Definition: commit_ts.h:61
TransactionId oldestXid
Definition: commit_ts.h:67
void SimpleLruWritePage(SlruCtl ctl, int slotno)
Definition: slru.c:578
#define XLogRecGetInfo(decoder)
Definition: xlogreader.h:222
#define COMMIT_TS_TRUNCATE
Definition: commit_ts.h:50
TransactionId mainxid
Definition: commit_ts.h:57
#define Assert(condition)
Definition: c.h:680
#define XLR_INFO_MASK
Definition: xlogrecord.h:62
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
void * palloc(Size size)
Definition: mcxt.c:835
RepOriginId nodeid
Definition: commit_ts.h:56
#define XLogRecHasAnyBlockRefs(decoder)
Definition: xlogreader.h:228
#define elog
Definition: elog.h:219
void TransactionTreeSetCommitTsData(TransactionId xid, int nsubxids, TransactionId *subxids, TimestampTz timestamp, RepOriginId nodeid, bool write_xlog)
Definition: commit_ts.c:145

◆ CommitTsParameterChange()

void CommitTsParameterChange ( bool  xlrecvalue,
bool  pgcontrolvalue 
)

Definition at line 592 of file commit_ts.c.

References ActivateCommitTs(), CommitTimestampShared::commitTsActive, and DeactivateCommitTs().

Referenced by xlog_redo().

593 {
594  /*
595  * If the commit_ts module is disabled in this server and we get word from
596  * the master server that it is enabled there, activate it so that we can
597  * replay future WAL records involving it; also mark it as active on
598  * pg_control. If the old value was already set, we already did this, so
599  * don't do anything.
600  *
601  * If the module is disabled in the master, disable it here too, unless
602  * the module is enabled locally.
603  *
604  * Note this only runs in the recovery process, so an unlocked read is
605  * fine.
606  */
607  if (newvalue)
608  {
611  }
612  else if (commitTsShared->commitTsActive)
614 }
static void ActivateCommitTs(void)
Definition: commit_ts.c:633
static void DeactivateCommitTs(void)
Definition: commit_ts.c:707
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99

◆ CommitTsShmemBuffers()

Size CommitTsShmemBuffers ( void  )

Definition at line 470 of file commit_ts.c.

References Max, Min, and NBuffers.

Referenced by CommitTsShmemInit(), and CommitTsShmemSize().

471 {
472  return Min(16, Max(4, NBuffers / 1024));
473 }
#define Min(x, y)
Definition: c.h:812
#define Max(x, y)
Definition: c.h:806
int NBuffers
Definition: globals.c:122

◆ CommitTsShmemInit()

void CommitTsShmemInit ( void  )

Definition at line 490 of file commit_ts.c.

References Assert, CommitTimestampShared::commitTsActive, CommitTsCtl, CommitTsPagePrecedes(), CommitTsShmemBuffers(), CommitTimestampShared::dataLastCommit, InvalidRepOriginId, InvalidTransactionId, IsUnderPostmaster, LWTRANCHE_COMMITTS_BUFFERS, CommitTimestampEntry::nodeid, ShmemInitStruct(), SimpleLruInit(), CommitTimestampEntry::time, TIMESTAMP_NOBEGIN, and CommitTimestampShared::xidLastCommit.

Referenced by CreateSharedMemoryAndSemaphores().

491 {
492  bool found;
493 
494  CommitTsCtl->PagePrecedes = CommitTsPagePrecedes;
495  SimpleLruInit(CommitTsCtl, "commit_timestamp", CommitTsShmemBuffers(), 0,
496  CommitTsControlLock, "pg_commit_ts",
498 
499  commitTsShared = ShmemInitStruct("CommitTs shared",
500  sizeof(CommitTimestampShared),
501  &found);
502 
503  if (!IsUnderPostmaster)
504  {
505  Assert(!found);
506 
511  }
512  else
513  Assert(found);
514 }
CommitTimestampEntry dataLastCommit
Definition: commit_ts.c:95
#define CommitTsCtl
Definition: commit_ts.c:79
Size CommitTsShmemBuffers(void)
Definition: commit_ts.c:470
void * ShmemInitStruct(const char *name, Size size, bool *foundPtr)
Definition: shmem.c:372
bool IsUnderPostmaster
Definition: globals.c:101
#define InvalidTransactionId
Definition: transam.h:31
#define TIMESTAMP_NOBEGIN(j)
Definition: timestamp.h:112
TimestampTz time
Definition: commit_ts.c:59
static bool CommitTsPagePrecedes(int page1, int page2)
Definition: commit_ts.c:896
TransactionId xidLastCommit
Definition: commit_ts.c:94
#define Assert(condition)
Definition: c.h:680
#define InvalidRepOriginId
Definition: origin.h:34
RepOriginId nodeid
Definition: commit_ts.c:60
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99
void SimpleLruInit(SlruCtl ctl, const char *name, int nslots, int nlsns, LWLock *ctllock, const char *subdir, int tranche_id)
Definition: slru.c:165

◆ CommitTsShmemSize()

Size CommitTsShmemSize ( void  )

Definition at line 479 of file commit_ts.c.

References CommitTsShmemBuffers(), and SimpleLruShmemSize().

Referenced by CreateSharedMemoryAndSemaphores().

480 {
482  sizeof(CommitTimestampShared);
483 }
Size SimpleLruShmemSize(int nslots, int nlsns)
Definition: slru.c:145
Size CommitTsShmemBuffers(void)
Definition: commit_ts.c:470
struct CommitTimestampShared CommitTimestampShared

◆ CompleteCommitTsInitialization()

void CompleteCommitTsInitialization ( void  )

Definition at line 569 of file commit_ts.c.

References ActivateCommitTs(), DeactivateCommitTs(), and track_commit_timestamp.

Referenced by StartupXLOG().

570 {
571  /*
572  * If the feature is not enabled, turn it off for good. This also removes
573  * any leftover data.
574  *
575  * Conversely, we activate the module if the feature is enabled. This is
576  * not necessary in a master system because we already did it earlier, but
577  * if we're in a standby server that got promoted which had the feature
578  * enabled and was following a master that had the feature disabled, this
579  * is where we turn it on locally.
580  */
583  else
585 }
bool track_commit_timestamp
Definition: commit_ts.c:103
static void ActivateCommitTs(void)
Definition: commit_ts.c:633
static void DeactivateCommitTs(void)
Definition: commit_ts.c:707

◆ ExtendCommitTs()

void ExtendCommitTs ( TransactionId  newestXact)

Definition at line 785 of file commit_ts.c.

References Assert, CommitTimestampShared::commitTsActive, FirstNormalTransactionId, InRecovery, LW_EXCLUSIVE, LWLockAcquire(), LWLockRelease(), TransactionIdEquals, TransactionIdToCTsEntry, TransactionIdToCTsPage, and ZeroCommitTsPage().

Referenced by GetNewTransactionId().

786 {
787  int pageno;
788 
789  /*
790  * Nothing to do if module not enabled. Note we do an unlocked read of
791  * the flag here, which is okay because this routine is only called from
792  * GetNewTransactionId, which is never called in a standby.
793  */
794  Assert(!InRecovery);
796  return;
797 
798  /*
799  * No work except at first XID of a page. But beware: just after
800  * wraparound, the first XID of page zero is FirstNormalTransactionId.
801  */
802  if (TransactionIdToCTsEntry(newestXact) != 0 &&
804  return;
805 
806  pageno = TransactionIdToCTsPage(newestXact);
807 
808  LWLockAcquire(CommitTsControlLock, LW_EXCLUSIVE);
809 
810  /* Zero the page and make an XLOG entry about it */
811  ZeroCommitTsPage(pageno, !InRecovery);
812 
813  LWLockRelease(CommitTsControlLock);
814 }
#define TransactionIdEquals(id1, id2)
Definition: transam.h:43
static int ZeroCommitTsPage(int pageno, bool writeXlog)
Definition: commit_ts.c:542
bool InRecovery
Definition: xlog.c:194
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
#define FirstNormalTransactionId
Definition: transam.h:34
#define TransactionIdToCTsPage(xid)
Definition: commit_ts.c:69
#define Assert(condition)
Definition: c.h:680
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
#define TransactionIdToCTsEntry(xid)
Definition: commit_ts.c:71
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99

◆ GetLatestCommitTsData()

TransactionId GetLatestCommitTsData ( TimestampTz ts,
RepOriginId nodeid 
)

Definition at line 368 of file commit_ts.c.

References CommitTimestampShared::commitTsActive, CommitTimestampShared::dataLastCommit, error_commit_ts_disabled(), LW_SHARED, LWLockAcquire(), LWLockRelease(), CommitTimestampEntry::nodeid, CommitTimestampEntry::time, and CommitTimestampShared::xidLastCommit.

Referenced by pg_last_committed_xact().

369 {
370  TransactionId xid;
371 
372  LWLockAcquire(CommitTsLock, LW_SHARED);
373 
374  /* Error if module not enabled */
377 
379  if (ts)
381  if (nodeid)
383  LWLockRelease(CommitTsLock);
384 
385  return xid;
386 }
CommitTimestampEntry dataLastCommit
Definition: commit_ts.c:95
uint32 TransactionId
Definition: c.h:455
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
TimestampTz time
Definition: commit_ts.c:59
TransactionId xidLastCommit
Definition: commit_ts.c:94
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
RepOriginId nodeid
Definition: commit_ts.c:60
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99
static void error_commit_ts_disabled(void)
Definition: commit_ts.c:389

◆ SetCommitTsLimit()

void SetCommitTsLimit ( TransactionId  oldestXact,
TransactionId  newestXact 
)

Definition at line 849 of file commit_ts.c.

References Assert, InvalidTransactionId, LW_EXCLUSIVE, LWLockAcquire(), LWLockRelease(), VariableCacheData::newestCommitTsXid, VariableCacheData::oldestCommitTsXid, ShmemVariableCache, and TransactionIdPrecedes().

Referenced by BootStrapXLOG(), and StartupXLOG().

850 {
851  /*
852  * Be careful not to overwrite values that are either further into the
853  * "future" or signal a disabled committs.
854  */
855  LWLockAcquire(CommitTsLock, LW_EXCLUSIVE);
857  {
862  }
863  else
864  {
868  }
869  LWLockRelease(CommitTsLock);
870 }
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
VariableCache ShmemVariableCache
Definition: varsup.c:34
#define InvalidTransactionId
Definition: transam.h:31
TransactionId oldestCommitTsXid
Definition: transam.h:129
bool TransactionIdPrecedes(TransactionId id1, TransactionId id2)
Definition: transam.c:300
#define Assert(condition)
Definition: c.h:680
TransactionId newestCommitTsXid
Definition: transam.h:130
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118

◆ ShutdownCommitTs()

void ShutdownCommitTs ( void  )

Definition at line 745 of file commit_ts.c.

References CommitTsCtl, fsync_fname(), and SimpleLruFlush().

Referenced by ShutdownXLOG().

746 {
747  /* Flush dirty CommitTs pages to disk */
748  SimpleLruFlush(CommitTsCtl, false);
749 
750  /*
751  * fsync pg_commit_ts to ensure that any files flushed previously are
752  * durably on disk.
753  */
754  fsync_fname("pg_commit_ts", true);
755 }
#define CommitTsCtl
Definition: commit_ts.c:79
void fsync_fname(const char *fname, bool isdir)
Definition: fd.c:581
void SimpleLruFlush(SlruCtl ctl, bool allow_redirtied)
Definition: slru.c:1103

◆ StartupCommitTs()

void StartupCommitTs ( void  )

Definition at line 559 of file commit_ts.c.

References ActivateCommitTs().

Referenced by StartupXLOG().

560 {
562 }
static void ActivateCommitTs(void)
Definition: commit_ts.c:633

◆ TransactionIdGetCommitTsData()

bool TransactionIdGetCommitTsData ( TransactionId  xid,
TimestampTz ts,
RepOriginId nodeid 
)

Definition at line 282 of file commit_ts.c.

References Assert, CommitTimestampShared::commitTsActive, CommitTsCtl, CommitTimestampShared::dataLastCommit, ereport, errcode(), errmsg(), ERROR, error_commit_ts_disabled(), InvalidRepOriginId, LW_SHARED, LWLockAcquire(), LWLockRelease(), VariableCacheData::newestCommitTsXid, CommitTimestampEntry::nodeid, VariableCacheData::oldestCommitTsXid, ShmemVariableCache, SimpleLruReadPage_ReadOnly(), SizeOfCommitTimestampEntry, CommitTimestampEntry::time, TransactionIdIsNormal, TransactionIdIsValid, TransactionIdPrecedes(), TransactionIdToCTsEntry, TransactionIdToCTsPage, and CommitTimestampShared::xidLastCommit.

Referenced by pg_xact_commit_timestamp().

284 {
285  int pageno = TransactionIdToCTsPage(xid);
286  int entryno = TransactionIdToCTsEntry(xid);
287  int slotno;
288  CommitTimestampEntry entry;
289  TransactionId oldestCommitTsXid;
290  TransactionId newestCommitTsXid;
291 
292  if (!TransactionIdIsValid(xid))
293  ereport(ERROR,
294  (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
295  errmsg("cannot retrieve commit timestamp for transaction %u", xid)));
296  else if (!TransactionIdIsNormal(xid))
297  {
298  /* frozen and bootstrap xids are always committed far in the past */
299  *ts = 0;
300  if (nodeid)
301  *nodeid = 0;
302  return false;
303  }
304 
305  LWLockAcquire(CommitTsLock, LW_SHARED);
306 
307  /* Error if module not enabled */
310 
311  /*
312  * If we're asked for the cached value, return that. Otherwise, fall
313  * through to read from SLRU.
314  */
315  if (commitTsShared->xidLastCommit == xid)
316  {
318  if (nodeid)
320 
321  LWLockRelease(CommitTsLock);
322  return *ts != 0;
323  }
324 
325  oldestCommitTsXid = ShmemVariableCache->oldestCommitTsXid;
326  newestCommitTsXid = ShmemVariableCache->newestCommitTsXid;
327  /* neither is invalid, or both are */
328  Assert(TransactionIdIsValid(oldestCommitTsXid) == TransactionIdIsValid(newestCommitTsXid));
329  LWLockRelease(CommitTsLock);
330 
331  /*
332  * Return empty if the requested value is outside our valid range.
333  */
334  if (!TransactionIdIsValid(oldestCommitTsXid) ||
335  TransactionIdPrecedes(xid, oldestCommitTsXid) ||
336  TransactionIdPrecedes(newestCommitTsXid, xid))
337  {
338  *ts = 0;
339  if (nodeid)
340  *nodeid = InvalidRepOriginId;
341  return false;
342  }
343 
344  /* lock is acquired by SimpleLruReadPage_ReadOnly */
345  slotno = SimpleLruReadPage_ReadOnly(CommitTsCtl, pageno, xid);
346  memcpy(&entry,
347  CommitTsCtl->shared->page_buffer[slotno] +
348  SizeOfCommitTimestampEntry * entryno,
350 
351  *ts = entry.time;
352  if (nodeid)
353  *nodeid = entry.nodeid;
354 
355  LWLockRelease(CommitTsControlLock);
356  return *ts != 0;
357 }
CommitTimestampEntry dataLastCommit
Definition: commit_ts.c:95
uint32 TransactionId
Definition: c.h:455
#define SizeOfCommitTimestampEntry
Definition: commit_ts.c:63
#define CommitTsCtl
Definition: commit_ts.c:79
int errcode(int sqlerrcode)
Definition: elog.c:575
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
#define ERROR
Definition: elog.h:43
VariableCache ShmemVariableCache
Definition: varsup.c:34
#define ereport(elevel, rest)
Definition: elog.h:122
TransactionId oldestCommitTsXid
Definition: transam.h:129
bool TransactionIdPrecedes(TransactionId id1, TransactionId id2)
Definition: transam.c:300
TimestampTz time
Definition: commit_ts.c:59
#define TransactionIdToCTsPage(xid)
Definition: commit_ts.c:69
TransactionId xidLastCommit
Definition: commit_ts.c:94
int SimpleLruReadPage_ReadOnly(SlruCtl ctl, int pageno, TransactionId xid)
Definition: slru.c:467
#define Assert(condition)
Definition: c.h:680
TransactionId newestCommitTsXid
Definition: transam.h:130
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
#define TransactionIdToCTsEntry(xid)
Definition: commit_ts.c:71
#define InvalidRepOriginId
Definition: origin.h:34
int errmsg(const char *fmt,...)
Definition: elog.c:797
#define TransactionIdIsValid(xid)
Definition: transam.h:41
#define TransactionIdIsNormal(xid)
Definition: transam.h:42
RepOriginId nodeid
Definition: commit_ts.c:60
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99
static void error_commit_ts_disabled(void)
Definition: commit_ts.c:389

◆ TransactionTreeSetCommitTsData()

void TransactionTreeSetCommitTsData ( TransactionId  xid,
int  nsubxids,
TransactionId subxids,
TimestampTz  timestamp,
RepOriginId  nodeid,
bool  write_xlog 
)

Definition at line 145 of file commit_ts.c.

References CommitTimestampShared::commitTsActive, CommitTimestampShared::dataLastCommit, i, LW_EXCLUSIVE, LWLockAcquire(), LWLockRelease(), VariableCacheData::newestCommitTsXid, CommitTimestampEntry::nodeid, SetXidCommitTsInPage(), ShmemVariableCache, CommitTimestampEntry::time, TransactionIdPrecedes(), TransactionIdToCTsPage, WriteSetTimestampXlogRec(), and CommitTimestampShared::xidLastCommit.

Referenced by commit_ts_redo(), RecordTransactionCommit(), RecordTransactionCommitPrepared(), and xact_redo_commit().

148 {
149  int i;
150  TransactionId headxid;
151  TransactionId newestXact;
152 
153  /*
154  * No-op if the module is not active.
155  *
156  * An unlocked read here is fine, because in a standby (the only place
157  * where the flag can change in flight) this routine is only called by the
158  * recovery process, which is also the only process which can change the
159  * flag.
160  */
162  return;
163 
164  /*
165  * Comply with the WAL-before-data rule: if caller specified it wants this
166  * value to be recorded in WAL, do so before touching the data.
167  */
168  if (write_xlog)
169  WriteSetTimestampXlogRec(xid, nsubxids, subxids, timestamp, nodeid);
170 
171  /*
172  * Figure out the latest Xid in this batch: either the last subxid if
173  * there's any, otherwise the parent xid.
174  */
175  if (nsubxids > 0)
176  newestXact = subxids[nsubxids - 1];
177  else
178  newestXact = xid;
179 
180  /*
181  * We split the xids to set the timestamp to in groups belonging to the
182  * same SLRU page; the first element in each such set is its head. The
183  * first group has the main XID as the head; subsequent sets use the first
184  * subxid not on the previous page as head. This way, we only have to
185  * lock/modify each SLRU page once.
186  */
187  for (i = 0, headxid = xid;;)
188  {
189  int pageno = TransactionIdToCTsPage(headxid);
190  int j;
191 
192  for (j = i; j < nsubxids; j++)
193  {
194  if (TransactionIdToCTsPage(subxids[j]) != pageno)
195  break;
196  }
197  /* subxids[i..j] are on the same page as the head */
198 
199  SetXidCommitTsInPage(headxid, j - i, subxids + i, timestamp, nodeid,
200  pageno);
201 
202  /* if we wrote out all subxids, we're done. */
203  if (j + 1 >= nsubxids)
204  break;
205 
206  /*
207  * Set the new head and skip over it, as well as over the subxids we
208  * just wrote.
209  */
210  headxid = subxids[j];
211  i += j - i + 1;
212  }
213 
214  /* update the cached value in shared memory */
215  LWLockAcquire(CommitTsLock, LW_EXCLUSIVE);
219 
220  /* and move forwards our endpoint, if needed */
223  LWLockRelease(CommitTsLock);
224 }
CommitTimestampEntry dataLastCommit
Definition: commit_ts.c:95
uint32 TransactionId
Definition: c.h:455
static void WriteSetTimestampXlogRec(TransactionId mainxid, int nsubxids, TransactionId *subxids, TimestampTz timestamp, RepOriginId nodeid)
Definition: commit_ts.c:941
int64 timestamp
static void SetXidCommitTsInPage(TransactionId xid, int nsubxids, TransactionId *subxids, TimestampTz ts, RepOriginId nodeid, int pageno)
Definition: commit_ts.c:231
void LWLockRelease(LWLock *lock)
Definition: lwlock.c:1722
VariableCache ShmemVariableCache
Definition: varsup.c:34
bool TransactionIdPrecedes(TransactionId id1, TransactionId id2)
Definition: transam.c:300
TimestampTz time
Definition: commit_ts.c:59
#define TransactionIdToCTsPage(xid)
Definition: commit_ts.c:69
TransactionId xidLastCommit
Definition: commit_ts.c:94
TransactionId newestCommitTsXid
Definition: transam.h:130
bool LWLockAcquire(LWLock *lock, LWLockMode mode)
Definition: lwlock.c:1118
int i
RepOriginId nodeid
Definition: commit_ts.c:60
CommitTimestampShared * commitTsShared
Definition: commit_ts.c:99

◆ TruncateCommitTs()

void TruncateCommitTs ( TransactionId  oldestXact)

Definition at line 823 of file commit_ts.c.

References CommitTsCtl, SimpleLruTruncate(), SlruScanDirCbReportPresence(), SlruScanDirectory(), TransactionIdToCTsPage, and WriteTruncateXlogRec().

Referenced by vac_truncate_clog().

824 {
825  int cutoffPage;
826 
827  /*
828  * The cutoff point is the start of the segment containing oldestXact. We
829  * pass the *page* containing oldestXact to SimpleLruTruncate.
830  */
831  cutoffPage = TransactionIdToCTsPage(oldestXact);
832 
833  /* Check to see if there's any files that could be removed */
835  &cutoffPage))
836  return; /* nothing to remove */
837 
838  /* Write XLOG record */
839  WriteTruncateXlogRec(cutoffPage, oldestXact);
840 
841  /* Now we can remove the old CommitTs segment(s) */
842  SimpleLruTruncate(CommitTsCtl, cutoffPage);
843 }
#define CommitTsCtl
Definition: commit_ts.c:79
void SimpleLruTruncate(SlruCtl ctl, int cutoffPage)
Definition: slru.c:1168
static void WriteTruncateXlogRec(int pageno, TransactionId oldestXid)
Definition: commit_ts.c:925
bool SlruScanDirCbReportPresence(SlruCtl ctl, char *filename, int segpage, void *data)
Definition: slru.c:1321
#define TransactionIdToCTsPage(xid)
Definition: commit_ts.c:69
bool SlruScanDirectory(SlruCtl ctl, SlruScanCallback callback, void *data)
Definition: slru.c:1376

Variable Documentation

◆ track_commit_timestamp

PGDLLIMPORT bool track_commit_timestamp