PostgreSQL Source Code  git master
pg_subscription_rel.h File Reference
#include "access/xlogdefs.h"
#include "catalog/genbki.h"
#include "catalog/pg_subscription_rel_d.h"
#include "nodes/pg_list.h"
Include dependency graph for pg_subscription_rel.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  SubscriptionRelState
 

Typedefs

typedef FormData_pg_subscription_relForm_pg_subscription_rel
 
typedef struct SubscriptionRelState SubscriptionRelState
 

Functions

 CATALOG (pg_subscription_rel, 6102, SubscriptionRelRelationId)
 
void AddSubscriptionRelState (Oid subid, Oid relid, char state, XLogRecPtr sublsn)
 
void UpdateSubscriptionRelState (Oid subid, Oid relid, char state, XLogRecPtr sublsn)
 
char GetSubscriptionRelState (Oid subid, Oid relid, XLogRecPtr *sublsn, bool missing_ok)
 
void RemoveSubscriptionRel (Oid subid, Oid relid)
 
ListGetSubscriptionRelations (Oid subid)
 
ListGetSubscriptionNotReadyRelations (Oid subid)
 

Variables

 FormData_pg_subscription_rel
 

Typedef Documentation

◆ Form_pg_subscription_rel

◆ SubscriptionRelState

Function Documentation

◆ AddSubscriptionRelState()

void AddSubscriptionRelState ( Oid  subid,
Oid  relid,
char  state,
XLogRecPtr  sublsn 
)

Definition at line 235 of file pg_subscription.c.

References AccessShareLock, CatalogTupleInsert(), CharGetDatum, elog, ERROR, heap_form_tuple(), heap_freetuple(), HeapTupleIsValid, InvalidXLogRecPtr, LockSharedObject(), LSNGetDatum, NoLock, ObjectIdGetDatum, RelationGetDescr, RowExclusiveLock, SearchSysCacheCopy2, SUBSCRIPTIONRELMAP, table_close(), table_open(), and values.

Referenced by AlterSubscription_refresh(), and CreateSubscription().

237 {
238  Relation rel;
239  HeapTuple tup;
240  bool nulls[Natts_pg_subscription_rel];
241  Datum values[Natts_pg_subscription_rel];
242 
243  LockSharedObject(SubscriptionRelationId, subid, 0, AccessShareLock);
244 
245  rel = table_open(SubscriptionRelRelationId, RowExclusiveLock);
246 
247  /* Try finding existing mapping. */
249  ObjectIdGetDatum(relid),
250  ObjectIdGetDatum(subid));
251  if (HeapTupleIsValid(tup))
252  elog(ERROR, "subscription table %u in subscription %u already exists",
253  relid, subid);
254 
255  /* Form the tuple. */
256  memset(values, 0, sizeof(values));
257  memset(nulls, false, sizeof(nulls));
258  values[Anum_pg_subscription_rel_srsubid - 1] = ObjectIdGetDatum(subid);
259  values[Anum_pg_subscription_rel_srrelid - 1] = ObjectIdGetDatum(relid);
260  values[Anum_pg_subscription_rel_srsubstate - 1] = CharGetDatum(state);
261  if (sublsn != InvalidXLogRecPtr)
262  values[Anum_pg_subscription_rel_srsublsn - 1] = LSNGetDatum(sublsn);
263  else
264  nulls[Anum_pg_subscription_rel_srsublsn - 1] = true;
265 
266  tup = heap_form_tuple(RelationGetDescr(rel), values, nulls);
267 
268  /* Insert tuple into catalog. */
269  CatalogTupleInsert(rel, tup);
270 
271  heap_freetuple(tup);
272 
273  /* Cleanup. */
274  table_close(rel, NoLock);
275 }
#define InvalidXLogRecPtr
Definition: xlogdefs.h:28
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
#define RelationGetDescr(relation)
Definition: rel.h:454
#define AccessShareLock
Definition: lockdefs.h:36
#define LSNGetDatum(X)
Definition: pg_lsn.h:22
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, Datum *values, bool *isnull)
Definition: heaptuple.c:1020
void heap_freetuple(HeapTuple htup)
Definition: heaptuple.c:1338
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
#define NoLock
Definition: lockdefs.h:34
#define RowExclusiveLock
Definition: lockdefs.h:38
uintptr_t Datum
Definition: postgres.h:367
void LockSharedObject(Oid classid, Oid objid, uint16 objsubid, LOCKMODE lockmode)
Definition: lmgr.c:1002
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
Definition: regguts.h:298
#define CharGetDatum(X)
Definition: postgres.h:416
static Datum values[MAXATTR]
Definition: bootstrap.c:167
#define elog(elevel,...)
Definition: elog.h:228
#define SearchSysCacheCopy2(cacheId, key1, key2)
Definition: syscache.h:176
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
void CatalogTupleInsert(Relation heapRel, HeapTuple tup)
Definition: indexing.c:183

◆ CATALOG()

CATALOG ( pg_subscription_rel  ,
6102  ,
SubscriptionRelRelationId   
)

Definition at line 31 of file pg_subscription_rel.h.

32 {
33  Oid srsubid; /* Oid of subscription */
34  Oid srrelid; /* Oid of relation */
35  char srsubstate; /* state of the relation in subscription */
36  XLogRecPtr srsublsn; /* remote lsn of the state change used for
37  * synchronization coordination */
unsigned int Oid
Definition: postgres_ext.h:31
FormData_pg_subscription_rel
uint64 XLogRecPtr
Definition: xlogdefs.h:21

◆ GetSubscriptionNotReadyRelations()

List* GetSubscriptionNotReadyRelations ( Oid  subid)

Definition at line 478 of file pg_subscription.c.

References AccessShareLock, BTEqualStrategyNumber, CharGetDatum, GETSTRUCT, HeapTupleIsValid, InvalidOid, lappend(), SubscriptionRelState::lsn, NIL, ObjectIdGetDatum, palloc(), SubscriptionRelState::relid, ScanKeyInit(), SubscriptionRelState::state, systable_beginscan(), systable_endscan(), systable_getnext(), table_close(), and table_open().

Referenced by process_syncing_tables_for_apply().

479 {
480  List *res = NIL;
481  Relation rel;
482  HeapTuple tup;
483  int nkeys = 0;
484  ScanKeyData skey[2];
485  SysScanDesc scan;
486 
487  rel = table_open(SubscriptionRelRelationId, AccessShareLock);
488 
489  ScanKeyInit(&skey[nkeys++],
490  Anum_pg_subscription_rel_srsubid,
491  BTEqualStrategyNumber, F_OIDEQ,
492  ObjectIdGetDatum(subid));
493 
494  ScanKeyInit(&skey[nkeys++],
495  Anum_pg_subscription_rel_srsubstate,
496  BTEqualStrategyNumber, F_CHARNE,
497  CharGetDatum(SUBREL_STATE_READY));
498 
499  scan = systable_beginscan(rel, InvalidOid, false,
500  NULL, nkeys, skey);
501 
502  while (HeapTupleIsValid(tup = systable_getnext(scan)))
503  {
505  SubscriptionRelState *relstate;
506 
507  subrel = (Form_pg_subscription_rel) GETSTRUCT(tup);
508 
509  relstate = (SubscriptionRelState *) palloc(sizeof(SubscriptionRelState));
510  relstate->relid = subrel->srrelid;
511  relstate->state = subrel->srsubstate;
512  relstate->lsn = subrel->srsublsn;
513 
514  res = lappend(res, relstate);
515  }
516 
517  /* Cleanup */
518  systable_endscan(scan);
520 
521  return res;
522 }
#define NIL
Definition: pg_list.h:65
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
void systable_endscan(SysScanDesc sysscan)
Definition: genam.c:525
#define GETSTRUCT(TUP)
Definition: htup_details.h:655
#define AccessShareLock
Definition: lockdefs.h:36
SysScanDesc systable_beginscan(Relation heapRelation, Oid indexId, bool indexOK, Snapshot snapshot, int nkeys, ScanKey key)
Definition: genam.c:352
HeapTuple systable_getnext(SysScanDesc sysscan)
Definition: genam.c:444
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
List * lappend(List *list, void *datum)
Definition: list.c:322
#define InvalidOid
Definition: postgres_ext.h:36
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
FormData_pg_subscription_rel * Form_pg_subscription_rel
#define CharGetDatum(X)
Definition: postgres.h:416
void * palloc(Size size)
Definition: mcxt.c:949
void ScanKeyInit(ScanKey entry, AttrNumber attributeNumber, StrategyNumber strategy, RegProcedure procedure, Datum argument)
Definition: scankey.c:76
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
Definition: pg_list.h:50
#define BTEqualStrategyNumber
Definition: stratnum.h:31

◆ GetSubscriptionRelations()

List* GetSubscriptionRelations ( Oid  subid)

Definition at line 431 of file pg_subscription.c.

References AccessShareLock, BTEqualStrategyNumber, GETSTRUCT, HeapTupleIsValid, InvalidOid, lappend(), SubscriptionRelState::lsn, NIL, ObjectIdGetDatum, palloc(), SubscriptionRelState::relid, ScanKeyInit(), SubscriptionRelState::state, systable_beginscan(), systable_endscan(), systable_getnext(), table_close(), and table_open().

Referenced by AlterSubscription_refresh().

432 {
433  List *res = NIL;
434  Relation rel;
435  HeapTuple tup;
436  int nkeys = 0;
437  ScanKeyData skey[2];
438  SysScanDesc scan;
439 
440  rel = table_open(SubscriptionRelRelationId, AccessShareLock);
441 
442  ScanKeyInit(&skey[nkeys++],
443  Anum_pg_subscription_rel_srsubid,
444  BTEqualStrategyNumber, F_OIDEQ,
445  ObjectIdGetDatum(subid));
446 
447  scan = systable_beginscan(rel, InvalidOid, false,
448  NULL, nkeys, skey);
449 
450  while (HeapTupleIsValid(tup = systable_getnext(scan)))
451  {
453  SubscriptionRelState *relstate;
454 
455  subrel = (Form_pg_subscription_rel) GETSTRUCT(tup);
456 
457  relstate = (SubscriptionRelState *) palloc(sizeof(SubscriptionRelState));
458  relstate->relid = subrel->srrelid;
459  relstate->state = subrel->srsubstate;
460  relstate->lsn = subrel->srsublsn;
461 
462  res = lappend(res, relstate);
463  }
464 
465  /* Cleanup */
466  systable_endscan(scan);
468 
469  return res;
470 }
#define NIL
Definition: pg_list.h:65
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
void systable_endscan(SysScanDesc sysscan)
Definition: genam.c:525
#define GETSTRUCT(TUP)
Definition: htup_details.h:655
#define AccessShareLock
Definition: lockdefs.h:36
SysScanDesc systable_beginscan(Relation heapRelation, Oid indexId, bool indexOK, Snapshot snapshot, int nkeys, ScanKey key)
Definition: genam.c:352
HeapTuple systable_getnext(SysScanDesc sysscan)
Definition: genam.c:444
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
List * lappend(List *list, void *datum)
Definition: list.c:322
#define InvalidOid
Definition: postgres_ext.h:36
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
FormData_pg_subscription_rel * Form_pg_subscription_rel
void * palloc(Size size)
Definition: mcxt.c:949
void ScanKeyInit(ScanKey entry, AttrNumber attributeNumber, StrategyNumber strategy, RegProcedure procedure, Datum argument)
Definition: scankey.c:76
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
Definition: pg_list.h:50
#define BTEqualStrategyNumber
Definition: stratnum.h:31

◆ GetSubscriptionRelState()

char GetSubscriptionRelState ( Oid  subid,
Oid  relid,
XLogRecPtr sublsn,
bool  missing_ok 
)

Definition at line 332 of file pg_subscription.c.

References AccessShareLock, Assert, DatumGetChar, DatumGetLSN, elog, ERROR, HeapTupleIsValid, InvalidXLogRecPtr, ObjectIdGetDatum, ReleaseSysCache(), SearchSysCache2(), SUBSCRIPTIONRELMAP, SysCacheGetAttr(), table_close(), and table_open().

Referenced by logicalrep_rel_open(), LogicalRepSyncTableStart(), and wait_for_relation_state_change().

334 {
335  Relation rel;
336  HeapTuple tup;
337  char substate;
338  bool isnull;
339  Datum d;
340 
341  rel = table_open(SubscriptionRelRelationId, AccessShareLock);
342 
343  /* Try finding the mapping. */
345  ObjectIdGetDatum(relid),
346  ObjectIdGetDatum(subid));
347 
348  if (!HeapTupleIsValid(tup))
349  {
350  if (missing_ok)
351  {
353  *sublsn = InvalidXLogRecPtr;
354  return SUBREL_STATE_UNKNOWN;
355  }
356 
357  elog(ERROR, "subscription table %u in subscription %u does not exist",
358  relid, subid);
359  }
360 
361  /* Get the state. */
363  Anum_pg_subscription_rel_srsubstate, &isnull);
364  Assert(!isnull);
365  substate = DatumGetChar(d);
367  Anum_pg_subscription_rel_srsublsn, &isnull);
368  if (isnull)
369  *sublsn = InvalidXLogRecPtr;
370  else
371  *sublsn = DatumGetLSN(d);
372 
373  /* Cleanup */
374  ReleaseSysCache(tup);
376 
377  return substate;
378 }
#define InvalidXLogRecPtr
Definition: xlogdefs.h:28
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
#define AccessShareLock
Definition: lockdefs.h:36
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
uintptr_t Datum
Definition: postgres.h:367
void ReleaseSysCache(HeapTuple tuple)
Definition: syscache.c:1164
#define DatumGetChar(X)
Definition: postgres.h:409
Datum SysCacheGetAttr(int cacheId, HeapTuple tup, AttrNumber attributeNumber, bool *isNull)
Definition: syscache.c:1377
#define DatumGetLSN(X)
Definition: pg_lsn.h:21
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
#define Assert(condition)
Definition: c.h:739
HeapTuple SearchSysCache2(int cacheId, Datum key1, Datum key2)
Definition: syscache.c:1127
#define elog(elevel,...)
Definition: elog.h:228
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39

◆ RemoveSubscriptionRel()

void RemoveSubscriptionRel ( Oid  subid,
Oid  relid 
)

Definition at line 385 of file pg_subscription.c.

References BTEqualStrategyNumber, CatalogTupleDelete(), ForwardScanDirection, heap_getnext(), HeapTupleIsValid, ObjectIdGetDatum, OidIsValid, RowExclusiveLock, ScanKeyInit(), HeapTupleData::t_self, table_beginscan_catalog(), table_close(), table_endscan(), and table_open().

Referenced by AlterSubscription_refresh(), DropSubscription(), and heap_drop_with_catalog().

386 {
387  Relation rel;
388  TableScanDesc scan;
389  ScanKeyData skey[2];
390  HeapTuple tup;
391  int nkeys = 0;
392 
393  rel = table_open(SubscriptionRelRelationId, RowExclusiveLock);
394 
395  if (OidIsValid(subid))
396  {
397  ScanKeyInit(&skey[nkeys++],
398  Anum_pg_subscription_rel_srsubid,
400  F_OIDEQ,
401  ObjectIdGetDatum(subid));
402  }
403 
404  if (OidIsValid(relid))
405  {
406  ScanKeyInit(&skey[nkeys++],
407  Anum_pg_subscription_rel_srrelid,
409  F_OIDEQ,
410  ObjectIdGetDatum(relid));
411  }
412 
413  /* Do the search and delete what we found. */
414  scan = table_beginscan_catalog(rel, nkeys, skey);
416  {
417  CatalogTupleDelete(rel, &tup->t_self);
418  }
419  table_endscan(scan);
420 
422 }
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
TableScanDesc table_beginscan_catalog(Relation relation, int nkeys, struct ScanKeyData *key)
Definition: tableam.c:98
void CatalogTupleDelete(Relation heapRel, ItemPointer tid)
Definition: indexing.c:269
#define OidIsValid(objectId)
Definition: c.h:645
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
ItemPointerData t_self
Definition: htup.h:65
HeapTuple heap_getnext(TableScanDesc sscan, ScanDirection direction)
Definition: heapam.c:1290
#define RowExclusiveLock
Definition: lockdefs.h:38
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
static void table_endscan(TableScanDesc scan)
Definition: tableam.h:849
void ScanKeyInit(ScanKey entry, AttrNumber attributeNumber, StrategyNumber strategy, RegProcedure procedure, Datum argument)
Definition: scankey.c:76
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
#define BTEqualStrategyNumber
Definition: stratnum.h:31

◆ UpdateSubscriptionRelState()

void UpdateSubscriptionRelState ( Oid  subid,
Oid  relid,
char  state,
XLogRecPtr  sublsn 
)

Definition at line 281 of file pg_subscription.c.

References AccessShareLock, CatalogTupleUpdate(), CharGetDatum, elog, ERROR, heap_modify_tuple(), HeapTupleIsValid, InvalidXLogRecPtr, LockSharedObject(), LSNGetDatum, NoLock, ObjectIdGetDatum, RelationGetDescr, RowExclusiveLock, SearchSysCacheCopy2, SUBSCRIPTIONRELMAP, HeapTupleData::t_self, table_close(), table_open(), and values.

Referenced by LogicalRepSyncTableStart(), process_syncing_tables_for_apply(), and process_syncing_tables_for_sync().

283 {
284  Relation rel;
285  HeapTuple tup;
286  bool nulls[Natts_pg_subscription_rel];
287  Datum values[Natts_pg_subscription_rel];
288  bool replaces[Natts_pg_subscription_rel];
289 
290  LockSharedObject(SubscriptionRelationId, subid, 0, AccessShareLock);
291 
292  rel = table_open(SubscriptionRelRelationId, RowExclusiveLock);
293 
294  /* Try finding existing mapping. */
296  ObjectIdGetDatum(relid),
297  ObjectIdGetDatum(subid));
298  if (!HeapTupleIsValid(tup))
299  elog(ERROR, "subscription table %u in subscription %u does not exist",
300  relid, subid);
301 
302  /* Update the tuple. */
303  memset(values, 0, sizeof(values));
304  memset(nulls, false, sizeof(nulls));
305  memset(replaces, false, sizeof(replaces));
306 
307  replaces[Anum_pg_subscription_rel_srsubstate - 1] = true;
308  values[Anum_pg_subscription_rel_srsubstate - 1] = CharGetDatum(state);
309 
310  replaces[Anum_pg_subscription_rel_srsublsn - 1] = true;
311  if (sublsn != InvalidXLogRecPtr)
312  values[Anum_pg_subscription_rel_srsublsn - 1] = LSNGetDatum(sublsn);
313  else
314  nulls[Anum_pg_subscription_rel_srsublsn - 1] = true;
315 
316  tup = heap_modify_tuple(tup, RelationGetDescr(rel), values, nulls,
317  replaces);
318 
319  /* Update the catalog. */
320  CatalogTupleUpdate(rel, &tup->t_self, tup);
321 
322  /* Cleanup. */
323  table_close(rel, NoLock);
324 }
#define InvalidXLogRecPtr
Definition: xlogdefs.h:28
void table_close(Relation relation, LOCKMODE lockmode)
Definition: table.c:133
#define RelationGetDescr(relation)
Definition: rel.h:454
#define AccessShareLock
Definition: lockdefs.h:36
#define LSNGetDatum(X)
Definition: pg_lsn.h:22
#define ObjectIdGetDatum(X)
Definition: postgres.h:507
#define ERROR
Definition: elog.h:43
ItemPointerData t_self
Definition: htup.h:65
#define NoLock
Definition: lockdefs.h:34
#define RowExclusiveLock
Definition: lockdefs.h:38
uintptr_t Datum
Definition: postgres.h:367
void LockSharedObject(Oid classid, Oid objid, uint16 objsubid, LOCKMODE lockmode)
Definition: lmgr.c:1002
#define HeapTupleIsValid(tuple)
Definition: htup.h:78
Definition: regguts.h:298
void CatalogTupleUpdate(Relation heapRel, ItemPointer otid, HeapTuple tup)
Definition: indexing.c:224
#define CharGetDatum(X)
Definition: postgres.h:416
static Datum values[MAXATTR]
Definition: bootstrap.c:167
#define elog(elevel,...)
Definition: elog.h:228
#define SearchSysCacheCopy2(cacheId, key1, key2)
Definition: syscache.h:176
Relation table_open(Oid relationId, LOCKMODE lockmode)
Definition: table.c:39
HeapTuple heap_modify_tuple(HeapTuple tuple, TupleDesc tupleDesc, Datum *replValues, bool *replIsnull, bool *doReplace)
Definition: heaptuple.c:1113

Variable Documentation

◆ FormData_pg_subscription_rel

FormData_pg_subscription_rel

Definition at line 38 of file pg_subscription_rel.h.