{"kind": "tool", "major": "18", "item": {"slug": "pg-combinebackup", "name": "pg_combinebackup", "name_zh": "", "category": "\u5ba2\u6237\u7aef\u7a0b\u5e8f", "summary": "pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd", "aliases": ["pg_combinebackup"], "content_hash": "333e5817596d7d52548d7f3e88fc9371e502a2bb11e3f50535cc9bb83d3201a4", "versions": {"17": {"facts": [{"label": "\u624b\u518c\u4e2d\u7684\u53ef\u6267\u884c\u7a0b\u5e8f", "value": "pg_combinebackup"}, {"label": "\u7a0b\u5e8f\u7248\u672c", "value": "17.11"}, {"label": "\u53c2\u8003\u6e05\u5355", "value": "\u5ba2\u6237\u7aef\u7a0b\u5e8f"}, {"label": "\u9009\u9879\u5b9a\u4e49\u7ec4", "value": "13"}], "tables": [{"key": "options", "rows": [{"summary": "\u5728 stderr \u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-d --debug"}}, {"summary": "-n / --dry-run \u4f1a\u8ba9 pg_combinebackup \u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e --debug \u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-n --dry-run"}}, {"summary": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c pg_combinebackup \u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f pg_combinebackup \u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-N --no-sync"}}, {"summary": "\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-o outputdir --output= outputdir"}}, {"summary": "\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55 olddir \u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 newdir \u3002 olddir \u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c newdir \u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08 = \uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-T olddir = newdir --tablespace-mapping= olddir = newdir"}}, {"summary": "\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a \u201c reflink \u201d \uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--clone"}}, {"summary": "\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1 --copy-file-range \u548c --clone \u3002\uff09", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--copy"}}, {"summary": "\u4f7f\u7528 copy_file_range \u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e --clone \u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--copy-file-range"}}, {"summary": "\u4e0e pg_basebackup \u4e00\u6837\uff0c pg_combinebackup \u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a NONE \u3001 CRC32C \u3001 SHA224 \u3001 SHA256 \u3001 SHA384 \u548c SHA512 \u3002\u9ed8\u8ba4\u503c\u4e3a CRC32C \u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--manifest-checksums= algorithm"}}, {"summary": "\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--no-manifest"}}, {"summary": "\u5f53\u8bbe\u7f6e\u4e3a fsync \uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c pg_combinebackup \u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "--sync-method= method"}}, {"summary": "\u6253\u5370 pg_combinebackup \u7248\u672c\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-V --version"}}, {"summary": "\u663e\u793a pg_combinebackup \u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/17/app-pgcombinebackup.html", "text": "-? --help"}}], "title": "\u624b\u518c\u4e2d\u7684\u9009\u9879", "columns": [{"key": "signature", "label": "\u9009\u9879\u4e0e\u53c2\u6570"}, {"key": "summary", "label": "\u8bf4\u660e"}]}], "options": [{"names": ["-d", "--debug"], "summary": "Print lots of debug logging output on stderr .", "signature": "-d --debug", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-n", "--dry-run"], "summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "signature": "-n --dry-run", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "signature": "-N --no-sync", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "signature": "-o outputdir --output= outputdir", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "signature": "--clone", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "summary": "Perform regular file copy. This is the default. (See also --copy-file-range and --clone .)", "signature": "--copy", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Perform regular file copy. This is the default. (See also --copy-file-range and --clone .)"}, {"names": ["--copy-file-range"], "summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "signature": "--copy-file-range", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "signature": "--manifest-checksums= algorithm", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "signature": "--no-manifest", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "signature": "--sync-method= method", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "summary": "Prints the pg_combinebackup version and exits.", "signature": "-V --version", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "summary": "Shows help about pg_combinebackup command line arguments, and exits.", "signature": "-? --help", "source_url": "/docs/17/app-pgcombinebackup.html", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "related": [], "release": {"ref": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "label": "17.11", "major": "17", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/17/postgresql-17-A4.pdf", "bytes": 15521293, "pages": 3099, "sha256": "1991354df0dc89e70ec39328c28988ef8b19c6a93671dab3893650b63e9f4e36", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/17/postgresql-17-US.pdf", "bytes": 15398150, "pages": 3270, "sha256": "07696c8f38abf31babf22d2db337093936e7c472d2af36d050b000c49bbcf52c", "built_at": "2026-09-26"}}, "tree": "17", "index": "index.html", "major": "17", "pages": 1143, "release": "17.11", "source_url": "https://ftp.postgresql.org/pub/source/v17.11/postgresql-17.11.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, "revision": "58419c9b0dd42cb34c8d53695bb025a7e582edf55ccd4c5bcb1c2c7c71a37487", "evidence_kind": "English manual and source declarations", "source_sha256": "dd27f2b3c59e73ed14aa3324901242bf69a032a6347805f274e6260322d42979"}, "sources": [{"url": "https://pg.center/docs/17/app-pgcombinebackup.html", "file": "app-pgcombinebackup.html", "label": "17.11 English manual \u00b7 app-pgcombinebackup.html", "anchor": "", "sha256": "7d3dc378adbf4ffedde01fda87dcfc82e7ea6ac0994045c6295b6dcc3b7ae650", "language": "en", "original_url": "/docs/17/app-pgcombinebackup.html"}, {"url": "https://pg.center/docs/17/reference-client.html", "file": "reference-client.html", "label": "Client applications inventory", "anchor": "", "sha256": "3194fc72ddad8e2fcba55f8e007f83413cb352146cb65aaa9457a18d0314ee1b", "language": "en", "original_url": "/docs/17/reference-client.html"}], "sections": [], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "signature": "pg_combinebackup [ option ...] [ backup_directory ...]", "description": ["pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd"], "environment": [], "manual_html": "<div><div class=\"refentry\" id=\"APP-PGCOMBINEBACKUP\">\n<div class=\"titlepage\"></div>\n<div class=\"refnamediv\">\n<h2><span class=\"refentrytitle\"><span class=\"application\">pg_combinebackup</span></span></h2>\n<p lang=\"zh\">pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd</p>\n</div>\n<div class=\"refsynopsisdiv\">\n<h2 lang=\"zh\">\u5927\u7eb2</h2>\n<div class=\"cmdsynopsis\">\n<p id=\"id-1.9.4.12.4.1\"><code class=\"command\">pg_combinebackup</code> [<em class=\"replaceable\"><code>option</code></em>...] [<em class=\"replaceable\"><code>backup_directory</code></em>...]</p>\n</div>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.5\">\n<h2 lang=\"zh\">\u8bf4\u660e</h2>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u7528\u4e8e\u4ece<a class=\"link\" href=\"/docs/17/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP\" title=\"25.3.3.\u00a0\u8fdb\u884c\u589e\u91cf\u5907\u4efd\">\u589e\u91cf\u5907\u4efd</a>\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u66f4\u65e9\u5907\u4efd\u4e2d\u91cd\u5efa\u4e00\u4e2a\u5408\u6210\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u8bf7\u5728\u547d\u4ee4\u884c\u4e0a\u6309\u7167\u4ece\u65e7\u5230\u65b0\u7684\u987a\u5e8f\u6307\u5b9a\u6240\u6709\u5fc5\u9700\u7684\u5907\u4efd\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u7b2c\u4e00\u4e2a\u5907\u4efd\u76ee\u5f55\u5e94\u5f53\u662f\u5b8c\u6574\u5907\u4efd\u7684\u8def\u5f84\uff0c\u6700\u540e\u4e00\u4e2a\u5e94\u5f53\u662f\u60a8\u5e0c\u671b\u6062\u590d\u7684\u6700\u7ec8\u589e\u91cf\u5907\u4efd\u7684\u8def\u5f84\u3002\u91cd\u5efa\u540e\u7684\u5907\u4efd\u5c06\u5199\u5165\u7531<code class=\"option\">-o</code>\u9009\u9879\u6307\u5b9a\u7684\u8f93\u51fa\u76ee\u5f55\u3002</p>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u60a8\u6307\u5b9a\u7684\u8fd9\u4e9b\u5907\u4efd\u662f\u5426\u6784\u6210\u4e00\u6761\u5408\u6cd5\u7684\u5907\u4efd\u94fe\uff0c\u5e76\u4e14\u80fd\u5426\u636e\u6b64\u91cd\u5efa\u51fa\u6b63\u786e\u7684\u5b8c\u6574\u5907\u4efd\u3002\u4f46\u5b83\u5e76\u4e0d\u662f\u4e3a\u5e2e\u52a9\u60a8\u8ddf\u8e2a\u54ea\u4e9b\u5907\u4efd\u4f9d\u8d56\u4e8e\u54ea\u4e9b\u5176\u4ed6\u5907\u4efd\u800c\u8bbe\u8ba1\u7684\u3002\u5982\u679c\u60a8\u5220\u9664\u4e86\u589e\u91cf\u5907\u4efd\u6240\u4f9d\u8d56\u7684\u4e00\u4e2a\u6216\u591a\u4e2a\u5148\u524d\u5907\u4efd\uff0c\u5c31\u65e0\u6cd5\u6062\u590d\u8be5\u589e\u91cf\u5907\u4efd\u3002\u6b64\u5916\uff0c<span class=\"application\">pg_combinebackup</span>\u53ea\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u8fd9\u4e9b\u5907\u4efd\u76f8\u4e92\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u5426\u6b63\u786e\uff0c\u800c\u4e0d\u4f1a\u9a8c\u8bc1\u6bcf\u4e2a\u5355\u72ec\u5907\u4efd\u672c\u8eab\u662f\u5426\u5b8c\u597d\uff1b\u5982\u9700\u5b8c\u6210\u8be5\u9879\u9a8c\u8bc1\uff0c\u8bf7\u4f7f\u7528<a class=\"xref\" href=\"/docs/17/app-pgverifybackup.html\" title=\"pg_verifybackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_verifybackup</span></span></a>\u3002</p>\n<p lang=\"zh\">\u7531\u4e8e<span class=\"application\">pg_combinebackup</span>\u7684\u8f93\u51fa\u662f\u4e00\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u56e0\u6b64\u5b83\u53ef\u4ee5\u4f5c\u4e3a\u5c06\u6765\u8c03\u7528<span class=\"application\">pg_combinebackup</span>\u65f6\u7684\u8f93\u5165\u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u4ee5\u5728\u547d\u4ee4\u884c\u4e0a\u6307\u5b9a\u8fd9\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u4ee5\u4ee3\u66ff\u539f\u5148\u7528\u4e8e\u91cd\u5efa\u5b83\u7684\u90a3\u6761\u5907\u4efd\u94fe\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.6\">\n<h2 lang=\"zh\">\u9009\u9879</h2>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"option\">-d</code><br/></span><span class=\"term\"><code class=\"option\">--debug</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728<code class=\"filename\">stderr</code>\u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-n</code><br/></span><span class=\"term\"><code class=\"option\">--dry-run</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p><code class=\"option\">-n</code>/<code class=\"option\">--dry-run</code>\u4f1a\u8ba9 <code class=\"command\">pg_combinebackup</code>\u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e<code class=\"option\">--debug</code>\u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-N</code><br/></span><span class=\"term\"><code class=\"option\">--no-sync</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f<code class=\"command\">pg_combinebackup</code>\u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-o <em class=\"replaceable\"><code>outputdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--output=<em class=\"replaceable\"><code>outputdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-T <em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--tablespace-mapping=<em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55<em class=\"replaceable\"><code>olddir</code></em>\u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 <em class=\"replaceable\"><code>newdir</code></em>\u3002<em class=\"replaceable\"><code>olddir</code></em>\u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c<em class=\"replaceable\"><code>newdir</code></em>\u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08<code class=\"literal\">=</code>\uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--clone</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a<span class=\"quote\">\u201c<span class=\"quote\">reflink</span>\u201d</span>\uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528\u6587\u4ef6\u514b\u9686\u6765\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n<p lang=\"zh\">\u6587\u4ef6\u514b\u9686\u4ec5\u5728\u67d0\u4e9b\u64cd\u4f5c\u7cfb\u7edf\u548c\u6587\u4ef6\u7cfb\u7edf\u4e0a\u53d7\u652f\u6301\u3002\u5982\u679c\u9009\u62e9\u4e86\u8be5\u9009\u9879\uff0c\u4f46\u7cfb\u7edf\u5e76\u4e0d\u652f\u6301\uff0c<span class=\"application\">pg_combinebackup</span>\u8fd0\u884c\u65f6\u5c06\u62a5\u9519\u3002\u76ee\u524d\uff0c\u5b83\u5728 Linux\uff08\u5185\u6838 4.5 \u53ca\u4ee5\u4e0a\uff09\u4e0a\u7684 Btrfs \u548c XFS\uff08\u5728\u521b\u5efa\u65f6\u542f\u7528\u4e86 reflink \u652f\u6301\u7684\u6587\u4ef6\u7cfb\u7edf\uff09\u4ee5\u53ca macOS \u4e0a\u7684 APFS \u4e0a\u53d7\u652f\u6301\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1<code class=\"option\">--copy-file-range</code>\u548c<code class=\"option\">--clone</code>\u3002\uff09</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy-file-range</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e<code class=\"option\">--clone</code>\u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--manifest-checksums=<em class=\"replaceable\"><code>algorithm</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u4e0e<a class=\"xref\" href=\"/docs/17/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a>\u4e00\u6837\uff0c<span class=\"application\">pg_combinebackup</span>\u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a<code class=\"literal\">NONE</code>\u3001<code class=\"literal\">CRC32C</code>\u3001<code class=\"literal\">SHA224</code>\u3001<code class=\"literal\">SHA256</code>\u3001<code class=\"literal\">SHA384</code>\u548c<code class=\"literal\">SHA512</code>\u3002\u9ed8\u8ba4\u503c\u4e3a<code class=\"literal\">CRC32C</code>\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--no-manifest</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--sync-method=<em class=\"replaceable\"><code>method</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\u5f53\u8bbe\u7f6e\u4e3a<code class=\"literal\">fsync</code>\uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002</p>\n<p lang=\"zh\">\u5728 Linux \u4e0a\uff0c\u4e5f\u53ef\u4ee5\u6539\u7528<code class=\"literal\">syncfs</code>\uff0c\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u540c\u6b65\u5305\u542b\u5907\u4efd\u76ee\u5f55\u7684\u6574\u4e2a\u6587\u4ef6\u7cfb\u7edf\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c<code class=\"command\">pg_combinebackup</code> \u8fd8\u4f1a\u540c\u6b65\u5305\u542b WAL \u6587\u4ef6\u548c\u5404\u8868\u7a7a\u95f4\u7684\u6587\u4ef6\u7cfb\u7edf\u3002\u5173\u4e8e\u4f7f\u7528<code class=\"literal\">syncfs</code>\u65f6\u9700\u8981\u6ce8\u610f\u7684\u4e8b\u9879\uff0c\u8bf7\u53c2\u89c1<a class=\"xref\" href=\"/docs/17/runtime-config-error-handling.html#GUC-RECOVERY-INIT-SYNC-METHOD\">recovery_init_sync_method</a>\u3002</p>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"option\">--no-sync</code>\u65f6\uff0c\u6b64\u9009\u9879\u65e0\u6548\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-V</code><br/></span><span class=\"term\"><code class=\"option\">--version</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6253\u5370<span class=\"application\">pg_combinebackup</span>\u7248\u672c\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-?</code><br/></span><span class=\"term\"><code class=\"option\">--help</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u663e\u793a<span class=\"application\">pg_combinebackup</span>\u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n</dl>\n</div>\n</div>\n<div class=\"refsect1\" id=\"APP-PGCOMBINEBACKUP-LIMITATIONS\">\n<h2 lang=\"zh\">\u9650\u5236</h2>\n<p lang=\"zh\"><code class=\"literal\">pg_combinebackup</code>\u5728\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u65f6\u4e0d\u4f1a\u91cd\u65b0\u8ba1\u7b97\u9875\u9762\u6821\u9a8c\u548c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u7528\u4e8e\u91cd\u5efa\u7684\u67d0\u4e9b\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u800c\u6700\u7ec8\u5907\u4efd\u662f\u5728\u542f\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u5219\u751f\u6210\u7684\u76ee\u5f55\u4e2d\u53ef\u80fd\u5305\u542b\u6821\u9a8c\u548c\u65e0\u6548\u7684\u9875\u9762\u3002</p>\n<p lang=\"zh\">\u4e3a\u907f\u514d\u8fd9\u4e2a\u95ee\u9898\uff0c\u5efa\u8bae\u5728\u4f7f\u7528<a class=\"xref\" href=\"/docs/17/app-pgchecksums.html\" title=\"pg_checksums\"><span class=\"refentrytitle\"><span class=\"application\">pg_checksums</span></span></a>\u66f4\u6539\u96c6\u7c07\u7684\u6821\u9a8c\u548c\u72b6\u6001\u4e4b\u540e\u91cd\u65b0\u521b\u5efa\u4e00\u6b21\u65b0\u7684\u5b8c\u6574\u5907\u4efd\u3002\u5426\u5219\uff0c\u60a8\u4e5f\u53ef\u4ee5\u5bf9\u7531<code class=\"literal\">pg_combinebackup</code>\u751f\u6210\u7684\u76ee\u5f55\u5148\u7981\u7528\u6821\u9a8c\u548c\uff0c\u7136\u540e\u518d\u6309\u9700\u91cd\u65b0\u542f\u7528\uff0c\u4ee5\u4fee\u6b63\u8fd9\u4e2a\u95ee\u9898\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.8\">\n<h2 lang=\"zh\">\u73af\u5883</h2>\n<p lang=\"zh\">\u4e0e\u5927\u591a\u6570\u5176\u4ed6<span class=\"productname\">PostgreSQL</span>\u5de5\u5177\u4e00\u6837\uff0c\u6b64\u5de5\u5177\u4e5f\u4f7f\u7528<span class=\"application\">libpq</span>\u652f\u6301\u7684\u73af\u5883\u53d8\u91cf\uff08\u89c1<a class=\"xref\" href=\"/docs/17/libpq-envars.html\" title=\"32.15.\u00a0\u73af\u5883\u53d8\u91cf\">\u7b2c\u00a032.15\u00a0\u8282</a>\uff09\u3002</p>\n<p lang=\"zh\">\u73af\u5883\u53d8\u91cf<code class=\"envar\">PG_COLOR</code>\u6307\u5b9a\u662f\u5426\u5728\u8bca\u65ad\u6d88\u606f\u4e2d\u4f7f\u7528\u989c\u8272\u3002\u53ef\u80fd\u7684\u503c\u4e3a<code class=\"literal\">always</code>\u3001<code class=\"literal\">auto</code>\u548c<code class=\"literal\">never</code>\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.9\">\n<h2 lang=\"zh\">\u53e6\u89c1</h2><span class=\"simplelist\"><a class=\"xref\" href=\"https://pg.center/docs/17/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a></span>\n</div>\n</div></div>", "manual_path": "app-pgcombinebackup.html", "localization": {"status": "complete", "sources": [{"url": "/docs/17/app-pgcombinebackup.html", "method": "same-major semantic node", "sha256": "492eea58c1526c4bcfbec773585ffbdf0eaf926023e464177ab8e7f8d1e8ec33", "language": "zh", "matched_nodes": ["#APP-PGCOMBINEBACKUP/div[2]/p[1]", "#APP-PGCOMBINEBACKUP/div[3]/h2[0]", "#APP-PGCOMBINEBACKUP/div[4]/p[1]", "#APP-PGCOMBINEBACKUP/div[4]/p[2]", "#APP-PGCOMBINEBACKUP/div[4]/p[3]", "#APP-PGCOMBINEBACKUP/div[4]/p[4]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[19]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[25]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[5]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[7]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[9]", "#APP-PGCOMBINEBACKUP/div[6]/h2[0]", "#APP-PGCOMBINEBACKUP/div[6]/p[1]", "#APP-PGCOMBINEBACKUP/div[6]/p[2]", "#APP-PGCOMBINEBACKUP/div[7]/h2[0]", "#APP-PGCOMBINEBACKUP/div[7]/p[1]", "#APP-PGCOMBINEBACKUP/div[7]/p[2]", "#APP-PGCOMBINEBACKUP/div[8]/h2[0]"]}], "language": "zh", "original_text": {"/versions/17/description/0": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/versions/17/facts/0/label": "Documented executable", "/versions/17/facts/1/label": "Executable version", "/versions/17/facts/2/label": "Reference inventory", "/versions/17/facts/2/value": "Client applications", "/versions/17/facts/3/label": "Option definition groups", "/versions/17/tables/0/title": "Documented options", "/versions/17/tables/0/rows/0/summary": "Print lots of debug logging output on stderr .", "/versions/17/tables/0/rows/1/summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "/versions/17/tables/0/rows/2/summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "/versions/17/tables/0/rows/3/summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "/versions/17/tables/0/rows/4/summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "/versions/17/tables/0/rows/5/summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "/versions/17/tables/0/rows/6/summary": "Perform regular file copy. This is the default. (See also --copy-file-range and --clone .)", "/versions/17/tables/0/rows/7/summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "/versions/17/tables/0/rows/8/summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "/versions/17/tables/0/rows/9/summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "/versions/17/tables/0/columns/0/label": "Option and arguments", "/versions/17/tables/0/columns/1/label": "Description", "/versions/17/tables/0/rows/10/summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "/versions/17/tables/0/rows/11/summary": "Prints the pg_combinebackup version and exits.", "/versions/17/tables/0/rows/12/summary": "Shows help about pg_combinebackup command line arguments, and exits."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "0f77329e5288a5e1f8ae83f855f658bdc5c4abfa2e43af0098d21b7fe2268006"}, "comparison_data": {"options": [{"names": ["-d", "--debug"], "signature": "-d --debug", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-n", "--dry-run"], "signature": "-n --dry-run", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "signature": "-N --no-sync", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "signature": "-o outputdir --output= outputdir", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "signature": "--clone", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "signature": "--copy", "description": "Perform regular file copy. This is the default. (See also --copy-file-range and --clone .)"}, {"names": ["--copy-file-range"], "signature": "--copy-file-range", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "signature": "--manifest-checksums= algorithm", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "signature": "--no-manifest", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "signature": "--sync-method= method", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "signature": "-V --version", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "signature": "-? --help", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "environment": []}, "comparison_hash": "7eb752e07531b38d0ef228bc60fc758f88cbc413a9711af1ee682342a26924fc", "manual_language": "zh"}, "18": {"facts": [{"label": "\u624b\u518c\u4e2d\u7684\u53ef\u6267\u884c\u7a0b\u5e8f", "value": "pg_combinebackup"}, {"label": "\u7a0b\u5e8f\u7248\u672c", "value": "18.6"}, {"label": "\u53c2\u8003\u6e05\u5355", "value": "\u5ba2\u6237\u7aef\u7a0b\u5e8f"}, {"label": "\u9009\u9879\u5b9a\u4e49\u7ec4", "value": "14"}], "tables": [{"key": "options", "rows": [{"summary": "\u5728 stderr \u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-d --debug"}}, {"summary": "\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 pg_combinebackup \u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-k --link"}}, {"summary": "-n / --dry-run \u4f1a\u8ba9 pg_combinebackup \u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e --debug \u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-n --dry-run"}}, {"summary": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c pg_combinebackup \u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f pg_combinebackup \u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-N --no-sync"}}, {"summary": "\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-o outputdir --output= outputdir"}}, {"summary": "\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55 olddir \u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 newdir \u3002 olddir \u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c newdir \u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08 = \uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-T olddir = newdir --tablespace-mapping= olddir = newdir"}}, {"summary": "\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a \u201c reflink \u201d \uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--clone"}}, {"summary": "\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1 --copy-file-range \u3001 --clone \u548c -k / --link \u3002\uff09", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--copy"}}, {"summary": "\u4f7f\u7528 copy_file_range \u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e --clone \u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--copy-file-range"}}, {"summary": "\u4e0e pg_basebackup \u4e00\u6837\uff0c pg_combinebackup \u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a NONE \u3001 CRC32C \u3001 SHA224 \u3001 SHA256 \u3001 SHA384 \u548c SHA512 \u3002\u9ed8\u8ba4\u503c\u4e3a CRC32C \u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--manifest-checksums= algorithm"}}, {"summary": "\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--no-manifest"}}, {"summary": "\u5f53\u8bbe\u7f6e\u4e3a fsync \uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c pg_combinebackup \u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--sync-method= method"}}, {"summary": "\u6253\u5370 pg_combinebackup \u7248\u672c\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-V --version"}}, {"summary": "\u663e\u793a pg_combinebackup \u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-? --help"}}], "title": "\u624b\u518c\u4e2d\u7684\u9009\u9879", "columns": [{"key": "signature", "label": "\u9009\u9879\u4e0e\u53c2\u6570"}, {"key": "summary", "label": "\u8bf4\u660e"}]}], "options": [{"names": ["-d", "--debug"], "summary": "Print lots of debug logging output on stderr .", "signature": "-d --debug", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "signature": "-k --link", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "signature": "-n --dry-run", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "signature": "-N --no-sync", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "signature": "-o outputdir --output= outputdir", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "signature": "--clone", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "signature": "--copy", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "signature": "--copy-file-range", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "signature": "--manifest-checksums= algorithm", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "signature": "--no-manifest", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "signature": "--sync-method= method", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "summary": "Prints the pg_combinebackup version and exits.", "signature": "-V --version", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "summary": "Shows help about pg_combinebackup command line arguments, and exits.", "signature": "-? --help", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "related": [], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/18/postgresql-18-A4.pdf", "bytes": 15865106, "pages": 3154, "sha256": "19512c405da53f9f7fcf0abba359223aa65f021be025bf3411381918f92e3190", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/18/postgresql-18-US.pdf", "bytes": 15748059, "pages": 3328, "sha256": "facbe6c229e598b872d3d98bef53308f46e06746006fa4590de9a7de9dd46319", "built_at": "2026-09-26"}}, "tree": "18", "index": "index.html", "major": "18", "pages": 1148, "release": "18.6", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "revision": "ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8", "evidence_kind": "English manual and source declarations", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "https://pg.center/docs/18/app-pgcombinebackup.html", "file": "app-pgcombinebackup.html", "label": "18.6 English manual \u00b7 app-pgcombinebackup.html", "anchor": "", "sha256": "919ea0092ca93f97635f32b55c31e519379c8f693b26f91826a9f9b8c4ba2717", "language": "en", "original_url": "/docs/18/app-pgcombinebackup.html"}, {"url": "https://pg.center/docs/18/reference-client.html", "file": "reference-client.html", "label": "Client applications inventory", "anchor": "", "sha256": "68f726af77272fe73a827be2b7b5958d0f2239a6f8ed44264e9d42496bfa4fd0", "language": "en", "original_url": "/docs/18/reference-client.html"}], "sections": [], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "signature": "pg_combinebackup [ option ...] [ backup_directory ...]", "description": ["pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd"], "environment": [], "manual_html": "<div><div class=\"refentry\" id=\"APP-PGCOMBINEBACKUP\">\n<div class=\"titlepage\"></div>\n<div class=\"refnamediv\">\n<h2><span class=\"refentrytitle\"><span class=\"application\">pg_combinebackup</span></span></h2>\n<p lang=\"zh\">pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd</p>\n</div>\n<div class=\"refsynopsisdiv\">\n<h2 lang=\"zh\">\u5927\u7eb2</h2>\n<div class=\"cmdsynopsis\">\n<p id=\"id-1.9.4.12.4.1\"><code class=\"command\">pg_combinebackup</code> [<em class=\"replaceable\"><code>option</code></em>...] [<em class=\"replaceable\"><code>backup_directory</code></em>...]</p>\n</div>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.5\">\n<h2 lang=\"zh\">\u8bf4\u660e</h2>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u7528\u4e8e\u4ece<a class=\"link\" href=\"/docs/18/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP\" title=\"25.3.3.\u00a0\u8fdb\u884c\u589e\u91cf\u5907\u4efd\">\u589e\u91cf\u5907\u4efd</a>\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u66f4\u65e9\u5907\u4efd\u4e2d\u91cd\u5efa\u4e00\u4e2a\u5408\u6210\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u8bf7\u5728\u547d\u4ee4\u884c\u4e0a\u6309\u7167\u4ece\u65e7\u5230\u65b0\u7684\u987a\u5e8f\u6307\u5b9a\u6240\u6709\u5fc5\u9700\u7684\u5907\u4efd\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u7b2c\u4e00\u4e2a\u5907\u4efd\u76ee\u5f55\u5e94\u5f53\u662f\u5b8c\u6574\u5907\u4efd\u7684\u8def\u5f84\uff0c\u6700\u540e\u4e00\u4e2a\u5e94\u5f53\u662f\u60a8\u5e0c\u671b\u6062\u590d\u7684\u6700\u7ec8\u589e\u91cf\u5907\u4efd\u7684\u8def\u5f84\u3002\u91cd\u5efa\u540e\u7684\u5907\u4efd\u5c06\u5199\u5165\u7531<code class=\"option\">-o</code>\u9009\u9879\u6307\u5b9a\u7684\u8f93\u51fa\u76ee\u5f55\u3002</p>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u60a8\u6307\u5b9a\u7684\u8fd9\u4e9b\u5907\u4efd\u662f\u5426\u6784\u6210\u4e00\u6761\u5408\u6cd5\u7684\u5907\u4efd\u94fe\uff0c\u5e76\u4e14\u80fd\u5426\u636e\u6b64\u91cd\u5efa\u51fa\u6b63\u786e\u7684\u5b8c\u6574\u5907\u4efd\u3002\u4f46\u5b83\u5e76\u4e0d\u662f\u4e3a\u5e2e\u52a9\u60a8\u8ddf\u8e2a\u54ea\u4e9b\u5907\u4efd\u4f9d\u8d56\u4e8e\u54ea\u4e9b\u5176\u4ed6\u5907\u4efd\u800c\u8bbe\u8ba1\u7684\u3002\u5982\u679c\u60a8\u5220\u9664\u4e86\u589e\u91cf\u5907\u4efd\u6240\u4f9d\u8d56\u7684\u4e00\u4e2a\u6216\u591a\u4e2a\u5148\u524d\u5907\u4efd\uff0c\u5c31\u65e0\u6cd5\u6062\u590d\u8be5\u589e\u91cf\u5907\u4efd\u3002\u6b64\u5916\uff0c<span class=\"application\">pg_combinebackup</span>\u53ea\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u8fd9\u4e9b\u5907\u4efd\u76f8\u4e92\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u5426\u6b63\u786e\uff0c\u800c\u4e0d\u4f1a\u9a8c\u8bc1\u6bcf\u4e2a\u5355\u72ec\u5907\u4efd\u672c\u8eab\u662f\u5426\u5b8c\u597d\uff1b\u5982\u9700\u5b8c\u6210\u8be5\u9879\u9a8c\u8bc1\uff0c\u8bf7\u4f7f\u7528<a class=\"xref\" href=\"/docs/18/app-pgverifybackup.html\" title=\"pg_verifybackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_verifybackup</span></span></a>\u3002</p>\n<p lang=\"zh\">\u7531\u4e8e<span class=\"application\">pg_combinebackup</span>\u7684\u8f93\u51fa\u662f\u4e00\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u56e0\u6b64\u5b83\u53ef\u4ee5\u4f5c\u4e3a\u5c06\u6765\u8c03\u7528<span class=\"application\">pg_combinebackup</span>\u65f6\u7684\u8f93\u5165\u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u4ee5\u5728\u547d\u4ee4\u884c\u4e0a\u6307\u5b9a\u8fd9\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u4ee5\u4ee3\u66ff\u539f\u5148\u7528\u4e8e\u91cd\u5efa\u5b83\u7684\u90a3\u6761\u5907\u4efd\u94fe\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.6\">\n<h2 lang=\"zh\">\u9009\u9879</h2>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"option\">-d</code><br/></span><span class=\"term\"><code class=\"option\">--debug</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728<code class=\"filename\">stderr</code>\u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-k</code><br/></span><span class=\"term\"><code class=\"option\">--link</code></span></dt>\n<dd>\n<p lang=\"zh\">\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 <span class=\"application\">pg_combinebackup</span>\u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002</p>\n<p lang=\"zh\">\u8981\u6c42\u8f93\u5165\u5907\u4efd\u548c\u8f93\u51fa\u76ee\u5f55\u4f4d\u4e8e\u540c\u4e00\u6587\u4ef6\u7cfb\u7edf\u4e2d\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u521b\u5efa\u786c\u94fe\u63a5\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-n</code><br/></span><span class=\"term\"><code class=\"option\">--dry-run</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p><code class=\"option\">-n</code>/<code class=\"option\">--dry-run</code>\u4f1a\u8ba9 <code class=\"command\">pg_combinebackup</code>\u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e<code class=\"option\">--debug</code>\u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-N</code><br/></span><span class=\"term\"><code class=\"option\">--no-sync</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f<code class=\"command\">pg_combinebackup</code>\u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-o <em class=\"replaceable\"><code>outputdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--output=<em class=\"replaceable\"><code>outputdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-T <em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--tablespace-mapping=<em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55<em class=\"replaceable\"><code>olddir</code></em>\u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 <em class=\"replaceable\"><code>newdir</code></em>\u3002<em class=\"replaceable\"><code>olddir</code></em>\u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c<em class=\"replaceable\"><code>newdir</code></em>\u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08<code class=\"literal\">=</code>\uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--clone</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a<span class=\"quote\">\u201c<span class=\"quote\">reflink</span>\u201d</span>\uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528\u6587\u4ef6\u514b\u9686\u6765\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n<p lang=\"zh\">\u6587\u4ef6\u514b\u9686\u4ec5\u5728\u67d0\u4e9b\u64cd\u4f5c\u7cfb\u7edf\u548c\u6587\u4ef6\u7cfb\u7edf\u4e0a\u53d7\u652f\u6301\u3002\u5982\u679c\u9009\u62e9\u4e86\u8be5\u9009\u9879\uff0c\u4f46\u7cfb\u7edf\u5e76\u4e0d\u652f\u6301\uff0c<span class=\"application\">pg_combinebackup</span>\u8fd0\u884c\u65f6\u5c06\u62a5\u9519\u3002\u76ee\u524d\uff0c\u5b83\u5728 Linux\uff08\u5185\u6838 4.5 \u53ca\u4ee5\u4e0a\uff09\u4e0a\u7684 Btrfs \u548c XFS\uff08\u5728\u521b\u5efa\u65f6\u542f\u7528\u4e86 reflink \u652f\u6301\u7684\u6587\u4ef6\u7cfb\u7edf\uff09\u4ee5\u53ca macOS \u4e0a\u7684 APFS \u4e0a\u53d7\u652f\u6301\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1<code class=\"option\">--copy-file-range</code>\u3001<code class=\"option\">--clone</code> \u548c<code class=\"option\">-k</code>/<code class=\"option\">--link</code>\u3002\uff09</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy-file-range</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e<code class=\"option\">--clone</code>\u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--manifest-checksums=<em class=\"replaceable\"><code>algorithm</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u4e0e<a class=\"xref\" href=\"/docs/18/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a>\u4e00\u6837\uff0c<span class=\"application\">pg_combinebackup</span>\u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a<code class=\"literal\">NONE</code>\u3001<code class=\"literal\">CRC32C</code>\u3001<code class=\"literal\">SHA224</code>\u3001<code class=\"literal\">SHA256</code>\u3001<code class=\"literal\">SHA384</code>\u548c<code class=\"literal\">SHA512</code>\u3002\u9ed8\u8ba4\u503c\u4e3a<code class=\"literal\">CRC32C</code>\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--no-manifest</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--sync-method=<em class=\"replaceable\"><code>method</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\u5f53\u8bbe\u7f6e\u4e3a<code class=\"literal\">fsync</code>\uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002</p>\n<p lang=\"zh\">\u5728 Linux \u4e0a\uff0c\u4e5f\u53ef\u4ee5\u6539\u7528<code class=\"literal\">syncfs</code>\uff0c\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u540c\u6b65\u5305\u542b\u5907\u4efd\u76ee\u5f55\u7684\u6574\u4e2a\u6587\u4ef6\u7cfb\u7edf\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c<code class=\"command\">pg_combinebackup</code> \u8fd8\u4f1a\u540c\u6b65\u5305\u542b WAL \u6587\u4ef6\u548c\u5404\u8868\u7a7a\u95f4\u7684\u6587\u4ef6\u7cfb\u7edf\u3002\u5173\u4e8e\u4f7f\u7528<code class=\"literal\">syncfs</code>\u65f6\u9700\u8981\u6ce8\u610f\u7684\u4e8b\u9879\uff0c\u8bf7\u53c2\u89c1<a class=\"xref\" href=\"/docs/18/runtime-config-error-handling.html#GUC-RECOVERY-INIT-SYNC-METHOD\">recovery_init_sync_method</a>\u3002</p>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"option\">--no-sync</code>\u65f6\uff0c\u6b64\u9009\u9879\u65e0\u6548\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-V</code><br/></span><span class=\"term\"><code class=\"option\">--version</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6253\u5370<span class=\"application\">pg_combinebackup</span>\u7248\u672c\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-?</code><br/></span><span class=\"term\"><code class=\"option\">--help</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u663e\u793a<span class=\"application\">pg_combinebackup</span>\u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n</dl>\n</div>\n</div>\n<div class=\"refsect1\" id=\"APP-PGCOMBINEBACKUP-LIMITATIONS\">\n<h2 lang=\"zh\">\u9650\u5236</h2>\n<p lang=\"zh\"><code class=\"literal\">pg_combinebackup</code>\u5728\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u65f6\u4e0d\u4f1a\u91cd\u65b0\u8ba1\u7b97\u9875\u9762\u6821\u9a8c\u548c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u7528\u4e8e\u91cd\u5efa\u7684\u67d0\u4e9b\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u800c\u6700\u7ec8\u5907\u4efd\u662f\u5728\u542f\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u5219\u751f\u6210\u7684\u76ee\u5f55\u4e2d\u53ef\u80fd\u5305\u542b\u6821\u9a8c\u548c\u65e0\u6548\u7684\u9875\u9762\u3002</p>\n<p lang=\"zh\">\u4e3a\u907f\u514d\u8fd9\u4e2a\u95ee\u9898\uff0c\u5efa\u8bae\u5728\u4f7f\u7528<a class=\"xref\" href=\"/docs/18/app-pgchecksums.html\" title=\"pg_checksums\"><span class=\"refentrytitle\"><span class=\"application\">pg_checksums</span></span></a>\u66f4\u6539\u96c6\u7c07\u7684\u6821\u9a8c\u548c\u72b6\u6001\u4e4b\u540e\u91cd\u65b0\u521b\u5efa\u4e00\u6b21\u65b0\u7684\u5b8c\u6574\u5907\u4efd\u3002\u5426\u5219\uff0c\u60a8\u4e5f\u53ef\u4ee5\u5bf9\u7531<code class=\"literal\">pg_combinebackup</code>\u751f\u6210\u7684\u76ee\u5f55\u5148\u7981\u7528\u6821\u9a8c\u548c\uff0c\u7136\u540e\u518d\u6309\u9700\u91cd\u65b0\u542f\u7528\uff0c\u4ee5\u4fee\u6b63\u8fd9\u4e2a\u95ee\u9898\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.8\">\n<h2 lang=\"zh\">\u73af\u5883</h2>\n<p lang=\"zh\">\u4e0e\u5927\u591a\u6570\u5176\u4ed6<span class=\"productname\">PostgreSQL</span>\u5de5\u5177\u4e00\u6837\uff0c\u6b64\u5de5\u5177\u4e5f\u4f7f\u7528<span class=\"application\">libpq</span>\u652f\u6301\u7684\u73af\u5883\u53d8\u91cf\uff08\u89c1<a class=\"xref\" href=\"/docs/18/libpq-envars.html\" title=\"32.15.\u00a0\u73af\u5883\u53d8\u91cf\">\u7b2c\u00a032.15\u00a0\u8282</a>\uff09\u3002</p>\n<p lang=\"zh\">\u73af\u5883\u53d8\u91cf<code class=\"envar\">PG_COLOR</code>\u6307\u5b9a\u662f\u5426\u5728\u8bca\u65ad\u6d88\u606f\u4e2d\u4f7f\u7528\u989c\u8272\u3002\u53ef\u80fd\u7684\u503c\u4e3a<code class=\"literal\">always</code>\u3001<code class=\"literal\">auto</code>\u548c<code class=\"literal\">never</code>\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.9\">\n<h2 lang=\"zh\">\u53e6\u89c1</h2><span class=\"simplelist\"><a class=\"xref\" href=\"https://pg.center/docs/18/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a></span>\n</div>\n</div></div>", "manual_path": "app-pgcombinebackup.html", "localization": {"status": "complete", "sources": [{"url": "/docs/18/app-pgcombinebackup.html", "method": "same-major semantic node", "sha256": "f9b5d610e3fc6d898da25a0a0968a76e1880acfd83956e43a50dc42df444daf8", "language": "zh", "matched_nodes": ["#APP-PGCOMBINEBACKUP/div[2]/p[1]", "#APP-PGCOMBINEBACKUP/div[3]/h2[0]", "#APP-PGCOMBINEBACKUP/div[4]/p[1]", "#APP-PGCOMBINEBACKUP/div[4]/p[2]", "#APP-PGCOMBINEBACKUP/div[4]/p[3]", "#APP-PGCOMBINEBACKUP/div[4]/p[4]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[19]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[25]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[27]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[5]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[7]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[9]", "#APP-PGCOMBINEBACKUP/div[6]/h2[0]", "#APP-PGCOMBINEBACKUP/div[6]/p[1]", "#APP-PGCOMBINEBACKUP/div[6]/p[2]", "#APP-PGCOMBINEBACKUP/div[7]/h2[0]", "#APP-PGCOMBINEBACKUP/div[7]/p[1]", "#APP-PGCOMBINEBACKUP/div[7]/p[2]", "#APP-PGCOMBINEBACKUP/div[8]/h2[0]"]}], "language": "zh", "original_text": {"/versions/18/description/0": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/versions/18/facts/0/label": "Documented executable", "/versions/18/facts/1/label": "Executable version", "/versions/18/facts/2/label": "Reference inventory", "/versions/18/facts/2/value": "Client applications", "/versions/18/facts/3/label": "Option definition groups", "/versions/18/tables/0/title": "Documented options", "/versions/18/tables/0/rows/0/summary": "Print lots of debug logging output on stderr .", "/versions/18/tables/0/rows/1/summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "/versions/18/tables/0/rows/2/summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "/versions/18/tables/0/rows/3/summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "/versions/18/tables/0/rows/4/summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "/versions/18/tables/0/rows/5/summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "/versions/18/tables/0/rows/6/summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "/versions/18/tables/0/rows/7/summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "/versions/18/tables/0/rows/8/summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "/versions/18/tables/0/rows/9/summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "/versions/18/tables/0/columns/0/label": "Option and arguments", "/versions/18/tables/0/columns/1/label": "Description", "/versions/18/tables/0/rows/10/summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "/versions/18/tables/0/rows/11/summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "/versions/18/tables/0/rows/12/summary": "Prints the pg_combinebackup version and exits.", "/versions/18/tables/0/rows/13/summary": "Shows help about pg_combinebackup command line arguments, and exits."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "35c6dc6c16a09271e3bbf896acb0844d7e59a8365cffbc578233da84997d48a0"}, "comparison_data": {"options": [{"names": ["-d", "--debug"], "signature": "-d --debug", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "signature": "-k --link", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "signature": "-n --dry-run", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "signature": "-N --no-sync", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "signature": "-o outputdir --output= outputdir", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "signature": "--clone", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "signature": "--copy", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "signature": "--copy-file-range", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "signature": "--manifest-checksums= algorithm", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "signature": "--no-manifest", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "signature": "--sync-method= method", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "signature": "-V --version", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "signature": "-? --help", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "environment": []}, "comparison_hash": "59008256ecaf745d4645dde1d240c93697d28d59a42c9b28b8c7a30b44585384", "manual_language": "zh"}, "19": {"facts": [{"label": "\u624b\u518c\u4e2d\u7684\u53ef\u6267\u884c\u7a0b\u5e8f", "value": "pg_combinebackup"}, {"label": "\u7a0b\u5e8f\u7248\u672c", "value": "19beta4"}, {"label": "\u53c2\u8003\u6e05\u5355", "value": "\u5ba2\u6237\u7aef\u7a0b\u5e8f"}, {"label": "\u9009\u9879\u5b9a\u4e49\u7ec4", "value": "14"}], "tables": [{"key": "options", "rows": [{"summary": "\u5728 stderr \u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-d --debug"}}, {"summary": "\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 pg_combinebackup \u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-k --link"}}, {"summary": "-n / --dry-run \u4f1a\u8ba9 pg_combinebackup \u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e --debug \u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-n --dry-run"}}, {"summary": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c pg_combinebackup \u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f pg_combinebackup \u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-N --no-sync"}}, {"summary": "\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-o outputdir --output= outputdir"}}, {"summary": "\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55 olddir \u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 newdir \u3002 olddir \u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c newdir \u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08 = \uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-T olddir = newdir --tablespace-mapping= olddir = newdir"}}, {"summary": "\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a \u201c reflink \u201d \uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--clone"}}, {"summary": "\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1 --copy-file-range \u3001 --clone \u548c -k / --link \u3002\uff09", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--copy"}}, {"summary": "\u4f7f\u7528 copy_file_range \u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e --clone \u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--copy-file-range"}}, {"summary": "\u4e0e pg_basebackup \u4e00\u6837\uff0c pg_combinebackup \u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a NONE \u3001 CRC32C \u3001 SHA224 \u3001 SHA256 \u3001 SHA384 \u548c SHA512 \u3002\u9ed8\u8ba4\u503c\u4e3a CRC32C \u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--manifest-checksums= algorithm"}}, {"summary": "\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--no-manifest"}}, {"summary": "\u5f53\u8bbe\u7f6e\u4e3a fsync \uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c pg_combinebackup \u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "--sync-method= method"}}, {"summary": "\u6253\u5370 pg_combinebackup \u7248\u672c\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-V --version"}}, {"summary": "\u663e\u793a pg_combinebackup \u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/19/app-pgcombinebackup.html", "text": "-? --help"}}], "title": "\u624b\u518c\u4e2d\u7684\u9009\u9879", "columns": [{"key": "signature", "label": "\u9009\u9879\u4e0e\u53c2\u6570"}, {"key": "summary", "label": "\u8bf4\u660e"}]}], "options": [{"names": ["-d", "--debug"], "summary": "Print lots of debug logging output on stderr .", "signature": "-d --debug", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "signature": "-k --link", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "signature": "-n --dry-run", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "signature": "-N --no-sync", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "signature": "-o outputdir --output= outputdir", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "signature": "--clone", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "signature": "--copy", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "signature": "--copy-file-range", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "signature": "--manifest-checksums= algorithm", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "signature": "--no-manifest", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "signature": "--sync-method= method", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "summary": "Prints the pg_combinebackup version and exits.", "signature": "-V --version", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "summary": "Shows help about pg_combinebackup command line arguments, and exits.", "signature": "-? --help", "source_url": "/docs/19/app-pgcombinebackup.html", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "related": [], "release": {"ref": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "label": "19beta4", "major": "19", "channel": "preview", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/19/postgresql-19-A4.pdf", "bytes": 16064841, "pages": 3052, "sha256": "4dd099e4125c591128fc5f3ebd02178dc24781f9e5ae629f96d67c4c8547427b", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/19/postgresql-19-US.pdf", "bytes": 15974616, "pages": 3225, "sha256": "61971fa857f0956d47341a0388fa6af9ae10acf691d4b2fc009007d384b0342b", "built_at": "2026-09-26"}}, "tree": "19", "index": "index.html", "major": "19", "pages": 1155, "release": "19beta4", "source_url": "https://ftp.postgresql.org/pub/source/v19beta4/postgresql-19beta4.tar.bz2", "svg_assets": 5, "source_mode": "en SGML built with pinned official archive", "source_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, "revision": "1bbbbf4133d426f0e4304010688d2984c30fb67df0cc3a61b3e37eb3f6f37833", "evidence_kind": "English manual and source declarations", "source_sha256": "83157ee9c599d03b2f7a3d73ef3a56ec24e0e79cc2b3501a64d1364f56398c86"}, "sources": [{"url": "https://pg.center/docs/19/app-pgcombinebackup.html", "file": "app-pgcombinebackup.html", "label": "19beta4 English manual \u00b7 app-pgcombinebackup.html", "anchor": "", "sha256": "6c61f3ff400d0dabef7bff5f0e608b24873ae5429010906e9c4cabd1da3cf126", "language": "en", "original_url": "/docs/19/app-pgcombinebackup.html"}, {"url": "https://pg.center/docs/19/reference-client.html", "file": "reference-client.html", "label": "Client applications inventory", "anchor": "", "sha256": "c827f460db781b39da305303c88e73729a419cd2b2b9dedb126d8ad5cbf02c95", "language": "en", "original_url": "/docs/19/reference-client.html"}], "sections": [], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "signature": "pg_combinebackup [ option ...] [ backup_directory ...]", "description": ["pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd"], "environment": [], "manual_html": "<div><div class=\"refentry\" id=\"APP-PGCOMBINEBACKUP\">\n<div class=\"titlepage\"></div>\n<div class=\"refnamediv\">\n<h2><span class=\"refentrytitle\"><span class=\"application\">pg_combinebackup</span></span></h2>\n<p lang=\"zh\">pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd</p>\n</div>\n<div class=\"refsynopsisdiv\">\n<h2 lang=\"zh\">\u5927\u7eb2</h2>\n<div class=\"cmdsynopsis\">\n<p id=\"id-1.9.4.12.4.1\"><code class=\"command\">pg_combinebackup</code> [<em class=\"replaceable\"><code>option</code></em>...] [<em class=\"replaceable\"><code>backup_directory</code></em>...]</p>\n</div>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.5\">\n<h2 lang=\"zh\">\u8bf4\u660e</h2>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u7528\u4e8e\u4ece<a class=\"link\" href=\"/docs/19/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP\" title=\"25.3.3.\u00a0\u8fdb\u884c\u589e\u91cf\u5907\u4efd\">\u589e\u91cf\u5907\u4efd</a>\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u66f4\u65e9\u5907\u4efd\u4e2d\u91cd\u5efa\u4e00\u4e2a\u5408\u6210\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u8bf7\u5728\u547d\u4ee4\u884c\u4e0a\u6309\u7167\u4ece\u65e7\u5230\u65b0\u7684\u987a\u5e8f\u6307\u5b9a\u6240\u6709\u5fc5\u9700\u7684\u5907\u4efd\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u7b2c\u4e00\u4e2a\u5907\u4efd\u76ee\u5f55\u5e94\u5f53\u662f\u5b8c\u6574\u5907\u4efd\u7684\u8def\u5f84\uff0c\u6700\u540e\u4e00\u4e2a\u5e94\u5f53\u662f\u60a8\u5e0c\u671b\u6062\u590d\u7684\u6700\u7ec8\u589e\u91cf\u5907\u4efd\u7684\u8def\u5f84\u3002\u91cd\u5efa\u540e\u7684\u5907\u4efd\u5c06\u5199\u5165\u7531<code class=\"option\">-o</code>\u9009\u9879\u6307\u5b9a\u7684\u8f93\u51fa\u76ee\u5f55\u3002</p>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u60a8\u6307\u5b9a\u7684\u8fd9\u4e9b\u5907\u4efd\u662f\u5426\u6784\u6210\u4e00\u6761\u5408\u6cd5\u7684\u5907\u4efd\u94fe\uff0c\u5e76\u4e14\u80fd\u5426\u636e\u6b64\u91cd\u5efa\u51fa\u6b63\u786e\u7684\u5b8c\u6574\u5907\u4efd\u3002\u4f46\u5b83\u5e76\u4e0d\u662f\u4e3a\u5e2e\u52a9\u60a8\u8ddf\u8e2a\u54ea\u4e9b\u5907\u4efd\u4f9d\u8d56\u4e8e\u54ea\u4e9b\u5176\u4ed6\u5907\u4efd\u800c\u8bbe\u8ba1\u7684\u3002\u5982\u679c\u60a8\u5220\u9664\u4e86\u589e\u91cf\u5907\u4efd\u6240\u4f9d\u8d56\u7684\u4e00\u4e2a\u6216\u591a\u4e2a\u5148\u524d\u5907\u4efd\uff0c\u5c31\u65e0\u6cd5\u6062\u590d\u8be5\u589e\u91cf\u5907\u4efd\u3002\u6b64\u5916\uff0c<span class=\"application\">pg_combinebackup</span>\u53ea\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u8fd9\u4e9b\u5907\u4efd\u76f8\u4e92\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u5426\u6b63\u786e\uff0c\u800c\u4e0d\u4f1a\u9a8c\u8bc1\u6bcf\u4e2a\u5355\u72ec\u5907\u4efd\u672c\u8eab\u662f\u5426\u5b8c\u597d\uff1b\u5982\u9700\u5b8c\u6210\u8be5\u9879\u9a8c\u8bc1\uff0c\u8bf7\u4f7f\u7528<a class=\"xref\" href=\"/docs/19/app-pgverifybackup.html\" title=\"pg_verifybackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_verifybackup</span></span></a>\u3002</p>\n<p lang=\"zh\">\u7531\u4e8e<span class=\"application\">pg_combinebackup</span>\u7684\u8f93\u51fa\u662f\u4e00\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u56e0\u6b64\u5b83\u53ef\u4ee5\u4f5c\u4e3a\u5c06\u6765\u8c03\u7528<span class=\"application\">pg_combinebackup</span>\u65f6\u7684\u8f93\u5165\u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u4ee5\u5728\u547d\u4ee4\u884c\u4e0a\u6307\u5b9a\u8fd9\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u4ee5\u4ee3\u66ff\u539f\u5148\u7528\u4e8e\u91cd\u5efa\u5b83\u7684\u90a3\u6761\u5907\u4efd\u94fe\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.6\">\n<h2 lang=\"zh\">\u9009\u9879</h2>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"option\">-d</code><br/></span><span class=\"term\"><code class=\"option\">--debug</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728<code class=\"filename\">stderr</code>\u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-k</code><br/></span><span class=\"term\"><code class=\"option\">--link</code></span></dt>\n<dd>\n<p lang=\"zh\">\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 <span class=\"application\">pg_combinebackup</span>\u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002</p>\n<p lang=\"zh\">\u8981\u6c42\u8f93\u5165\u5907\u4efd\u548c\u8f93\u51fa\u76ee\u5f55\u4f4d\u4e8e\u540c\u4e00\u6587\u4ef6\u7cfb\u7edf\u4e2d\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u521b\u5efa\u786c\u94fe\u63a5\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-n</code><br/></span><span class=\"term\"><code class=\"option\">--dry-run</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p><code class=\"option\">-n</code>/<code class=\"option\">--dry-run</code>\u4f1a\u8ba9 <code class=\"command\">pg_combinebackup</code>\u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e<code class=\"option\">--debug</code>\u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-N</code><br/></span><span class=\"term\"><code class=\"option\">--no-sync</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f<code class=\"command\">pg_combinebackup</code>\u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-o <em class=\"replaceable\"><code>outputdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--output=<em class=\"replaceable\"><code>outputdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-T <em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--tablespace-mapping=<em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55<em class=\"replaceable\"><code>olddir</code></em>\u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 <em class=\"replaceable\"><code>newdir</code></em>\u3002<em class=\"replaceable\"><code>olddir</code></em>\u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c<em class=\"replaceable\"><code>newdir</code></em>\u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08<code class=\"literal\">=</code>\uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--clone</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a<span class=\"quote\">\u201c<span class=\"quote\">reflink</span>\u201d</span>\uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528\u6587\u4ef6\u514b\u9686\u6765\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n<p lang=\"zh\">\u6587\u4ef6\u514b\u9686\u4ec5\u5728\u67d0\u4e9b\u64cd\u4f5c\u7cfb\u7edf\u548c\u6587\u4ef6\u7cfb\u7edf\u4e0a\u53d7\u652f\u6301\u3002\u5982\u679c\u9009\u62e9\u4e86\u8be5\u9009\u9879\uff0c\u4f46\u7cfb\u7edf\u5e76\u4e0d\u652f\u6301\uff0c<span class=\"application\">pg_combinebackup</span>\u8fd0\u884c\u65f6\u5c06\u62a5\u9519\u3002\u76ee\u524d\uff0c\u5b83\u5728 Linux\uff08\u5185\u6838 4.5 \u53ca\u4ee5\u4e0a\uff09\u4e0a\u7684 Btrfs \u548c XFS\uff08\u5728\u521b\u5efa\u65f6\u542f\u7528\u4e86 reflink \u652f\u6301\u7684\u6587\u4ef6\u7cfb\u7edf\uff09\u4ee5\u53ca macOS \u4e0a\u7684 APFS \u4e0a\u53d7\u652f\u6301\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1<code class=\"option\">--copy-file-range</code>\u3001<code class=\"option\">--clone</code> \u548c<code class=\"option\">-k</code>/<code class=\"option\">--link</code>\u3002\uff09</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy-file-range</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e<code class=\"option\">--clone</code>\u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--manifest-checksums=<em class=\"replaceable\"><code>algorithm</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u4e0e<a class=\"xref\" href=\"/docs/19/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a>\u4e00\u6837\uff0c<span class=\"application\">pg_combinebackup</span>\u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a<code class=\"literal\">NONE</code>\u3001<code class=\"literal\">CRC32C</code>\u3001<code class=\"literal\">SHA224</code>\u3001<code class=\"literal\">SHA256</code>\u3001<code class=\"literal\">SHA384</code>\u548c<code class=\"literal\">SHA512</code>\u3002\u9ed8\u8ba4\u503c\u4e3a<code class=\"literal\">CRC32C</code>\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--no-manifest</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--sync-method=<em class=\"replaceable\"><code>method</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\u5f53\u8bbe\u7f6e\u4e3a<code class=\"literal\">fsync</code>\uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002</p>\n<p lang=\"zh\">\u5728 Linux \u4e0a\uff0c\u4e5f\u53ef\u4ee5\u6539\u7528<code class=\"literal\">syncfs</code>\uff0c\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u540c\u6b65\u5305\u542b\u5907\u4efd\u76ee\u5f55\u7684\u6574\u4e2a\u6587\u4ef6\u7cfb\u7edf\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c<code class=\"command\">pg_combinebackup</code> \u8fd8\u4f1a\u540c\u6b65\u5305\u542b WAL \u6587\u4ef6\u548c\u5404\u8868\u7a7a\u95f4\u7684\u6587\u4ef6\u7cfb\u7edf\u3002\u5173\u4e8e\u4f7f\u7528<code class=\"literal\">syncfs</code>\u65f6\u9700\u8981\u6ce8\u610f\u7684\u4e8b\u9879\uff0c\u8bf7\u53c2\u89c1<a class=\"xref\" href=\"/docs/19/runtime-config-error-handling.html#GUC-RECOVERY-INIT-SYNC-METHOD\">recovery_init_sync_method</a>\u3002</p>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"option\">--no-sync</code>\u65f6\uff0c\u6b64\u9009\u9879\u65e0\u6548\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-V</code><br/></span><span class=\"term\"><code class=\"option\">--version</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6253\u5370<span class=\"application\">pg_combinebackup</span>\u7248\u672c\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-?</code><br/></span><span class=\"term\"><code class=\"option\">--help</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u663e\u793a<span class=\"application\">pg_combinebackup</span>\u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n</dl>\n</div>\n</div>\n<div class=\"refsect1\" id=\"APP-PGCOMBINEBACKUP-LIMITATIONS\">\n<h2 lang=\"zh\">\u9650\u5236</h2>\n<p lang=\"zh\"><code class=\"literal\">pg_combinebackup</code>\u5728\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u65f6\u4e0d\u4f1a\u91cd\u65b0\u8ba1\u7b97\u9875\u9762\u6821\u9a8c\u548c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u7528\u4e8e\u91cd\u5efa\u7684\u67d0\u4e9b\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u800c\u6700\u7ec8\u5907\u4efd\u662f\u5728\u542f\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u5219\u751f\u6210\u7684\u76ee\u5f55\u4e2d\u53ef\u80fd\u5305\u542b\u6821\u9a8c\u548c\u65e0\u6548\u7684\u9875\u9762\u3002</p>\n<p lang=\"zh\">\u4e3a\u907f\u514d\u8fd9\u4e2a\u95ee\u9898\uff0c\u5efa\u8bae\u5728\u4f7f\u7528<a class=\"xref\" href=\"/docs/19/app-pgchecksums.html\" title=\"pg_checksums\"><span class=\"refentrytitle\"><span class=\"application\">pg_checksums</span></span></a>\u66f4\u6539\u96c6\u7c07\u7684\u6821\u9a8c\u548c\u72b6\u6001\u4e4b\u540e\u91cd\u65b0\u521b\u5efa\u4e00\u6b21\u65b0\u7684\u5b8c\u6574\u5907\u4efd\u3002\u5426\u5219\uff0c\u60a8\u4e5f\u53ef\u4ee5\u5bf9\u7531<code class=\"literal\">pg_combinebackup</code>\u751f\u6210\u7684\u76ee\u5f55\u5148\u7981\u7528\u6821\u9a8c\u548c\uff0c\u7136\u540e\u518d\u6309\u9700\u91cd\u65b0\u542f\u7528\uff0c\u4ee5\u4fee\u6b63\u8fd9\u4e2a\u95ee\u9898\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.8\">\n<h2 lang=\"zh\">\u73af\u5883</h2>\n<p lang=\"zh\">\u4e0e\u5927\u591a\u6570\u5176\u4ed6<span class=\"productname\">PostgreSQL</span>\u5de5\u5177\u4e00\u6837\uff0c\u6b64\u5de5\u5177\u4e5f\u4f7f\u7528<span class=\"application\">libpq</span>\u652f\u6301\u7684\u73af\u5883\u53d8\u91cf\uff08\u89c1<a class=\"xref\" href=\"/docs/19/libpq-envars.html\" title=\"32.15.\u00a0\u73af\u5883\u53d8\u91cf\">\u7b2c\u00a032.15\u00a0\u8282</a>\uff09\u3002</p>\n<p lang=\"zh\">\u73af\u5883\u53d8\u91cf<code class=\"envar\">PG_COLOR</code>\u6307\u5b9a\u662f\u5426\u5728\u8bca\u65ad\u6d88\u606f\u4e2d\u4f7f\u7528\u989c\u8272\u3002\u53ef\u80fd\u7684\u503c\u4e3a<code class=\"literal\">always</code>\u3001<code class=\"literal\">auto</code>\u548c<code class=\"literal\">never</code>\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.9\">\n<h2 lang=\"zh\">\u53e6\u89c1</h2><span class=\"simplelist\"><a class=\"xref\" href=\"https://pg.center/docs/19/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a></span>\n</div>\n</div></div>", "manual_path": "app-pgcombinebackup.html", "localization": {"status": "complete", "sources": [{"url": "/docs/19/app-pgcombinebackup.html", "method": "same-major semantic node", "sha256": "131aad11341f2958630dcb22fec0c82832741dd3c7f342c7875eda16583942d0", "language": "zh", "matched_nodes": ["#APP-PGCOMBINEBACKUP/div[2]/p[1]", "#APP-PGCOMBINEBACKUP/div[3]/h2[0]", "#APP-PGCOMBINEBACKUP/div[4]/p[1]", "#APP-PGCOMBINEBACKUP/div[4]/p[2]", "#APP-PGCOMBINEBACKUP/div[4]/p[3]", "#APP-PGCOMBINEBACKUP/div[4]/p[4]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[19]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[25]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[27]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[5]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[7]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[9]", "#APP-PGCOMBINEBACKUP/div[6]/h2[0]", "#APP-PGCOMBINEBACKUP/div[6]/p[1]", "#APP-PGCOMBINEBACKUP/div[6]/p[2]", "#APP-PGCOMBINEBACKUP/div[7]/h2[0]", "#APP-PGCOMBINEBACKUP/div[7]/p[1]", "#APP-PGCOMBINEBACKUP/div[7]/p[2]", "#APP-PGCOMBINEBACKUP/div[8]/h2[0]"]}], "language": "zh", "original_text": {"/versions/19/description/0": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/versions/19/facts/0/label": "Documented executable", "/versions/19/facts/1/label": "Executable version", "/versions/19/facts/2/label": "Reference inventory", "/versions/19/facts/2/value": "Client applications", "/versions/19/facts/3/label": "Option definition groups", "/versions/19/tables/0/title": "Documented options", "/versions/19/tables/0/rows/0/summary": "Print lots of debug logging output on stderr .", "/versions/19/tables/0/rows/1/summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "/versions/19/tables/0/rows/2/summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "/versions/19/tables/0/rows/3/summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "/versions/19/tables/0/rows/4/summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "/versions/19/tables/0/rows/5/summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "/versions/19/tables/0/rows/6/summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "/versions/19/tables/0/rows/7/summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "/versions/19/tables/0/rows/8/summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "/versions/19/tables/0/rows/9/summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "/versions/19/tables/0/columns/0/label": "Option and arguments", "/versions/19/tables/0/columns/1/label": "Description", "/versions/19/tables/0/rows/10/summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "/versions/19/tables/0/rows/11/summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "/versions/19/tables/0/rows/12/summary": "Prints the pg_combinebackup version and exits.", "/versions/19/tables/0/rows/13/summary": "Shows help about pg_combinebackup command line arguments, and exits."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "0c1efd3c96855e7bb02dd56fe3f844ac001973d040f3470c0c30cbd538be03d6"}, "comparison_data": {"options": [{"names": ["-d", "--debug"], "signature": "-d --debug", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "signature": "-k --link", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "signature": "-n --dry-run", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "signature": "-N --no-sync", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "signature": "-o outputdir --output= outputdir", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "signature": "--clone", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "signature": "--copy", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "signature": "--copy-file-range", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "signature": "--manifest-checksums= algorithm", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "signature": "--no-manifest", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "signature": "--sync-method= method", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "signature": "-V --version", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "signature": "-? --help", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "environment": []}, "comparison_hash": "59008256ecaf745d4645dde1d240c93697d28d59a42c9b28b8c7a30b44585384", "manual_language": "zh"}, "20": {"facts": [{"label": "\u624b\u518c\u4e2d\u7684\u53ef\u6267\u884c\u7a0b\u5e8f", "value": "pg_combinebackup"}, {"label": "\u7a0b\u5e8f\u7248\u672c", "value": "20devel"}, {"label": "\u53c2\u8003\u6e05\u5355", "value": "\u5ba2\u6237\u7aef\u7a0b\u5e8f"}, {"label": "\u9009\u9879\u5b9a\u4e49\u7ec4", "value": "14"}], "tables": [{"key": "options", "rows": [{"summary": "\u5728 stderr \u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-d --debug"}}, {"summary": "\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 pg_combinebackup \u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-k --link"}}, {"summary": "-n / --dry-run \u4f1a\u8ba9 pg_combinebackup \u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e --debug \u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-n --dry-run"}}, {"summary": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c pg_combinebackup \u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f pg_combinebackup \u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-N --no-sync"}}, {"summary": "\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-o outputdir --output= outputdir"}}, {"summary": "\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55 olddir \u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 newdir \u3002 olddir \u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c newdir \u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08 = \uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-T olddir = newdir --tablespace-mapping= olddir = newdir"}}, {"summary": "\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a \u201c reflink \u201d \uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--clone"}}, {"summary": "\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1 --copy-file-range \u3001 --clone \u548c -k / --link \u3002\uff09", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--copy"}}, {"summary": "\u4f7f\u7528 copy_file_range \u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e --clone \u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--copy-file-range"}}, {"summary": "\u4e0e pg_basebackup \u4e00\u6837\uff0c pg_combinebackup \u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a NONE \u3001 CRC32C \u3001 SHA224 \u3001 SHA256 \u3001 SHA384 \u548c SHA512 \u3002\u9ed8\u8ba4\u503c\u4e3a CRC32C \u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--manifest-checksums= algorithm"}}, {"summary": "\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--no-manifest"}}, {"summary": "\u5f53\u8bbe\u7f6e\u4e3a fsync \uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c pg_combinebackup \u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "--sync-method= method"}}, {"summary": "\u6253\u5370 pg_combinebackup \u7248\u672c\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-V --version"}}, {"summary": "\u663e\u793a pg_combinebackup \u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/devel/app-pgcombinebackup.html", "text": "-? --help"}}], "title": "\u624b\u518c\u4e2d\u7684\u9009\u9879", "columns": [{"key": "signature", "label": "\u9009\u9879\u4e0e\u53c2\u6570"}, {"key": "summary", "label": "\u8bf4\u660e"}]}], "options": [{"names": ["-d", "--debug"], "summary": "Print lots of debug logging output on stderr .", "signature": "-d --debug", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "signature": "-k --link", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "signature": "-n --dry-run", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "signature": "-N --no-sync", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "signature": "-o outputdir --output= outputdir", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "signature": "--clone", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "signature": "--copy", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "signature": "--copy-file-range", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "signature": "--manifest-checksums= algorithm", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "signature": "--no-manifest", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "signature": "--sync-method= method", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "summary": "Prints the pg_combinebackup version and exits.", "signature": "-V --version", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "summary": "Shows help about pg_combinebackup command line arguments, and exits.", "signature": "-? --help", "source_url": "/docs/devel/app-pgcombinebackup.html", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "related": [], "release": {"ref": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "label": "20devel", "major": "20", "channel": "devel", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/20/postgresql-20-A4.pdf", "bytes": 16030631, "pages": 3052, "sha256": "bd5d82c0ce38fc18f92a0447818a91a193a261776bca1c37564bf9a683e177d0", "built_at": "2026-09-28"}, "US": {"url": "/files/documentation/pdf/20/postgresql-20-US.pdf", "bytes": 15936613, "pages": 3223, "sha256": "d97d9e0db479a02f4234b175f50fcad70c3661619afc8d6df9b9437882e3c299", "built_at": "2026-09-28"}}, "tree": "0", "index": "index.html", "major": "20", "pages": 1156, "release": "20devel", "source_url": "https://ftp.postgresql.org/pub/snapshot/dev/postgresql-snapshot.tar.bz2", "svg_assets": 6, "source_mode": "en SGML built with pinned official archive", "source_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41", "source_snapshot_utc": "26-Sep-2026 20:22"}, "revision": "2eba5e0fd4c3bffb2803247b6cd537878e9d6ee5a6dfbe3c50ece8b421b80918", "evidence_kind": "English manual and source declarations", "source_sha256": "4d3346909b201ac1648232cf290462a7070c119326f56196f1f0253ed80fae41"}, "sources": [{"url": "https://pg.center/docs/devel/app-pgcombinebackup.html", "file": "app-pgcombinebackup.html", "label": "20devel English manual \u00b7 app-pgcombinebackup.html", "anchor": "", "sha256": "545558c92c35ffcdb8dd24c0490590ae2eeb4770537963a4fb6072830b85e7e4", "language": "en", "original_url": "/docs/devel/app-pgcombinebackup.html"}, {"url": "https://pg.center/docs/devel/reference-client.html", "file": "reference-client.html", "label": "Client applications inventory", "anchor": "", "sha256": "a6c7ba748fa1d9feac5bb7cde41d1d36a1f4c26d5963e07fb103d02918b2a8ca", "language": "en", "original_url": "/docs/devel/reference-client.html"}], "sections": [], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "signature": "pg_combinebackup [ option ...] [ backup_directory ...]", "description": ["pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd"], "environment": [], "manual_html": "<div><div class=\"refentry\" id=\"APP-PGCOMBINEBACKUP\">\n<div class=\"titlepage\"></div>\n<div class=\"refnamediv\">\n<h2><span class=\"refentrytitle\"><span class=\"application\">pg_combinebackup</span></span></h2>\n<p lang=\"zh\">pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd</p>\n</div>\n<div class=\"refsynopsisdiv\">\n<h2 lang=\"zh\">\u5927\u7eb2</h2>\n<div class=\"cmdsynopsis\">\n<p id=\"id-1.9.4.12.4.1\"><code class=\"command\">pg_combinebackup</code> [<em class=\"replaceable\"><code>option</code></em>...] [<em class=\"replaceable\"><code>backup_directory</code></em>...]</p>\n</div>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.5\">\n<h2 lang=\"zh\">\u8bf4\u660e</h2>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u7528\u4e8e\u4ece<a class=\"link\" href=\"/docs/devel/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP\" title=\"25.3.3.\u00a0\u8fdb\u884c\u589e\u91cf\u5907\u4efd\">\u589e\u91cf\u5907\u4efd</a>\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u66f4\u65e9\u5907\u4efd\u4e2d\u91cd\u5efa\u4e00\u4e2a\u5408\u6210\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u8bf7\u5728\u547d\u4ee4\u884c\u4e0a\u6309\u7167\u4ece\u65e7\u5230\u65b0\u7684\u987a\u5e8f\u6307\u5b9a\u6240\u6709\u5fc5\u9700\u7684\u5907\u4efd\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u7b2c\u4e00\u4e2a\u5907\u4efd\u76ee\u5f55\u5e94\u5f53\u662f\u5b8c\u6574\u5907\u4efd\u7684\u8def\u5f84\uff0c\u6700\u540e\u4e00\u4e2a\u5e94\u5f53\u662f\u4f60\u5e0c\u671b\u6062\u590d\u7684\u6700\u7ec8\u589e\u91cf\u5907\u4efd\u7684\u8def\u5f84\u3002\u91cd\u5efa\u540e\u7684\u5907\u4efd\u5c06\u5199\u5165\u7531<code class=\"option\">-o</code>\u9009\u9879\u6307\u5b9a\u7684\u8f93\u51fa\u76ee\u5f55\u3002</p>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u4f60\u6307\u5b9a\u7684\u8fd9\u4e9b\u5907\u4efd\u662f\u5426\u6784\u6210\u4e00\u6761\u5408\u6cd5\u7684\u5907\u4efd\u94fe\uff0c\u5e76\u4e14\u80fd\u5426\u636e\u6b64\u91cd\u5efa\u51fa\u6b63\u786e\u7684\u5b8c\u6574\u5907\u4efd\u3002\u4f46\u5b83\u5e76\u4e0d\u662f\u4e3a\u5e2e\u52a9\u4f60\u8ddf\u8e2a\u54ea\u4e9b\u5907\u4efd\u4f9d\u8d56\u4e8e\u54ea\u4e9b\u5176\u4ed6\u5907\u4efd\u800c\u8bbe\u8ba1\u7684\u3002\u5982\u679c\u4f60\u5220\u9664\u4e86\u589e\u91cf\u5907\u4efd\u6240\u4f9d\u8d56\u7684\u4e00\u4e2a\u6216\u591a\u4e2a\u5148\u524d\u5907\u4efd\uff0c\u5c31\u65e0\u6cd5\u6062\u590d\u8be5\u589e\u91cf\u5907\u4efd\u3002\u6b64\u5916\uff0c<span class=\"application\">pg_combinebackup</span>\u53ea\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u8fd9\u4e9b\u5907\u4efd\u76f8\u4e92\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u5426\u6b63\u786e\uff0c\u800c\u4e0d\u4f1a\u9a8c\u8bc1\u6bcf\u4e2a\u5355\u72ec\u5907\u4efd\u672c\u8eab\u662f\u5426\u5b8c\u597d\uff1b\u5982\u9700\u5b8c\u6210\u8be5\u9879\u9a8c\u8bc1\uff0c\u8bf7\u4f7f\u7528<a class=\"xref\" href=\"/docs/devel/app-pgverifybackup.html\" title=\"pg_verifybackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_verifybackup</span></span></a>\u3002</p>\n<p lang=\"zh\">\u7531\u4e8e<span class=\"application\">pg_combinebackup</span>\u7684\u8f93\u51fa\u662f\u4e00\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u56e0\u6b64\u5b83\u53ef\u4ee5\u4f5c\u4e3a\u5c06\u6765\u8c03\u7528<span class=\"application\">pg_combinebackup</span>\u65f6\u7684\u8f93\u5165\u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u4ee5\u5728\u547d\u4ee4\u884c\u4e0a\u6307\u5b9a\u8fd9\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u4ee5\u4ee3\u66ff\u539f\u5148\u7528\u4e8e\u91cd\u5efa\u5b83\u7684\u90a3\u6761\u5907\u4efd\u94fe\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.6\">\n<h2 lang=\"zh\">\u9009\u9879</h2>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"option\">-d</code><br/></span><span class=\"term\"><code class=\"option\">--debug</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728<code class=\"filename\">stderr</code>\u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-k</code><br/></span><span class=\"term\"><code class=\"option\">--link</code></span></dt>\n<dd>\n<p lang=\"zh\">\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 <span class=\"application\">pg_combinebackup</span>\u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002</p>\n<p lang=\"zh\">\u8981\u6c42\u8f93\u5165\u5907\u4efd\u548c\u8f93\u51fa\u76ee\u5f55\u4f4d\u4e8e\u540c\u4e00\u6587\u4ef6\u7cfb\u7edf\u4e2d\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u521b\u5efa\u786c\u94fe\u63a5\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-n</code><br/></span><span class=\"term\"><code class=\"option\">--dry-run</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p><code class=\"option\">-n</code>/<code class=\"option\">--dry-run</code>\u4f1a\u8ba9 <code class=\"command\">pg_combinebackup</code>\u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e<code class=\"option\">--debug</code>\u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-N</code><br/></span><span class=\"term\"><code class=\"option\">--no-sync</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f<code class=\"command\">pg_combinebackup</code>\u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-o <em class=\"replaceable\"><code>outputdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--output=<em class=\"replaceable\"><code>outputdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-T <em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--tablespace-mapping=<em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55<em class=\"replaceable\"><code>olddir</code></em>\u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 <em class=\"replaceable\"><code>newdir</code></em>\u3002<em class=\"replaceable\"><code>olddir</code></em>\u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c<em class=\"replaceable\"><code>newdir</code></em>\u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08<code class=\"literal\">=</code>\uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--clone</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a<span class=\"quote\">\u201c<span class=\"quote\">reflink</span>\u201d</span>\uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528\u6587\u4ef6\u514b\u9686\u6765\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n<p lang=\"zh\">\u6587\u4ef6\u514b\u9686\u4ec5\u5728\u67d0\u4e9b\u64cd\u4f5c\u7cfb\u7edf\u548c\u6587\u4ef6\u7cfb\u7edf\u4e0a\u53d7\u652f\u6301\u3002\u5982\u679c\u9009\u62e9\u4e86\u8be5\u9009\u9879\uff0c\u4f46\u7cfb\u7edf\u5e76\u4e0d\u652f\u6301\uff0c<span class=\"application\">pg_combinebackup</span>\u8fd0\u884c\u65f6\u5c06\u62a5\u9519\u3002\u76ee\u524d\uff0c\u5b83\u5728 Linux\uff08\u5185\u6838 4.5 \u53ca\u4ee5\u4e0a\uff09\u4e0a\u7684 Btrfs \u548c XFS\uff08\u5728\u521b\u5efa\u65f6\u542f\u7528\u4e86 reflink \u652f\u6301\u7684\u6587\u4ef6\u7cfb\u7edf\uff09\u4ee5\u53ca macOS \u4e0a\u7684 APFS \u4e0a\u53d7\u652f\u6301\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1<code class=\"option\">--copy-file-range</code>\u3001<code class=\"option\">--clone</code> \u548c<code class=\"option\">-k</code>/<code class=\"option\">--link</code>\u3002\uff09</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy-file-range</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e<code class=\"option\">--clone</code>\u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--manifest-checksums=<em class=\"replaceable\"><code>algorithm</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u4e0e<a class=\"xref\" href=\"/docs/devel/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a>\u4e00\u6837\uff0c<span class=\"application\">pg_combinebackup</span>\u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a<code class=\"literal\">NONE</code>\u3001<code class=\"literal\">CRC32C</code>\u3001<code class=\"literal\">SHA224</code>\u3001<code class=\"literal\">SHA256</code>\u3001<code class=\"literal\">SHA384</code>\u548c<code class=\"literal\">SHA512</code>\u3002\u9ed8\u8ba4\u503c\u4e3a<code class=\"literal\">CRC32C</code>\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--no-manifest</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--sync-method=<em class=\"replaceable\"><code>method</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\u5f53\u8bbe\u7f6e\u4e3a<code class=\"literal\">fsync</code>\uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002</p>\n<p lang=\"zh\">\u5728 Linux \u4e0a\uff0c\u4e5f\u53ef\u4ee5\u6539\u7528<code class=\"literal\">syncfs</code>\uff0c\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u540c\u6b65\u5305\u542b\u5907\u4efd\u76ee\u5f55\u7684\u6574\u4e2a\u6587\u4ef6\u7cfb\u7edf\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c<code class=\"command\">pg_combinebackup</code> \u8fd8\u4f1a\u540c\u6b65\u5305\u542b WAL \u6587\u4ef6\u548c\u5404\u8868\u7a7a\u95f4\u7684\u6587\u4ef6\u7cfb\u7edf\u3002\u5173\u4e8e\u4f7f\u7528<code class=\"literal\">syncfs</code>\u65f6\u9700\u8981\u6ce8\u610f\u7684\u4e8b\u9879\uff0c\u8bf7\u53c2\u89c1<a class=\"xref\" href=\"/docs/devel/runtime-config-error-handling.html#GUC-RECOVERY-INIT-SYNC-METHOD\">recovery_init_sync_method</a>\u3002</p>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"option\">--no-sync</code>\u65f6\uff0c\u6b64\u9009\u9879\u65e0\u6548\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-V</code><br/></span><span class=\"term\"><code class=\"option\">--version</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6253\u5370<span class=\"application\">pg_combinebackup</span>\u7248\u672c\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-?</code><br/></span><span class=\"term\"><code class=\"option\">--help</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u663e\u793a<span class=\"application\">pg_combinebackup</span>\u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n</dl>\n</div>\n</div>\n<div class=\"refsect1\" id=\"APP-PGCOMBINEBACKUP-LIMITATIONS\">\n<h2 lang=\"zh\">\u9650\u5236</h2>\n<p lang=\"zh\"><code class=\"literal\">pg_combinebackup</code>\u5728\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u65f6\u4e0d\u4f1a\u91cd\u65b0\u8ba1\u7b97\u9875\u9762\u6821\u9a8c\u548c\u3002\u56e0\u6b64\uff0c\u5bf9\u4e8e\u7528\u4e8e\u91cd\u5efa\u7684\u67d0\u4e9b\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\u3001\u800c\u6700\u7ec8\u5907\u4efd\u662f\u5728\u542f\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\u8fd9\u79cd\u94fe\uff0c\u5b83\u4f1a\u62d2\u7edd\u5904\u7406\uff1a\u751f\u6210\u7684\u76ee\u5f55\u5c06\u5305\u542b\u6821\u9a8c\u548c\u65e0\u6548\u7684\u9875\u9762\uff0c\u96c6\u7c07\u4e00\u65e6\u8bfb\u5230\u8fd9\u4e9b\u9875\u9762\u5c31\u4f1a\u65e0\u6cd5\u901a\u8fc7\u6821\u9a8c\u548c\u9a8c\u8bc1\u3002\u5728\u4f7f\u7528<a class=\"xref\" href=\"/docs/devel/app-pgchecksums.html\" title=\"pg_checksums\"><span class=\"refentrytitle\"><span class=\"application\">pg_checksums</span></span></a>\u542f\u7528\u6570\u636e\u6821\u9a8c\u548c\u4e4b\u540e\uff0c\u8bf7\u91cd\u65b0\u521b\u5efa\u4e00\u6b21\u65b0\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u76f8\u53cd\u7684\u60c5\u5f62\u5219\u53ef\u4ee5\u63a5\u53d7\uff1a\u5f53\u6700\u7ec8\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u4ece\u8f83\u65e9\u5907\u4efd\u590d\u5236\u800c\u6765\u7684\u8fc7\u671f\u6821\u9a8c\u548c\u6c38\u8fdc\u4e0d\u4f1a\u88ab\u9a8c\u8bc1\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.8\">\n<h2 lang=\"zh\">\u73af\u5883</h2>\n<p lang=\"zh\">\u4e0e\u5927\u591a\u6570\u5176\u4ed6<span class=\"productname\">PostgreSQL</span>\u5de5\u5177\u4e00\u6837\uff0c\u6b64\u5de5\u5177\u4e5f\u4f7f\u7528<span class=\"application\">libpq</span>\u652f\u6301\u7684\u73af\u5883\u53d8\u91cf\uff08\u89c1<a class=\"xref\" href=\"/docs/devel/libpq-envars.html\" title=\"32.14.\u00a0\u73af\u5883\u53d8\u91cf\">\u7b2c\u00a032.14\u00a0\u8282</a>\uff09\u3002</p>\n<p lang=\"zh\">\u73af\u5883\u53d8\u91cf<code class=\"envar\">PG_COLOR</code>\u6307\u5b9a\u662f\u5426\u5728\u8bca\u65ad\u6d88\u606f\u4e2d\u4f7f\u7528\u989c\u8272\u3002\u53ef\u80fd\u7684\u503c\u4e3a<code class=\"literal\">always</code>\u3001<code class=\"literal\">auto</code>\u548c<code class=\"literal\">never</code>\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.9\">\n<h2 lang=\"zh\">\u53e6\u89c1</h2><span class=\"simplelist\"><a class=\"xref\" href=\"https://pg.center/docs/devel/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a></span>\n</div>\n</div></div>", "manual_path": "app-pgcombinebackup.html", "localization": {"status": "complete", "sources": [{"url": "/docs/devel/app-pgcombinebackup.html", "method": "same-major semantic node", "sha256": "ef9f3d3a5b532109486a6133f6b72a007195d792ca287780cf0aab07ae7a54e3", "language": "zh", "matched_nodes": ["#APP-PGCOMBINEBACKUP/div[2]/p[1]", "#APP-PGCOMBINEBACKUP/div[3]/h2[0]", "#APP-PGCOMBINEBACKUP/div[4]/p[1]", "#APP-PGCOMBINEBACKUP/div[4]/p[2]", "#APP-PGCOMBINEBACKUP/div[4]/p[3]", "#APP-PGCOMBINEBACKUP/div[4]/p[4]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[19]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[25]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[27]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[5]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[7]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[9]", "#APP-PGCOMBINEBACKUP/div[6]/h2[0]", "#APP-PGCOMBINEBACKUP/div[6]/p[1]", "#APP-PGCOMBINEBACKUP/div[6]/p[2]", "#APP-PGCOMBINEBACKUP/div[7]/h2[0]", "#APP-PGCOMBINEBACKUP/div[7]/p[1]", "#APP-PGCOMBINEBACKUP/div[7]/p[2]", "#APP-PGCOMBINEBACKUP/div[8]/h2[0]"]}], "language": "zh", "original_text": {"/summary": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/category": "Client applications", "/versions/20/description/0": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/versions/20/facts/0/label": "Documented executable", "/versions/20/facts/1/label": "Executable version", "/versions/20/facts/2/label": "Reference inventory", "/versions/20/facts/2/value": "Client applications", "/versions/20/facts/3/label": "Option definition groups", "/versions/20/tables/0/title": "Documented options", "/versions/20/tables/0/rows/0/summary": "Print lots of debug logging output on stderr .", "/versions/20/tables/0/rows/1/summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "/versions/20/tables/0/rows/2/summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "/versions/20/tables/0/rows/3/summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "/versions/20/tables/0/rows/4/summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "/versions/20/tables/0/rows/5/summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "/versions/20/tables/0/rows/6/summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "/versions/20/tables/0/rows/7/summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "/versions/20/tables/0/rows/8/summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "/versions/20/tables/0/rows/9/summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "/versions/20/tables/0/columns/0/label": "Option and arguments", "/versions/20/tables/0/columns/1/label": "Description", "/versions/20/tables/0/rows/10/summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "/versions/20/tables/0/rows/11/summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "/versions/20/tables/0/rows/12/summary": "Prints the pg_combinebackup version and exits.", "/versions/20/tables/0/rows/13/summary": "Shows help about pg_combinebackup command line arguments, and exits."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "9b909c0a2bf0acb9514d809ea9f78dc0070f9179ca538192162593b8b83546f4"}, "comparison_data": {"options": [{"names": ["-d", "--debug"], "signature": "-d --debug", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "signature": "-k --link", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "signature": "-n --dry-run", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "signature": "-N --no-sync", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "signature": "-o outputdir --output= outputdir", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "signature": "--clone", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "signature": "--copy", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "signature": "--copy-file-range", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "signature": "--manifest-checksums= algorithm", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "signature": "--no-manifest", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "signature": "--sync-method= method", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "signature": "-V --version", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "signature": "-? --help", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "environment": []}, "comparison_hash": "59008256ecaf745d4645dde1d240c93697d28d59a42c9b28b8c7a30b44585384", "manual_language": "zh"}}}, "snapshot": {"facts": [{"label": "\u624b\u518c\u4e2d\u7684\u53ef\u6267\u884c\u7a0b\u5e8f", "value": "pg_combinebackup"}, {"label": "\u7a0b\u5e8f\u7248\u672c", "value": "18.6"}, {"label": "\u53c2\u8003\u6e05\u5355", "value": "\u5ba2\u6237\u7aef\u7a0b\u5e8f"}, {"label": "\u9009\u9879\u5b9a\u4e49\u7ec4", "value": "14"}], "tables": [{"key": "options", "rows": [{"summary": "\u5728 stderr \u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-d --debug"}}, {"summary": "\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 pg_combinebackup \u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-k --link"}}, {"summary": "-n / --dry-run \u4f1a\u8ba9 pg_combinebackup \u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e --debug \u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-n --dry-run"}}, {"summary": "\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c pg_combinebackup \u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f pg_combinebackup \u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-N --no-sync"}}, {"summary": "\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-o outputdir --output= outputdir"}}, {"summary": "\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55 olddir \u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 newdir \u3002 olddir \u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c newdir \u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08 = \uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-T olddir = newdir --tablespace-mapping= olddir = newdir"}}, {"summary": "\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a \u201c reflink \u201d \uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--clone"}}, {"summary": "\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1 --copy-file-range \u3001 --clone \u548c -k / --link \u3002\uff09", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--copy"}}, {"summary": "\u4f7f\u7528 copy_file_range \u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e --clone \u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--copy-file-range"}}, {"summary": "\u4e0e pg_basebackup \u4e00\u6837\uff0c pg_combinebackup \u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a NONE \u3001 CRC32C \u3001 SHA224 \u3001 SHA256 \u3001 SHA384 \u548c SHA512 \u3002\u9ed8\u8ba4\u503c\u4e3a CRC32C \u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--manifest-checksums= algorithm"}}, {"summary": "\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--no-manifest"}}, {"summary": "\u5f53\u8bbe\u7f6e\u4e3a fsync \uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c pg_combinebackup \u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "--sync-method= method"}}, {"summary": "\u6253\u5370 pg_combinebackup \u7248\u672c\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-V --version"}}, {"summary": "\u663e\u793a pg_combinebackup \u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002", "signature": {"url": "/docs/18/app-pgcombinebackup.html", "text": "-? --help"}}], "title": "\u624b\u518c\u4e2d\u7684\u9009\u9879", "columns": [{"key": "signature", "label": "\u9009\u9879\u4e0e\u53c2\u6570"}, {"key": "summary", "label": "\u8bf4\u660e"}]}], "options": [{"names": ["-d", "--debug"], "summary": "Print lots of debug logging output on stderr .", "signature": "-d --debug", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "signature": "-k --link", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "signature": "-n --dry-run", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "signature": "-N --no-sync", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "signature": "-o outputdir --output= outputdir", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "signature": "--clone", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "signature": "--copy", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "signature": "--copy-file-range", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "signature": "--manifest-checksums= algorithm", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "signature": "--no-manifest", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "signature": "--sync-method= method", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "summary": "Prints the pg_combinebackup version and exits.", "signature": "-V --version", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "summary": "Shows help about pg_combinebackup command line arguments, and exits.", "signature": "-? --help", "source_url": "/docs/18/app-pgcombinebackup.html", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "related": [], "release": {"ref": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "label": "18.6", "major": "18", "channel": "stable", "manifest": {"pdf": {"A4": {"url": "/files/documentation/pdf/18/postgresql-18-A4.pdf", "bytes": 15865106, "pages": 3154, "sha256": "19512c405da53f9f7fcf0abba359223aa65f021be025bf3411381918f92e3190", "built_at": "2026-09-26"}, "US": {"url": "/files/documentation/pdf/18/postgresql-18-US.pdf", "bytes": 15748059, "pages": 3328, "sha256": "facbe6c229e598b872d3d98bef53308f46e06746006fa4590de9a7de9dd46319", "built_at": "2026-09-26"}}, "tree": "18", "index": "index.html", "major": "18", "pages": 1148, "release": "18.6", "source_url": "https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2", "svg_assets": 3, "source_mode": "en SGML built with pinned official archive", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "revision": "ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8", "evidence_kind": "English manual and source declarations", "source_sha256": "555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f"}, "sources": [{"url": "https://pg.center/docs/18/app-pgcombinebackup.html", "file": "app-pgcombinebackup.html", "label": "18.6 English manual \u00b7 app-pgcombinebackup.html", "anchor": "", "sha256": "919ea0092ca93f97635f32b55c31e519379c8f693b26f91826a9f9b8c4ba2717", "language": "en", "original_url": "/docs/18/app-pgcombinebackup.html"}, {"url": "https://pg.center/docs/18/reference-client.html", "file": "reference-client.html", "label": "Client applications inventory", "anchor": "", "sha256": "68f726af77272fe73a827be2b7b5958d0f2239a6f8ed44264e9d42496bfa4fd0", "language": "en", "original_url": "/docs/18/reference-client.html"}], "sections": [], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "signature": "pg_combinebackup [ option ...] [ backup_directory ...]", "description": ["pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd"], "environment": [], "manual_html": "<div><div class=\"refentry\" id=\"APP-PGCOMBINEBACKUP\">\n<div class=\"titlepage\"></div>\n<div class=\"refnamediv\">\n<h2><span class=\"refentrytitle\"><span class=\"application\">pg_combinebackup</span></span></h2>\n<p lang=\"zh\">pg_combinebackup \u2014 \u4ece\u589e\u91cf\u5907\u4efd\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u5907\u4efd\u91cd\u5efa\u5b8c\u6574\u5907\u4efd</p>\n</div>\n<div class=\"refsynopsisdiv\">\n<h2 lang=\"zh\">\u5927\u7eb2</h2>\n<div class=\"cmdsynopsis\">\n<p id=\"id-1.9.4.12.4.1\"><code class=\"command\">pg_combinebackup</code> [<em class=\"replaceable\"><code>option</code></em>...] [<em class=\"replaceable\"><code>backup_directory</code></em>...]</p>\n</div>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.5\">\n<h2 lang=\"zh\">\u8bf4\u660e</h2>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u7528\u4e8e\u4ece<a class=\"link\" href=\"/docs/18/continuous-archiving.html#BACKUP-INCREMENTAL-BACKUP\" title=\"25.3.3.\u00a0\u8fdb\u884c\u589e\u91cf\u5907\u4efd\">\u589e\u91cf\u5907\u4efd</a>\u53ca\u5176\u6240\u4f9d\u8d56\u7684\u66f4\u65e9\u5907\u4efd\u4e2d\u91cd\u5efa\u4e00\u4e2a\u5408\u6210\u7684\u5b8c\u6574\u5907\u4efd\u3002</p>\n<p lang=\"zh\">\u8bf7\u5728\u547d\u4ee4\u884c\u4e0a\u6309\u7167\u4ece\u65e7\u5230\u65b0\u7684\u987a\u5e8f\u6307\u5b9a\u6240\u6709\u5fc5\u9700\u7684\u5907\u4efd\u3002\u4e5f\u5c31\u662f\u8bf4\uff0c\u7b2c\u4e00\u4e2a\u5907\u4efd\u76ee\u5f55\u5e94\u5f53\u662f\u5b8c\u6574\u5907\u4efd\u7684\u8def\u5f84\uff0c\u6700\u540e\u4e00\u4e2a\u5e94\u5f53\u662f\u60a8\u5e0c\u671b\u6062\u590d\u7684\u6700\u7ec8\u589e\u91cf\u5907\u4efd\u7684\u8def\u5f84\u3002\u91cd\u5efa\u540e\u7684\u5907\u4efd\u5c06\u5199\u5165\u7531<code class=\"option\">-o</code>\u9009\u9879\u6307\u5b9a\u7684\u8f93\u51fa\u76ee\u5f55\u3002</p>\n<p lang=\"zh\"><span class=\"application\">pg_combinebackup</span>\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u60a8\u6307\u5b9a\u7684\u8fd9\u4e9b\u5907\u4efd\u662f\u5426\u6784\u6210\u4e00\u6761\u5408\u6cd5\u7684\u5907\u4efd\u94fe\uff0c\u5e76\u4e14\u80fd\u5426\u636e\u6b64\u91cd\u5efa\u51fa\u6b63\u786e\u7684\u5b8c\u6574\u5907\u4efd\u3002\u4f46\u5b83\u5e76\u4e0d\u662f\u4e3a\u5e2e\u52a9\u60a8\u8ddf\u8e2a\u54ea\u4e9b\u5907\u4efd\u4f9d\u8d56\u4e8e\u54ea\u4e9b\u5176\u4ed6\u5907\u4efd\u800c\u8bbe\u8ba1\u7684\u3002\u5982\u679c\u60a8\u5220\u9664\u4e86\u589e\u91cf\u5907\u4efd\u6240\u4f9d\u8d56\u7684\u4e00\u4e2a\u6216\u591a\u4e2a\u5148\u524d\u5907\u4efd\uff0c\u5c31\u65e0\u6cd5\u6062\u590d\u8be5\u589e\u91cf\u5907\u4efd\u3002\u6b64\u5916\uff0c<span class=\"application\">pg_combinebackup</span>\u53ea\u4f1a\u5c1d\u8bd5\u9a8c\u8bc1\u8fd9\u4e9b\u5907\u4efd\u76f8\u4e92\u4e4b\u95f4\u7684\u5173\u7cfb\u662f\u5426\u6b63\u786e\uff0c\u800c\u4e0d\u4f1a\u9a8c\u8bc1\u6bcf\u4e2a\u5355\u72ec\u5907\u4efd\u672c\u8eab\u662f\u5426\u5b8c\u597d\uff1b\u5982\u9700\u5b8c\u6210\u8be5\u9879\u9a8c\u8bc1\uff0c\u8bf7\u4f7f\u7528<a class=\"xref\" href=\"/docs/18/app-pgverifybackup.html\" title=\"pg_verifybackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_verifybackup</span></span></a>\u3002</p>\n<p lang=\"zh\">\u7531\u4e8e<span class=\"application\">pg_combinebackup</span>\u7684\u8f93\u51fa\u662f\u4e00\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u56e0\u6b64\u5b83\u53ef\u4ee5\u4f5c\u4e3a\u5c06\u6765\u8c03\u7528<span class=\"application\">pg_combinebackup</span>\u65f6\u7684\u8f93\u5165\u3002\u5728\u8fd9\u79cd\u60c5\u51b5\u4e0b\uff0c\u53ef\u4ee5\u5728\u547d\u4ee4\u884c\u4e0a\u6307\u5b9a\u8fd9\u4e2a\u5408\u6210\u5b8c\u6574\u5907\u4efd\uff0c\u4ee5\u4ee3\u66ff\u539f\u5148\u7528\u4e8e\u91cd\u5efa\u5b83\u7684\u90a3\u6761\u5907\u4efd\u94fe\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.6\">\n<h2 lang=\"zh\">\u9009\u9879</h2>\n<div class=\"variablelist\">\n<dl class=\"variablelist\">\n<dt><span class=\"term\"><code class=\"option\">-d</code><br/></span><span class=\"term\"><code class=\"option\">--debug</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728<code class=\"filename\">stderr</code>\u4e0a\u8f93\u51fa\u5927\u91cf\u8c03\u8bd5\u65e5\u5fd7\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-k</code><br/></span><span class=\"term\"><code class=\"option\">--link</code></span></dt>\n<dd>\n<p lang=\"zh\">\u5728\u5408\u6210\u5907\u4efd\u4e2d\u4f7f\u7528\u786c\u94fe\u63a5\uff0c\u800c\u4e0d\u662f\u590d\u5236\u6587\u4ef6\u3002\u8fd9\u6837\u91cd\u5efa\u5408\u6210\u5907\u4efd\u53ef\u80fd\u66f4\u5feb\uff08\u56e0\u4e3a\u65e0\u9700\u590d\u5236\u6587\u4ef6\uff09\uff0c\u5e76\u4e14\u5360\u7528\u66f4\u5c11\u78c1\u76d8\u7a7a\u95f4\uff1b\u4f46\u5728\u4f7f\u7528\u8f93\u51fa\u76ee\u5f55\u65f6\u5fc5\u987b\u683c\u5916\u5c0f\u5fc3\uff0c\u56e0\u4e3a\u5bf9\u8be5\u76ee\u5f55\u7684\u4efb\u4f55\u4fee\u6539\uff08\u4f8b\u5982\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u5165\u76ee\u5f55\u3002\u540c\u6837\uff0c\u5bf9\u8f93\u5165\u76ee\u5f55\u7684\u66f4\u6539\uff08\u4f8b\u5982\u5728\u5b8c\u6574\u5907\u4efd\u4e0a\u542f\u52a8\u670d\u52a1\u5668\uff09\u4e5f\u53ef\u80fd\u5f71\u54cd\u8f93\u51fa\u76ee\u5f55\u3002\u56e0\u6b64\uff0c\u6b64\u9009\u9879\u6700\u9002\u5408\u8f93\u5165\u76ee\u5f55\u53ea\u662f\u526f\u672c\u3001\u5e76\u4e14\u4f1a\u5728 <span class=\"application\">pg_combinebackup</span>\u5b8c\u6210\u540e\u88ab\u5220\u9664\u7684\u573a\u666f\u3002</p>\n<p lang=\"zh\">\u8981\u6c42\u8f93\u5165\u5907\u4efd\u548c\u8f93\u51fa\u76ee\u5f55\u4f4d\u4e8e\u540c\u4e00\u6587\u4ef6\u7cfb\u7edf\u4e2d\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u521b\u5efa\u786c\u94fe\u63a5\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-n</code><br/></span><span class=\"term\"><code class=\"option\">--dry-run</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p><code class=\"option\">-n</code>/<code class=\"option\">--dry-run</code>\u4f1a\u8ba9 <code class=\"command\">pg_combinebackup</code>\u786e\u5b9a\u5c06\u8981\u6267\u884c\u54ea\u4e9b\u64cd\u4f5c\uff0c\u800c\u4e0d\u5b9e\u9645\u521b\u5efa\u76ee\u6807\u76ee\u5f55\u6216\u4efb\u4f55\u8f93\u51fa\u6587\u4ef6\u3002\u8be5\u9009\u9879\u4e0e<code class=\"option\">--debug</code>\u7ec4\u5408\u65f6\u5c24\u5176\u6709\u7528\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-N</code><br/></span><span class=\"term\"><code class=\"option\">--no-sync</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u7b49\u5f85\u6240\u6709\u6587\u4ef6\u90fd\u88ab\u5b89\u5168\u5199\u5165\u78c1\u76d8\u3002\u6b64\u9009\u9879\u4f1a\u4f7f<code class=\"command\">pg_combinebackup</code>\u4e0d\u7ecf\u7b49\u5f85\u5c31\u76f4\u63a5\u8fd4\u56de\uff0c\u56e0\u6b64\u901f\u5ea6\u66f4\u5feb\uff0c\u4f46\u8fd9\u610f\u5473\u7740\u5982\u679c\u968f\u540e\u64cd\u4f5c\u7cfb\u7edf\u5d29\u6e83\uff0c\u8f93\u51fa\u5907\u4efd\u53ef\u80fd\u4f1a\u635f\u574f\u3002\u901a\u5e38\uff0c\u6b64\u9009\u9879\u9002\u5408\u6d4b\u8bd5\uff0c\u4f46\u4e0d\u5e94\u7528\u4e8e\u521b\u5efa\u751f\u4ea7\u73af\u5883\u5b89\u88c5\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-o <em class=\"replaceable\"><code>outputdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--output=<em class=\"replaceable\"><code>outputdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6307\u5b9a\u5408\u6210\u5b8c\u6574\u5907\u4efd\u5199\u5165\u7684\u8f93\u51fa\u76ee\u5f55\u3002\u5f53\u524d\u8be5\u53c2\u6570\u662f\u5fc5\u9700\u7684\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-T <em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code><br/></span><span class=\"term\"><code class=\"option\">--tablespace-mapping=<em class=\"replaceable\"><code>olddir</code></em>=<em class=\"replaceable\"><code>newdir</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u5728\u91cd\u5efa\u5907\u4efd\u671f\u95f4\uff0c\u5c06\u76ee\u5f55<em class=\"replaceable\"><code>olddir</code></em>\u4e2d\u7684\u8868\u7a7a\u95f4\u91cd\u5b9a\u4f4d\u5230 <em class=\"replaceable\"><code>newdir</code></em>\u3002<em class=\"replaceable\"><code>olddir</code></em>\u662f\u547d\u4ee4\u884c\u6307\u5b9a\u7684\u6700\u7ec8\u5907\u4efd\u4e2d\u8be5\u8868\u7a7a\u95f4\u7684\u7edd\u5bf9\u8def\u5f84\uff0c<em class=\"replaceable\"><code>newdir</code></em>\u662f\u91cd\u5efa\u5907\u4efd\u4e2d\u8981\u4f7f\u7528\u7684\u7edd\u5bf9\u8def\u5f84\u3002\u82e5\u8def\u5f84\u4e2d\u9700\u8981\u5305\u542b\u7b49\u53f7\uff08<code class=\"literal\">=</code>\uff09\uff0c\u8bf7\u5728\u5176\u524d\u52a0\u53cd\u659c\u6760\u3002\u53ef\u591a\u6b21\u6307\u5b9a\u6b64\u9009\u9879\u4ee5\u6620\u5c04\u591a\u4e2a\u8868\u7a7a\u95f4\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--clone</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528\u9ad8\u6548\u7684\u6587\u4ef6\u514b\u9686\uff08\u67d0\u4e9b\u7cfb\u7edf\u5c06\u5176\u79f0\u4e3a<span class=\"quote\">\u201c<span class=\"quote\">reflink</span>\u201d</span>\uff09\uff0c\u4ee3\u66ff\u5411\u65b0\u6570\u636e\u76ee\u5f55\u590d\u5236\u6587\u4ef6\uff0c\u8fd9\u6837\u53ef\u80fd\u5b9e\u73b0\u51e0\u4e4e\u77ac\u65f6\u7684\u6570\u636e\u6587\u4ef6\u590d\u5236\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528\u6587\u4ef6\u514b\u9686\u6765\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n<p lang=\"zh\">\u6587\u4ef6\u514b\u9686\u4ec5\u5728\u67d0\u4e9b\u64cd\u4f5c\u7cfb\u7edf\u548c\u6587\u4ef6\u7cfb\u7edf\u4e0a\u53d7\u652f\u6301\u3002\u5982\u679c\u9009\u62e9\u4e86\u8be5\u9009\u9879\uff0c\u4f46\u7cfb\u7edf\u5e76\u4e0d\u652f\u6301\uff0c<span class=\"application\">pg_combinebackup</span>\u8fd0\u884c\u65f6\u5c06\u62a5\u9519\u3002\u76ee\u524d\uff0c\u5b83\u5728 Linux\uff08\u5185\u6838 4.5 \u53ca\u4ee5\u4e0a\uff09\u4e0a\u7684 Btrfs \u548c XFS\uff08\u5728\u521b\u5efa\u65f6\u542f\u7528\u4e86 reflink \u652f\u6301\u7684\u6587\u4ef6\u7cfb\u7edf\uff09\u4ee5\u53ca macOS \u4e0a\u7684 APFS \u4e0a\u53d7\u652f\u6301\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6267\u884c\u5e38\u89c4\u6587\u4ef6\u590d\u5236\u3002\u8fd9\u662f\u9ed8\u8ba4\u884c\u4e3a\u3002\uff08\u53e6\u89c1<code class=\"option\">--copy-file-range</code>\u3001<code class=\"option\">--clone</code> \u548c<code class=\"option\">-k</code>/<code class=\"option\">--link</code>\u3002\uff09</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--copy-file-range</code></span></dt>\n<dd>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u7cfb\u7edf\u8c03\u7528\u8fdb\u884c\u9ad8\u6548\u590d\u5236\u3002\u5728\u67d0\u4e9b\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u8fd9\u4f1a\u5f97\u5230\u4e0e<code class=\"option\">--clone</code>\u7c7b\u4f3c\u7684\u7ed3\u679c\uff0c\u5373\u5171\u4eab\u7269\u7406\u78c1\u76d8\u5757\uff1b\u800c\u5728\u5176\u4ed6\u6587\u4ef6\u7cfb\u7edf\u4e0a\uff0c\u5b83\u4ecd\u53ef\u80fd\u590d\u5236\u6570\u636e\u5757\uff0c\u4f46\u4f1a\u901a\u8fc7\u4f18\u5316\u540e\u7684\u8def\u5f84\u8fdb\u884c\u3002\u76ee\u524d\u652f\u6301 Linux \u548c FreeBSD\u3002</p>\n<p lang=\"zh\">\u5982\u679c\u5907\u4efd\u6e05\u5355\u4e0d\u53ef\u7528\uff0c\u6216\u8005\u5176\u4e2d\u4e0d\u5305\u542b\u6b63\u786e\u7c7b\u578b\u7684\u6821\u9a8c\u548c\uff0c\u4ecd\u4f1a\u4f7f\u7528<code class=\"function\">copy_file_range</code>\u590d\u5236\u6587\u4ef6\uff0c\u4f46\u4e5f\u4f1a\u6309\u5757\u8bfb\u53d6\u8be5\u6587\u4ef6\u4ee5\u8ba1\u7b97\u6821\u9a8c\u548c\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--manifest-checksums=<em class=\"replaceable\"><code>algorithm</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u4e0e<a class=\"xref\" href=\"/docs/18/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a>\u4e00\u6837\uff0c<span class=\"application\">pg_combinebackup</span>\u4f1a\u5728\u8f93\u51fa\u76ee\u5f55\u4e2d\u5199\u5165\u5907\u4efd\u6e05\u5355\u3002\u6b64\u9009\u9879\u6307\u5b9a\u5bf9\u6e05\u5355\u4e2d\u6bcf\u4e2a\u6587\u4ef6\u4f7f\u7528\u7684\u6821\u9a8c\u548c\u7b97\u6cd5\u3002\u5f53\u524d\u53ef\u7528\u7b97\u6cd5\u4e3a<code class=\"literal\">NONE</code>\u3001<code class=\"literal\">CRC32C</code>\u3001<code class=\"literal\">SHA224</code>\u3001<code class=\"literal\">SHA256</code>\u3001<code class=\"literal\">SHA384</code>\u548c<code class=\"literal\">SHA512</code>\u3002\u9ed8\u8ba4\u503c\u4e3a<code class=\"literal\">CRC32C</code>\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--no-manifest</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u7981\u7528\u5907\u4efd\u6e05\u5355\u7684\u751f\u6210\u3002\u82e5\u672a\u6307\u5b9a\u8be5\u9009\u9879\uff0c\u5219\u4f1a\u5c06\u91cd\u5efa\u5907\u4efd\u7684\u6e05\u5355\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">--sync-method=<em class=\"replaceable\"><code>method</code></em></code></span></dt>\n<dd>\n<p lang=\"zh\">\u5f53\u8bbe\u7f6e\u4e3a<code class=\"literal\">fsync</code>\uff08\u8fd9\u662f\u9ed8\u8ba4\u503c\uff09\u65f6\uff0c<code class=\"command\">pg_combinebackup</code>\u4f1a\u9012\u5f52\u6253\u5f00\u5e76\u540c\u6b65\u5907\u4efd\u76ee\u5f55\u4e2d\u7684\u6240\u6709\u6587\u4ef6\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c\u641c\u7d22\u6587\u4ef6\u65f6\u4f1a\u8ddf\u968f WAL \u76ee\u5f55\u548c\u6bcf\u4e2a\u5df2\u914d\u7f6e\u8868\u7a7a\u95f4\u7684\u7b26\u53f7\u94fe\u63a5\u3002</p>\n<p lang=\"zh\">\u5728 Linux \u4e0a\uff0c\u4e5f\u53ef\u4ee5\u6539\u7528<code class=\"literal\">syncfs</code>\uff0c\u8ba9\u64cd\u4f5c\u7cfb\u7edf\u540c\u6b65\u5305\u542b\u5907\u4efd\u76ee\u5f55\u7684\u6574\u4e2a\u6587\u4ef6\u7cfb\u7edf\u3002\u4f7f\u7528\u666e\u901a\u6587\u4ef6\u683c\u5f0f\u65f6\uff0c<code class=\"command\">pg_combinebackup</code> \u8fd8\u4f1a\u540c\u6b65\u5305\u542b WAL \u6587\u4ef6\u548c\u5404\u8868\u7a7a\u95f4\u7684\u6587\u4ef6\u7cfb\u7edf\u3002\u5173\u4e8e\u4f7f\u7528<code class=\"literal\">syncfs</code>\u65f6\u9700\u8981\u6ce8\u610f\u7684\u4e8b\u9879\uff0c\u8bf7\u53c2\u89c1<a class=\"xref\" href=\"/docs/18/runtime-config-error-handling.html#GUC-RECOVERY-INIT-SYNC-METHOD\">recovery_init_sync_method</a>\u3002</p>\n<p lang=\"zh\">\u4f7f\u7528<code class=\"option\">--no-sync</code>\u65f6\uff0c\u6b64\u9009\u9879\u65e0\u6548\u3002</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-V</code><br/></span><span class=\"term\"><code class=\"option\">--version</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u6253\u5370<span class=\"application\">pg_combinebackup</span>\u7248\u672c\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n<dt><span class=\"term\"><code class=\"option\">-?</code><br/></span><span class=\"term\"><code class=\"option\">--help</code></span></dt>\n<dd>\n<p lang=\"zh\">\n<p>\u663e\u793a<span class=\"application\">pg_combinebackup</span>\u547d\u4ee4\u884c\u53c2\u6570\u5e2e\u52a9\u5e76\u9000\u51fa\u3002</p>\n</p>\n</dd>\n</dl>\n</div>\n</div>\n<div class=\"refsect1\" id=\"APP-PGCOMBINEBACKUP-LIMITATIONS\">\n<h2 lang=\"zh\">\u9650\u5236</h2>\n<p lang=\"zh\"><code class=\"literal\">pg_combinebackup</code>\u5728\u5199\u5165\u8f93\u51fa\u76ee\u5f55\u65f6\u4e0d\u4f1a\u91cd\u65b0\u8ba1\u7b97\u9875\u9762\u6821\u9a8c\u548c\u3002\u56e0\u6b64\uff0c\u5982\u679c\u7528\u4e8e\u91cd\u5efa\u7684\u67d0\u4e9b\u5907\u4efd\u662f\u5728\u7981\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u800c\u6700\u7ec8\u5907\u4efd\u662f\u5728\u542f\u7528\u6821\u9a8c\u548c\u65f6\u521b\u5efa\u7684\uff0c\u5219\u751f\u6210\u7684\u76ee\u5f55\u4e2d\u53ef\u80fd\u5305\u542b\u6821\u9a8c\u548c\u65e0\u6548\u7684\u9875\u9762\u3002</p>\n<p lang=\"zh\">\u4e3a\u907f\u514d\u8fd9\u4e2a\u95ee\u9898\uff0c\u5efa\u8bae\u5728\u4f7f\u7528<a class=\"xref\" href=\"/docs/18/app-pgchecksums.html\" title=\"pg_checksums\"><span class=\"refentrytitle\"><span class=\"application\">pg_checksums</span></span></a>\u66f4\u6539\u96c6\u7c07\u7684\u6821\u9a8c\u548c\u72b6\u6001\u4e4b\u540e\u91cd\u65b0\u521b\u5efa\u4e00\u6b21\u65b0\u7684\u5b8c\u6574\u5907\u4efd\u3002\u5426\u5219\uff0c\u60a8\u4e5f\u53ef\u4ee5\u5bf9\u7531<code class=\"literal\">pg_combinebackup</code>\u751f\u6210\u7684\u76ee\u5f55\u5148\u7981\u7528\u6821\u9a8c\u548c\uff0c\u7136\u540e\u518d\u6309\u9700\u91cd\u65b0\u542f\u7528\uff0c\u4ee5\u4fee\u6b63\u8fd9\u4e2a\u95ee\u9898\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.8\">\n<h2 lang=\"zh\">\u73af\u5883</h2>\n<p lang=\"zh\">\u4e0e\u5927\u591a\u6570\u5176\u4ed6<span class=\"productname\">PostgreSQL</span>\u5de5\u5177\u4e00\u6837\uff0c\u6b64\u5de5\u5177\u4e5f\u4f7f\u7528<span class=\"application\">libpq</span>\u652f\u6301\u7684\u73af\u5883\u53d8\u91cf\uff08\u89c1<a class=\"xref\" href=\"/docs/18/libpq-envars.html\" title=\"32.15.\u00a0\u73af\u5883\u53d8\u91cf\">\u7b2c\u00a032.15\u00a0\u8282</a>\uff09\u3002</p>\n<p lang=\"zh\">\u73af\u5883\u53d8\u91cf<code class=\"envar\">PG_COLOR</code>\u6307\u5b9a\u662f\u5426\u5728\u8bca\u65ad\u6d88\u606f\u4e2d\u4f7f\u7528\u989c\u8272\u3002\u53ef\u80fd\u7684\u503c\u4e3a<code class=\"literal\">always</code>\u3001<code class=\"literal\">auto</code>\u548c<code class=\"literal\">never</code>\u3002</p>\n</div>\n<div class=\"refsect1\" id=\"id-1.9.4.12.9\">\n<h2 lang=\"zh\">\u53e6\u89c1</h2><span class=\"simplelist\"><a class=\"xref\" href=\"https://pg.center/docs/18/app-pgbasebackup.html\" title=\"pg_basebackup\"><span class=\"refentrytitle\"><span class=\"application\">pg_basebackup</span></span></a></span>\n</div>\n</div></div>", "manual_path": "app-pgcombinebackup.html", "localization": {"status": "complete", "sources": [{"url": "/docs/18/app-pgcombinebackup.html", "method": "same-major semantic node", "sha256": "f9b5d610e3fc6d898da25a0a0968a76e1880acfd83956e43a50dc42df444daf8", "language": "zh", "matched_nodes": ["#APP-PGCOMBINEBACKUP/div[2]/p[1]", "#APP-PGCOMBINEBACKUP/div[3]/h2[0]", "#APP-PGCOMBINEBACKUP/div[4]/p[1]", "#APP-PGCOMBINEBACKUP/div[4]/p[2]", "#APP-PGCOMBINEBACKUP/div[4]/p[3]", "#APP-PGCOMBINEBACKUP/div[4]/p[4]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[11]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[13]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[15]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[17]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[19]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[21]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[23]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[25]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[27]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[0]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[1]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[3]/p[2]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[5]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[7]", "#APP-PGCOMBINEBACKUP/div[5]/div[1]/dl[0]/dd[9]", "#APP-PGCOMBINEBACKUP/div[6]/h2[0]", "#APP-PGCOMBINEBACKUP/div[6]/p[1]", "#APP-PGCOMBINEBACKUP/div[6]/p[2]", "#APP-PGCOMBINEBACKUP/div[7]/h2[0]", "#APP-PGCOMBINEBACKUP/div[7]/p[1]", "#APP-PGCOMBINEBACKUP/div[7]/p[2]", "#APP-PGCOMBINEBACKUP/div[8]/h2[0]"]}], "language": "zh", "original_text": {"/versions/18/description/0": "pg_combinebackup \u2014 reconstruct a full backup from an incremental backup and dependent backups", "/versions/18/facts/0/label": "Documented executable", "/versions/18/facts/1/label": "Executable version", "/versions/18/facts/2/label": "Reference inventory", "/versions/18/facts/2/value": "Client applications", "/versions/18/facts/3/label": "Option definition groups", "/versions/18/tables/0/title": "Documented options", "/versions/18/tables/0/rows/0/summary": "Print lots of debug logging output on stderr .", "/versions/18/tables/0/rows/1/summary": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed.", "/versions/18/tables/0/rows/2/summary": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .", "/versions/18/tables/0/rows/3/summary": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.", "/versions/18/tables/0/rows/4/summary": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.", "/versions/18/tables/0/rows/5/summary": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.", "/versions/18/tables/0/rows/6/summary": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files.", "/versions/18/tables/0/rows/7/summary": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)", "/versions/18/tables/0/rows/8/summary": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD.", "/versions/18/tables/0/rows/9/summary": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .", "/versions/18/tables/0/columns/0/label": "Option and arguments", "/versions/18/tables/0/columns/1/label": "Description", "/versions/18/tables/0/rows/10/summary": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.", "/versions/18/tables/0/rows/11/summary": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace.", "/versions/18/tables/0/rows/12/summary": "Prints the pg_combinebackup version and exits.", "/versions/18/tables/0/rows/13/summary": "Shows help about pg_combinebackup command line arguments, and exits."}, "fallback_fields": [], "source_language": "en", "original_snapshot_sha256": "35c6dc6c16a09271e3bbf896acb0844d7e59a8365cffbc578233da84997d48a0"}, "comparison_data": {"options": [{"names": ["-d", "--debug"], "signature": "-d --debug", "description": "Print lots of debug logging output on stderr ."}, {"names": ["-k", "--link"], "signature": "-k --link", "description": "Use hard links instead of copying files to the synthetic backup. Reconstruction of the synthetic backup might be faster (no file copying) and use less disk space, but care must be taken when using the output directory, because any modifications to that directory (for example, starting the server) can also affect the input directories. Likewise, changes to the input directories (for example, starting the server on the full backup) could affect the output directory. Thus, this option is best used when the input directories are only copies that will be removed after pg_combinebackup has completed. Requires that the input backups and the output directory are in the same file system. If a backup manifest is not available or does not contain checksum of the right type, hard links will still be created, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["-n", "--dry-run"], "signature": "-n --dry-run", "description": "The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug ."}, {"names": ["-N", "--no-sync"], "signature": "-N --no-sync", "description": "By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation."}, {"names": ["-o outputdir", "--output= outputdir"], "signature": "-o outputdir --output= outputdir", "description": "Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required."}, {"names": ["-T olddir = newdir", "--tablespace-mapping= olddir = newdir"], "signature": "-T olddir = newdir --tablespace-mapping= olddir = newdir", "description": "Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces."}, {"names": ["--clone"], "signature": "--clone", "description": "Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS."}, {"names": ["--copy"], "signature": "--copy", "description": "Perform regular file copy. This is the default. (See also --copy-file-range , --clone , and -k / --link .)"}, {"names": ["--copy-file-range"], "signature": "--copy-file-range", "description": "Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation."}, {"names": ["--manifest-checksums= algorithm"], "signature": "--manifest-checksums= algorithm", "description": "Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C ."}, {"names": ["--no-manifest"], "signature": "--no-manifest", "description": "Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory."}, {"names": ["--sync-method= method"], "signature": "--sync-method= method", "description": "When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used."}, {"names": ["-V", "--version"], "signature": "-V --version", "description": "Prints the pg_combinebackup version and exits."}, {"names": ["-?", "--help"], "signature": "-? --help", "description": "Shows help about pg_combinebackup command line arguments, and exits."}], "synopsis": ["pg_combinebackup [ option ...] [ backup_directory ...]"], "environment": []}, "comparison_hash": "59008256ecaf745d4645dde1d240c93697d28d59a42c9b28b8c7a30b44585384", "manual_language": "zh"}, "comparison": {"left": "16", "right": "17", "status": "added", "diff": "--- PostgreSQL 16\n+++ PostgreSQL 17\n@@ -1 +1,106 @@\n-\u8be5\u7248\u672a\u6536\u5f55\n+{\n+  \"environment\": [],\n+  \"options\": [\n+    {\n+      \"description\": \"Print lots of debug logging output on stderr .\",\n+      \"names\": [\n+        \"-d\",\n+        \"--debug\"\n+      ],\n+      \"signature\": \"-d --debug\"\n+    },\n+    {\n+      \"description\": \"The -n / --dry-run option instructs pg_combinebackup to figure out what would be done without actually creating the target directory or any output files. It is particularly useful in combination with --debug .\",\n+      \"names\": [\n+        \"-n\",\n+        \"--dry-run\"\n+      ],\n+      \"signature\": \"-n --dry-run\"\n+    },\n+    {\n+      \"description\": \"By default, pg_combinebackup will wait for all files to be written safely to disk. This option causes pg_combinebackup to return without waiting, which is faster, but means that a subsequent operating system crash can leave the output backup corrupt. Generally, this option is useful for testing but should not be used when creating a production installation.\",\n+      \"names\": [\n+        \"-N\",\n+        \"--no-sync\"\n+      ],\n+      \"signature\": \"-N --no-sync\"\n+    },\n+    {\n+      \"description\": \"Specifies the output directory to which the synthetic full backup should be written. Currently, this argument is required.\",\n+      \"names\": [\n+        \"-o outputdir\",\n+        \"--output= outputdir\"\n+      ],\n+      \"signature\": \"-o outputdir --output= outputdir\"\n+    },\n+    {\n+      \"description\": \"Relocates the tablespace in directory olddir to newdir during the backup. olddir is the absolute path of the tablespace as it exists in the final backup specified on the command line, and newdir is the absolute path to use for the tablespace in the reconstructed backup. If either path needs to contain an equal sign ( = ), precede that with a backslash. This option can be specified multiple times for multiple tablespaces.\",\n+      \"names\": [\n+        \"-T olddir = newdir\",\n+        \"--tablespace-mapping= olddir = newdir\"\n+      ],\n+      \"signature\": \"-T olddir = newdir --tablespace-mapping= olddir = newdir\"\n+    },\n+    {\n+      \"description\": \"Use efficient file cloning (also known as \u201c reflinks \u201d on some systems) instead of copying files to the new data directory, which can result in near-instantaneous copying of the data files. If a backup manifest is not available or does not contain checksum of the right type, file cloning will be used to copy the file, but the file will be also read block-by-block for the checksum calculation. File cloning is only supported on some operating systems and file systems. If it is selected but not supported, the pg_combinebackup run will error. At present, it is supported on Linux (kernel 4.5 or later) with Btrfs and XFS (on file systems created with reflink support), and on macOS with APFS.\",\n+      \"names\": [\n+        \"--clone\"\n+      ],\n+      \"signature\": \"--clone\"\n+    },\n+    {\n+      \"description\": \"Perform regular file copy. This is the default. (See also --copy-file-range and --clone .)\",\n+      \"names\": [\n+        \"--copy\"\n+      ],\n+      \"signature\": \"--copy\"\n+    },\n+    {\n+      \"description\": \"Use the copy_file_range system call for efficient copying. On some file systems this gives results similar to --clone , sharing physical disk blocks, while on others it may still copy blocks, but do so via an optimized path. At present, it is supported on Linux and FreeBSD. If a backup manifest is not available or does not contain checksum of the right type, copy_file_range will be used to copy the file, but the file will be also read block-by-block for the checksum calculation.\",\n+      \"names\": [\n+        \"--copy-file-range\"\n+      ],\n+      \"signature\": \"--copy-file-range\"\n+    },\n+    {\n+      \"description\": \"Like pg_basebackup , pg_combinebackup writes a backup manifest in the output directory. This option specifies the checksum algorithm that should be applied to each file included in the backup manifest. Currently, the available algorithms are NONE , CRC32C , SHA224 , SHA256 , SHA384 , and SHA512 . The default is CRC32C .\",\n+      \"names\": [\n+        \"--manifest-checksums= algorithm\"\n+      ],\n+      \"signature\": \"--manifest-checksums= algorithm\"\n+    },\n+    {\n+      \"description\": \"Disables generation of a backup manifest. If this option is not specified, a backup manifest for the reconstructed backup will be written to the output directory.\",\n+      \"names\": [\n+        \"--no-manifest\"\n+      ],\n+      \"signature\": \"--no-manifest\"\n+    },\n+    {\n+      \"description\": \"When set to fsync , which is the default, pg_combinebackup will recursively open and synchronize all files in the backup directory. When the plain format is used, the search for files will follow symbolic links for the WAL directory and each configured tablespace. On Linux, syncfs may be used instead to ask the operating system to synchronize the whole file system that contains the backup directory. When the plain format is used, pg_combinebackup will also synchronize the file systems that contain the WAL files and each tablespace. See recovery_init_sync_method for information about the caveats to be aware of when using syncfs . This option has no effect when --no-sync is used.\",\n+      \"names\": [\n+        \"--sync-method= method\"\n+      ],\n+      \"signature\": \"--sync-method= method\"\n+    },\n+    {\n+      \"description\": \"Prints the pg_combinebackup version and exits.\",\n+      \"names\": [\n+        \"-V\",\n+        \"--version\"\n+      ],\n+      \"signature\": \"-V --version\"\n+    },\n+    {\n+      \"description\": \"Shows help about pg_combinebackup command line arguments, and exits.\",\n+      \"names\": [\n+        \"-?\",\n+        \"--help\"\n+      ],\n+      \"signature\": \"-? --help\"\n+    }\n+  ],\n+  \"synopsis\": [\n+    \"pg_combinebackup [ option ...] [ backup_directory ...]\"\n+  ]\n+}"}}