pg_createsubscriber

说明

pg_createsubscriber — 将物理副本转换为新的逻辑副本

手册中的可执行程序

pg_createsubscriber

程序版本

18.6

参考清单

服务端程序

选项定义组

18

用法

pg_createsubscriber [ option ...] { -d | --database } dbname { -D | --pgdata } datadir { -P | --publisher-server } connstr

文档与源码

• 18.6 English manual · app-pgcreatesubscriber.html
• Server applications inventory

版本比较

PostgreSQL 16 → 17: 新增收录。

以下差异保留原始字段名与英文源描述。

--- PostgreSQL 16
+++ PostgreSQL 17
@@ -1 +1,124 @@
-该版未收录
+{
+  "environment": [],
+  "options": [
+    {
+      "description": "The name of the database in which to create a subscription. Multiple databases can be selected by writing multiple -d switches.",
+      "names": [
+        "-d dbname",
+        "--database= dbname"
+      ],
+      "signature": "-d dbname --database= dbname"
+    },
+    {
+      "description": "The target directory that contains a cluster directory from a physical replica.",
+      "names": [
+        "-D directory",
+        "--pgdata= directory"
+      ],
+      "signature": "-D directory --pgdata= directory"
+    },
+    {
+      "description": "Do everything except actually modifying the target directory.",
+      "names": [
+        "-n",
+        "--dry-run"
+      ],
+      "signature": "-n --dry-run"
+    },
+    {
+      "description": "The port number on which the target server is listening for connections. Defaults to running the target server on port 50432 to avoid unintended client connections.",
+      "names": [
+        "-p port",
+        "--subscriber-port= port"
+      ],
+      "signature": "-p port --subscriber-port= port"
+    },
+    {
+      "description": "The connection string to the publisher. For details see Section 32.1.1 .",
+      "names": [
+        "-P connstr",
+        "--publisher-server= connstr"
+      ],
+      "signature": "-P connstr --publisher-server= connstr"
+    },
+    {
+      "description": "The directory to use for postmaster sockets on target server. The default is current directory.",
+      "names": [
+        "-s dir",
+        "--socketdir= dir"
+      ],
+      "signature": "-s dir --socketdir= dir"
+    },
+    {
+      "description": "The maximum number of seconds to wait for recovery to end. Setting to 0 disables. The default is 0.",
+      "names": [
+        "-t seconds",
+        "--recovery-timeout= seconds"
+      ],
+      "signature": "-t seconds --recovery-timeout= seconds"
+    },
+    {
+      "description": "The user name to connect as on target server. Defaults to the current operating system user name.",
+      "names": [
+        "-U username",
+        "--subscriber-username= username"
+      ],
+      "signature": "-U username --subscriber-username= username"
+    },
+    {
+      "description": "Enables verbose mode. This will cause pg_createsubscriber to output progress messages and detailed information about each step to standard error. Repeating the option causes additional debug-level messages to appear on standard error.",
+      "names": [
+        "-v",
+        "--verbose"
+      ],
+      "signature": "-v --verbose"
+    },
+    {
+      "description": "Use the specified main server configuration file for the target data directory. pg_createsubscriber internally uses the pg_ctl command to start and stop the target server. It allows you to specify the actual postgresql.conf configuration file if it is stored outside the data directory.",
+      "names": [
+        "--config-file= filename"
+      ],
+      "signature": "--config-file= filename"
+    },
+    {
+      "description": "The publication name to set up the logical replication. Multiple publications can be specified by writing multiple --publication switches. The number of publication names must match the number of specified databases, otherwise an error is reported. The order of the multiple publication name switches must match the order of database switches. If this option is not specified, a generated name is assigned to the publication name.",
+      "names": [
+        "--publication= name"
+      ],
+      "signature": "--publication= name"
+    },
+    {
+      "description": "The replication slot name to set up the logical replication. Multiple replication slots can be specified by writing multiple --replication-slot switches. The number of replication slot names must match the number of specified databases, otherwise an error is reported. The order of the multiple replication slot name switches must match the order of database switches. If this option is not specified, the subscription name is assigned to the replication slot name.",
+      "names": [
+        "--replication-slot= name"
+      ],
+      "signature": "--replication-slot= name"
+    },
+    {
+      "description": "The subscription name to set up the logical replication. Multiple subscriptions can be specified by writing multiple --subscription switches. The number of subscription names must match the number of specified databases, otherwise an error is reported. The order of the multiple subscription name switches must match the order of database switches. If this option is not specified, a generated name is assigned to the subscription name.",
+      "names": [
+        "--subscription= name"
+      ],
+      "signature": "--subscription= name"
+    },
+    {
+      "description": "Print the pg_createsubscriber version and exit.",
+      "names": [
+        "-V",
+        "--version"
+      ],
+      "signature": "-V --version"
+    },
+    {
+      "description": "Show help about pg_createsubscriber command line arguments, and exit.",
+      "names": [
+        "-?",
+        "--help"
+      ],
+      "signature": "-? --help"
+    }
+  ],
+  "synopsis": [
+    "pg_createsubscriber [ option ...] { -d | --database } dbname { -D | --pgdata } datadir { -P | --publisher-server } connstr"
+  ]
+}

比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。

相关条目

• initdb
• pg_archivecleanup
• pg_checksums
• pg_controldata
• pg_ctl
• pg_resetwal
• pg_rewind
• pg_test_fsync
• pg_test_timing
• pg_upgrade
• pg_waldump
• pg_walsummary