pg_upgrade --swap
Recorded source states and original language descriptions. Missing version evidence stays unknown.
The source snapshot records transitions for PostgreSQL 8.1–18. The historical matrix records independent cells for 7.4–18. Neither records support for PostgreSQL 19 or 20; newer versions remain unknown. These source claims are distinct from runtime measurements.
Upgrade
Description
The --swap option moves the data directories from the old cluster to the new cluster and then replaces catalog files with those generated for the new cluster. Seepg_upgrade for more information.
Selected version: PostgreSQL 18
Yes
Compare versions
Original documentation links
Complete source facts and provenance
yaml · center · 1dd22bf9a7f3ec325b894e2836fda535a25529f246a94dd41d6abbfe9997f7fd
{
"Key": "pg_upgrade-swap",
"SourceKind": "yaml",
"SourceDatabase": "center",
"SourceTable": "featurematrix.yaml",
"SourceKey": "pg_upgrade --swap",
"SourceHash": "1dd22bf9a7f3ec325b894e2836fda535a25529f246a94dd41d6abbfe9997f7fd",
"Name": "pg_upgrade --swap",
"NameLocale": "en",
"GroupKey": "upgrade",
"GroupName": "Upgrade",
"GroupLocale": "en",
"Ordinal": 0,
"GroupOrder": 11,
"Facts": {
"feature": {
"description": "The `--swap` option moves the data directories from the old cluster to the new cluster and then replaces catalog files with those generated for the new cluster. See[`pg_upgrade`](https://www.postgresql.org/docs/18/pgupgrade.html) for more information.",
"name": "pg_upgrade --swap",
"versions": {
"18": "Yes"
}
},
"group": "Upgrade",
"versions": {
"max": 18,
"min": 8.1
}
},
"Cells": [
{
"Version": "10",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "11",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "12",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "13",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "14",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "15",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "16",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "17",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "18",
"State": "yes",
"EvidenceKind": "yaml-transition",
"TransitionVersion": "18",
"Supported": true,
"Original": "Yes"
},
{
"Version": "8.1",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "8.2",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "8.3",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "8.4",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.0",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.1",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.2",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.3",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.4",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.5",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
},
{
"Version": "9.6",
"State": "no",
"EvidenceKind": "yaml-default-no",
"TransitionVersion": "",
"Supported": false,
"Original": "No"
}
],
"Texts": [
{
"Locale": "en",
"Title": "pg_upgrade --swap",
"BodyHTML": "\u003cp\u003eThe \u003ccode\u003e--swap\u003c/code\u003e option moves the data directories from the old cluster to the new cluster and then replaces catalog files with those generated for the new cluster. See\u003ca href=\"https://www.postgresql.org/docs/18/pgupgrade.html\" rel=\"nofollow\"\u003e\u003ccode\u003epg_upgrade\u003c/code\u003e\u003c/a\u003e for more information.\u003c/p\u003e\n",
"SourceHash": "1dd22bf9a7f3ec325b894e2836fda535a25529f246a94dd41d6abbfe9997f7fd",
"ContentHash": "5a8bce388d1df3df5b3a3a7623457c7ca8f8708f2fc8ce15170a34e6f7000a93",
"Payload": {
"description": "The `--swap` option moves the data directories from the old cluster to the new cluster and then replaces catalog files with those generated for the new cluster. See[`pg_upgrade`](https://www.postgresql.org/docs/18/pgupgrade.html) for more information.",
"name": "pg_upgrade --swap",
"versions": {
"18": "Yes"
}
}
},
{
"Locale": "zh-Hans",
"Title": "pg_upgrade --swap",
"BodyHTML": "\u003cp\u003e\u003ccode\u003e--swap\u003c/code\u003e 选项会把旧集簇的数据目录直接交换到新集簇，并用新版本生成的目录元数据替换之。\u003c/p\u003e\n",
"SourceHash": "071091951021357a5f492adb04caed6febf4d315ac2626ca027a48dd8ec01d50",
"ContentHash": "66c7df8bff523e0442f9476adef7db79a0abe05ad9e22bb6c39bf7165d790779",
"Payload": {
"description": "`--swap` 选项会把旧集簇的数据目录直接交换到新集簇，并用新版本生成的目录元数据替换之。",
"name": "pg_upgrade --swap"
}
}
],
"GroupTitles": {
"en": "Upgrade",
"zh-Hans": "升级"
}
}