PostgreSQL Source Code  git master
message.c
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * message.c
4  * Generic logical messages.
5  *
6  * Copyright (c) 2013-2019, PostgreSQL Global Development Group
7  *
8  * IDENTIFICATION
9  * src/backend/replication/logical/message.c
10  *
11  * NOTES
12  *
13  * Generic logical messages allow XLOG logging of arbitrary binary blobs that
14  * get passed to the logical decoding plugin. In normal XLOG processing they
15  * are same as NOOP.
16  *
17  * These messages can be either transactional or non-transactional.
18  * Transactional messages are part of current transaction and will be sent to
19  * decoding plugin using in a same way as DML operations.
20  * Non-transactional messages are sent to the plugin at the time when the
21  * logical decoding reads them from XLOG. This also means that transactional
22  * messages won't be delivered if the transaction was rolled back but the
23  * non-transactional one will always be delivered.
24  *
25  * Every message carries prefix to avoid conflicts between different decoding
26  * plugins. The plugin authors must take extra care to use unique prefix,
27  * good options seems to be for example to use the name of the extension.
28  *
29  * ---------------------------------------------------------------------------
30  */
31 
32 #include "postgres.h"
33 
34 #include "access/xact.h"
35 #include "catalog/indexing.h"
36 #include "miscadmin.h"
37 #include "nodes/execnodes.h"
38 #include "replication/logical.h"
39 #include "replication/message.h"
40 #include "utils/memutils.h"
41 
42 /*
43  * Write logical decoding message into XLog.
44  */
46 LogLogicalMessage(const char *prefix, const char *message, size_t size,
47  bool transactional)
48 {
49  xl_logical_message xlrec;
50 
51  /*
52  * Force xid to be allocated if we're emitting a transactional message.
53  */
54  if (transactional)
55  {
58  }
59 
60  xlrec.dbId = MyDatabaseId;
61  xlrec.transactional = transactional;
62  xlrec.prefix_size = strlen(prefix) + 1;
63  xlrec.message_size = size;
64 
66  XLogRegisterData((char *) &xlrec, SizeOfLogicalMessage);
67  XLogRegisterData(unconstify(char *, prefix), xlrec.prefix_size);
68  XLogRegisterData(unconstify(char *, message), size);
69 
70  /* allow origin filtering */
72 
73  return XLogInsert(RM_LOGICALMSG_ID, XLOG_LOGICAL_MESSAGE);
74 }
75 
76 /*
77  * Redo is basically just noop for logical decoding messages.
78  */
79 void
81 {
82  uint8 info = XLogRecGetInfo(record) & ~XLR_INFO_MASK;
83 
84  if (info != XLOG_LOGICAL_MESSAGE)
85  elog(PANIC, "logicalmsg_redo: unknown op code %u", info);
86 
87  /* This is only interesting for logical decoding, see decode.c. */
88 }
void logicalmsg_redo(XLogReaderState *record)
Definition: message.c:80
#define SizeOfLogicalMessage
Definition: message.h:31
unsigned char uint8
Definition: c.h:357
#define XLOG_INCLUDE_ORIGIN
Definition: xlog.h:228
#define PANIC
Definition: elog.h:53
TransactionId GetCurrentTransactionId(void)
Definition: xact.c:422
void XLogSetRecordFlags(uint8 flags)
Definition: xloginsert.c:397
#define XLogRecGetInfo(decoder)
Definition: xlogreader.h:279
bool transactional
Definition: message.h:23
XLogRecPtr LogLogicalMessage(const char *prefix, const char *message, size_t size, bool transactional)
Definition: message.c:46
#define unconstify(underlying_type, expr)
Definition: c.h:1194
void XLogRegisterData(char *data, int len)
Definition: xloginsert.c:323
XLogRecPtr XLogInsert(RmgrId rmid, uint8 info)
Definition: xloginsert.c:415
Oid MyDatabaseId
Definition: globals.c:85
uint64 XLogRecPtr
Definition: xlogdefs.h:21
#define Assert(condition)
Definition: c.h:739
#define XLR_INFO_MASK
Definition: xlogrecord.h:62
bool IsTransactionState(void)
Definition: xact.c:355
#define elog(elevel,...)
Definition: elog.h:228
#define XLOG_LOGICAL_MESSAGE
Definition: message.h:37
void XLogBeginInsert(void)
Definition: xloginsert.c:120