导读：

    postgres预写式日志的内核实现详解-概述

 

如下就是将一个记录存储到wal日志文件的主要函数，本文主要是对这些函数进行逐一说明。
XLogBeginInsert();
XLogRegisterData();
XLogRegisterBuffer();
XLogRegisterBufData();
XLogSetRecordFlags(); 
XLogInsert();
  XLogRecordAssemble();
  XLogInsertRecord();
PageSetLSN   

一、重要数据结构

typedef struct XLogRecData
{
	struct XLogRecData *next;	/* next struct in chain, or NULL */
	char	   *data;			/* start of rmgr data to include */
	uint32		len;			/* length of rmgr data to include */
} XLogRecData;

typedef struct
{
	bool		in_use;			/* is this slot in use? */
	uint8		flags;			/* REGBUF_* flags */
	RelFileNode rnode;			/* identifies the relation and block */
	ForkNumber	forkno;
	BlockNumber block;
	Page		page;			/* page content */
	uint32		rdata_len;		/* total length of data in rdata chain */
	XLogRecData *rdata_head;	/* head of the chain of data registered with
								 * this block */
	XLogRecData *rdata_tail;	/* last entry in the chain, or &rdata_head if
								 * empty */

	XLogRecData bkp_rdatas[2];	/* temporary rdatas used to hold references to
								 * backup block data in XLogRecordAssemble() */

	/* buffer to store a compressed version of backup block image */
	char		compressed_page[PGLZ_MAX_BLCKSZ];
} registered_buffer;

二、重要全局变量

static XLogRecData *mainrdata_head;
static XLogRecData *mainrdata_last = (XLogRecData *) &mainrdata_head;

/*使用XLogRegisterBuffer注册的数据存储到registered_buffers数组里*/
static registered_buffer *registered_buffers;

/*使用XLogRegisterBufData注册的数据存储到rdatas数组里，并链接为链表，使用registered_buffer结构里的rdata_head和rdata_tail作为链表的首尾。*/
/*使用XLogRegisterData注册的数据存储到rdatas数组里，并使用mainrdata_head和mainrdata_lastata注册的数据存储到rdatas数组里，并链接为链表，使用registered_buffer结构里的rdata_head和rdata_tail作为链表的首尾。*/
static XLogRecData *rdatas;

 

三、函数说明

1.XLogBeginInsert()

作用：判断当前是否可以执行xlog插入，标志wal插入开始。

 

2.XLogRegisterData()

作用：

①将本条wal记录的特殊结构体数据注册到wal记录，比如XLOG_HEAP_INSERT子类型的xl_heap_insert结构体。

②将一些旧元组数据注册到wal记录，比如执行update语句的旧元组数据、delete语句的旧元组数据。

实现过程：

找到rdatas数组中第一个空的的位置，将传入的参数赋值给这个空位置

3.XLogRegisterBuffer()：

作用：

将涉及到的buff注册到wal记录，比如insert语句的目标buff、update语句的目标buff和源buff。

实现过程：

找到registered_buffer数组中第一个空的的位置，并将这个位置的数据填充

 

4.XLogRegisterBufData()：

作用：

将元组内容注册到wal记录。比如insert语句的元组数据、update语句的新元组数据

实现过程：

在registered_buffer中找到此data的相关buff。

找到rdatas数组中第一个空的的位置，将传入的参数赋值给这个空位置。

将这个位置链接到rdata_tail处

5.XLogSetRecordFlags()：

作用：

设置origin

 

6.XLogInsert()：

作用：

根据当前的数据库状态（full_page_write、checkpoint、REPLICA IDENTITY等），把上述函数注册的数据进行筛选组装，最终形成完整的wal记录并

写入到walbuff。

函数功能主要由XLogRecordAssemble()和XLogInsertRecord()完成

 

7.XLogRecordAssemble()

作用：

代码执行到这个函数的时候，所有的数据已经完成注册，目前wal记录的数据存储在①mainrdata_head②每一个注册的buff的rdata_head③每一个注册的buff的page字段中

这个函数就是要①②③中的数据组合到一起的过程。

实现过程：

过程太复杂，画一组图来说明一下。

 

 

 

 

8.XLogInsertRecord

作用：

此函数就是将XLogRecordAssemble()函数返回的hdr_rdt依次写到wal的内存中。

9.PageSetLSN();

作用：

更新被修改的page LSN。

 

回到概述页