pgPedia

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

首页 / A

• 浏览分类
• 随机条目
• PgPedia周刊
  • 2025-10-05
• 25年前的今天
• PostgreSQL版本发布
  • PostgreSQL 19 (开发中)
  • PostgreSQL 18 (最新)
  • PostgreSQL 17
  • PostgreSQL 16
  • PostgreSQL 15
  • PostgreSQL 14
  • PostgreSQL 13
  • PostgreSQL 12 (已停止支持)

版本图表

SQL命令
系统目录表
系统目录视图
系统统计视图
文件系统函数

Contrib模块
对象标识符类型
进度报告视图
存储参数 (relopts)
预定义角色

实用概述

PostgreSQL在线工具
缩略语和首字母缩略词
Pg 10中的xlog重命名

有用链接

PostgreSQL文档
PostgreSQL特性矩阵
PostgreSQL版本策略
PostgreSQL最新版本

@pgpedia.info (Bluesky)

咖啡

archive_mode

archive_mode 是一个 配置参数，用于确定何时将已完成的 WAL 段发送到归档存储。

archive_mode 在 PostgreSQL 8.3 中添加。

用法

archive_mode 要求 wal_level 被设置为高于 minimal 的值。

archive_mode 有三种可能的设置：

• off
• 开启
• always （PostgreSQL 9.5 及更高版本）

当设置为 on 或 always 时，将在 archive_command 中定义的命令将被执行，以归档每个 WAL 段。

on 意味着 archive_command 将仅在主服务器上应用。

always 意味着 archive_command 将被应用，而不管服务器是主服务器还是备用服务器。

按 PostgreSQL 版本详细信息

变更历史

• PostgreSQL 9.5
  • 添加了 always 模式（提交 ffd37740）
• PostgreSQL 8.3
  • 添加（提交 f18dfc48）

源代码

在 src/include/access/xlog.h

 /* Archive modes */
typedef enum ArchiveMode
{
        ARCHIVE_MODE_OFF = 0,           /* disabled */
        ARCHIVE_MODE_ON,                        /* enabled while server is running normally */
        ARCHIVE_MODE_ALWAYS                     /* enabled always (even during recovery) */
} ArchiveMode;
extern int      XLogArchiveMode;

在 src/backend/access/transam/xlog.c

/* User-settable parameters */
...
int			XLogArchiveMode = ARCHIVE_MODE_OFF;

在 src/backend/utils/misc/guc.c

        {
                {"archive_mode", PGC_POSTMASTER, WAL_ARCHIVING,
                        gettext_noop("Allows archiving of WAL files using archive_command."),
                        NULL
                },
                &XLogArchiveMode,
                ARCHIVE_MODE_OFF, archive_mode_options,
                NULL, NULL, NULL
        },

在 src/backend/postmaster/postmaster.c

		if (XLogArchiveMode > ARCHIVE_MODE_OFF && wal_level == WAL_LEVEL_MINIMAL)
		ereport(ERROR,
				(errmsg("WAL archival cannot be enabled when wal_level is \"minimal\"")));

在 src/backend/access/transam/xlogarchive.c

	/*
	 * Create .done file forcibly to prevent the restored segment from being
	 * archived again later.
	 */
	if (XLogArchiveMode != ARCHIVE_MODE_ALWAYS)
		XLogArchiveForceDone(xlogfname);
	else
		XLogArchiveNotify(xlogfname);

在 src/backend/replication/walreceiver.c

                        /*
                         * Create .done file forcibly to prevent the streamed segment from
                         * being archived later.
                         */
                        XLogFileName(xlogfname, recvFileTLI, recvSegNo, wal_segment_size);
                        if (XLogArchiveMode != ARCHIVE_MODE_ALWAYS)
                                XLogArchiveForceDone(xlogfname);
                        else
                                XLogArchiveNotify(xlogfname);

参考资料

分类

另请参阅

反馈

提交任何关于 "archive_mode" 的评论、建议或更正请点 此处。