PostgreSQL 文档检索

pg_ctl --core-files命令行工具PG18-c--core-files 在支持的平台上，通过解除对核心转储文件施加的任何软资源限制，尝试允许服务器在崩溃时生成核心转储文件。这样就可以从失败的服务器进程中获得栈跟踪，从而有助于调试或诊断问题。pg_ctl › 选项 pg_ctl --help命令行工具PG18-?--help 显示有关pg_ctl命令行参数的帮助并退出。pg_ctl › 选项 pg_ctl --log=filename命令行工具PG18-l filename--log=filename 将服务器日志输出追加到filename。如果该文件不存在，就会创建它。默认情况下，只有集簇拥有者可以访问该日志文件。如果在集簇中启用了组访问权限，与集簇拥有者同组的用户也可以读取它。pg_ctl › 选项 pg_ctl --mode=mode命令行工具PG18-m mode--mode=mode 指定关闭模式。mode可以是smart、fast或immediate，也可以是这三者之一的首字母。若省略此选项，则默认值为fast。pg_ctl › 选项 pg_ctl --no-wait命令行工具PG18-W--no-wait 不等待操作完成。这与选项-w相反。 如果禁用了等待，将触发所请求的操作，但不会反馈其是否成功。在这种情况下，需要借助服务器日志文件或外部监控系统来检查该操作的进展及成败。 在 PostgreSQL 先前的发行版中，除了stop模式之外，这曾是默认行为。pg_ctl › 选项 pg_ctl --options=initdb-options命令行工具PG18-o initdb-options--options=initdb-options 指定要直接传递给initdb命令的选项。-o可以指定多次，给出的所有选项都会被传递过去。 通常应将initdb-options放在单引号或双引号中，以确保它们作为一个整体被传递。pg_ctl › 选项 pg_ctl --options=options命令行工具PG18-o options--options=options 指定要直接传递给postgres命令的选项。-o可以指定多次，给出的所有选项都会被传递过去。 通常应将options放在单引号或双引号中，以确保它们作为一个整体被传递。pg_ctl › 选项 pg_ctl --pgdata=datadir命令行工具PG18-D datadir--pgdata=datadir 指定数据库配置文件所在的文件系统位置。若省略此选项，则使用环境变量PGDATA。pg_ctl › 选项 pg_ctl --silent命令行工具PG18-s--silent 只打印错误，不打印信息性消息。pg_ctl › 选项 pg_ctl --timeout=seconds命令行工具PG18-t seconds--timeout=seconds 指定等待某个操作完成时最多等待多少秒（见选项-w）。默认值为环境变量PGCTLTIMEOUT的值；如果未设置该环境变量，则默认为 60 秒。pg_ctl › 选项 pg_ctl --version命令行工具PG18-V--version 打印pg_ctl的版本并退出。pg_ctl › 选项 pg_ctl --wait命令行工具PG18-w--wait 等待操作完成。start、stop、restart、promote和register模式支持此选项，而且对这些模式来说它是默认行为。 在等待期间，pg_ctl会反复检查服务器的PID文件，并在两次检查之间短暂休眠。当PID文件表明服务器已准备好接受连接时，启动就被视为完成。当服务器移除PID文件时，关闭就被视为完成。pg_ctl会根据启动或关闭是否成功返回相应…pg_ctl › 选项 pg_ctl -e source命令行工具PG18-e source 指定以 Windows 服务方式运行时，pg_ctl写入事件日志所使用的事件源名称。默认值为PostgreSQL。注意，这只控制由pg_ctl本身发送的消息；服务器一旦启动，就会使用其event_source参数指定的事件源。如果服务器在启动的很早阶段、该参数尚未设置之前就失败，它也可能使用默认事件源名称PostgreSQL记录日志。pg_ctl › 选项 › 用于 Windows 的选项 pg_ctl -N servicename命令行工具PG18-N servicename 要注册的系统服务名称。该名称会同时用作服务名和显示名。默认值为PostgreSQL。pg_ctl › 选项 › 用于 Windows 的选项 pg_ctl -P password命令行工具PG18-P password 用于运行该服务的用户密码。pg_ctl › 选项 › 用于 Windows 的选项 pg_ctl -p path命令行工具PG18-p path 指定postgres可执行程序的位置。默认情况下，postgres可执行程序取自与pg_ctl相同的目录；如果那里没有，则取自硬编码的安装目录。除非采用了某些非常规方式，并收到找不到postgres可执行程序的错误，否则通常不需要使用此选项。 在init模式中，此选项同样指定initdb可执行程序的位置。pg_ctl › 选项 pg_ctl -S start-type命令行工具PG18-S start-type 系统服务的启动类型。start-type可以是auto、demand，或者两者之一的首字母。若省略此选项，则默认值为auto。pg_ctl › 选项 › 用于 Windows 的选项 pg_ctl -U username命令行工具PG18-U username 用于运行该服务的用户名。对于域用户，请使用DOMAIN\username格式。pg_ctl › 选项 › 用于 Windows 的选项 pg_dump --attribute-inserts命令行工具PG18--column-inserts--attribute-inserts 将数据转储为带有显式列名的INSERT命令（INSERT INTO table (column, ...) VALUES ...）。这会使恢复变得非常缓慢；它主要用于生成可装入非 PostgreSQL 数据库的转储文件。恢复期间发生的任何错误都只会导致有问题的 INSERT 所包含的行丢失，而不会导致整个表…pg_dump › 选项 pg_dump --binary-upgrade命令行工具PG18--binary-upgrade 此选项供就地升级实用程序使用。不建议也不支持将其用于其他目的。该选项的行为可能在未来的版本中更改而不另行通知。pg_dump › 选项 pg_dump --blobs命令行工具PG18-b--large-objects--blobs（已弃用）在转储中包含大对象。除非指定了 --schema、--table、--schema-only、--statistics-only 或 --no-data，否则这是默认行为。因此，-b 开关只在已经请求了特定模式或表的转储中，需要把大对象再加回来时才有用。注意，大对象被视为数据，因此在使用 --data-only 时会包含…pg_dump › 选项 pg_dump --clean命令行工具PG18-c--clean 在输出创建这些对象的命令之前，先输出用于 DROP 所有被转储数据库对象的命令。当恢复要覆盖现有数据库时，此选项很有用。如果目标数据库中某些对象不存在，则在恢复期间会报告可忽略的错误信息，除非还指定了 --if-exists。 当生成一个归档（非文本）输出文件时，此选项将被忽略。对于归档格式，可以在调用 pg_restore 时指定该选项。pg_dump › 选项 pg_dump --compress=method命令行工具PG18-Z level-Z method[:detail]--compress=level--compress=method[:detail] 指定要使用的压缩方法和/或压缩级别。压缩方法可以设置为 gzip、lz4、zstd 或 none（表示不压缩）。也可以选择指定压缩细节字符串。如果细节字符串是一个整数，则表示压缩级别；否则，它应是一个用逗号分隔的项列表，每项形如 keywor…pg_dump › 选项 pg_dump --create命令行工具PG18-C--create 让输出以创建数据库本身并重新连接到新建数据库的命令开始。（使用这种形式的脚本时，在目标安装中先连接到哪个数据库再运行脚本都无关紧要。）如果还指定了 --clean，则脚本会在重新连接到目标数据库之前先删除并重新创建它。 使用 --create 时，输出还会包含该数据库的注释（如果有），以及该数据库特有的任何配置变量设置，也就是提及该数据库的任何 ALTER…pg_dump › 选项 pg_dump --data-only命令行工具PG18-a--data-only 只转储数据，不转储模式（数据定义）或统计信息。会转储表数据、大对象和序列值。 此选项类似于指定 --section=data，但出于历史原因，两者并不完全相同。pg_dump › 选项 pg_dump --dbname=dbname命令行工具PG18-d dbname--dbname=dbname 指定要连接的数据库名称。这等价于在命令行上把 dbname 作为第一个非选项参数指定。dbname 可以是连接字符串。如果是这样，连接字符串中的参数将覆盖任何冲突的命令行选项。pg_dump › 选项 pg_dump --disable-dollar-quoting命令行工具PG18--disable-dollar-quoting 此选项禁用对函数体的美元引用，并强制用 SQL 标准字符串语法对它们加引号。pg_dump › 选项 pg_dump --disable-triggers命令行工具PG18--disable-triggers 此选项只在创建包含数据但不包含模式的转储时才相关。它指示 pg_dump 在输出中包含一些命令，以便在恢复数据时临时禁用目标表上的触发器。如果这些表上存在不希望在数据恢复期间触发的引用完整性检查或其他触发器，请使用此选项。 目前，为 --disable-triggers 输出的这些命令必须由超级用户执行。因此，还应通过 -S 指定一个超级用…pg_dump › 选项 pg_dump --enable-row-security命令行工具PG18--enable-row-security 此选项只在转储启用了行安全的表内容时才相关。默认情况下，pg_dump 会将row_security设置为 off，以确保把表中的所有数据都转储出来。如果用户没有足够的权限绕过行安全，则会抛出错误。该参数会指示 pg_dump 改为将row_security设置为 on，从而允许用户只转储其有权访问的那部分表内容。 请注意，如果当前使…pg_dump › 选项 pg_dump --encoding=encoding命令行工具PG18-E encoding--encoding=encoding 在指定的字符集编码中创建转储。默认情况下，转储将以数据库编码创建。（获得相同结果的另一种方法是将PGCLIENTENCODING环境变量设置为所需的转储编码。）支持的编码在第 23.3.1 节中描述。pg_dump › 选项 pg_dump --exclude-extension=pattern命令行工具PG18--exclude-extension=pattern 不转储任何匹配 pattern 的扩展。该模式按照与 -e 相同的规则解释。--exclude-extension 可以给出多次，以排除匹配所给模式中任意一个的扩展。 当同时给出 -e 和 --exclude-extension 时，其行为是只转储至少匹配一个 -e 开关、但不匹配任何 --exclude-extensio…pg_dump › 选项 pg_dump --exclude-schema=pattern命令行工具PG18-N pattern--exclude-schema=pattern 不转储任何匹配 pattern 的模式。该模式按照与 -n 相同的规则解释。-N 可以给出多次，以排除匹配所给模式中任意一个的模式。 当同时给出 -n 和 -N 时，其行为是只转储至少匹配一个 -n 开关但不匹配任何 -N 开关的模式。如果出现 -N 而没有 -n，那么匹配 -N 的模式会从原本的正常转储中排…pg_dump › 选项 pg_dump --exclude-table-and-children=pattern命令行工具PG18--exclude-table-and-children=pattern 这与 -T/--exclude-table 选项相同，只是它还会排除匹配 pattern 的表的任何分区或继承子表。pg_dump › 选项 pg_dump --exclude-table-data-and-children=pattern命令行工具PG18--exclude-table-data-and-children=pattern 这与 --exclude-table-data 选项相同，只是它还会排除匹配 pattern 的表的任何分区或继承子表的数据。pg_dump › 选项 pg_dump --exclude-table-data=pattern命令行工具PG18--exclude-table-data=pattern 不转储任何匹配 pattern 的表的数据。该模式按照与 -t 相同的规则解释。--exclude-table-data 可以给出多次，以排除匹配所给模式中任意一个的表。当需要某个特定表的定义、但不需要其中数据时，此选项很有用。 若要排除数据库中所有表的数据，请参见 --schema-only 或 --statistic…pg_dump › 选项 pg_dump --exclude-table=pattern命令行工具PG18-T pattern--exclude-table=pattern 不转储任何匹配 pattern 的表。该模式按照与 -t 相同的规则解释。-T 可以给出多次，以排除匹配所给模式中任意一个的表。 当同时给出 -t 和 -T 时，其行为是只转储至少匹配一个 -t 开关但不匹配任何 -T 开关的表。如果出现 -T 而没有 -t，那么匹配 -T 的表会从原本的正常转储中排除。pg_dump › 选项 pg_dump --extension=pattern命令行工具PG18-e pattern--extension=pattern 仅转储与pattern匹配的扩展。当未指定此选项时，将转储目标数据库中的所有非系统扩展。可以通过写多个-e开关来选择多个扩展。pattern 参数按照 psql 的 \d 命令所使用的同样规则进行解释（请参阅模式），因此也可以通过在模式中使用通配符来选择多个扩展。使用通配符时，如有需要请小心为模式加引号，以防止 she…pg_dump › 选项 pg_dump --extra-float-digits=ndigits命令行工具PG18--extra-float-digits=ndigits 在转储浮点数据时，使用指定的 extra_float_digits 值，而不是最大可用精度。出于备份目的的常规转储不应使用此选项。pg_dump › 选项 pg_dump --file=file命令行工具PG18-f file--file=file 将输出发送到指定文件。对于基于文件的输出格式，可以省略此参数，这时使用标准输出。不过，对于目录输出格式，必须给出此参数，因为它指定的是目标目录而不是文件。在这种情况下，该目录由 pg_dump 创建，并且在此之前必须不存在。pg_dump › 选项 pg_dump --filter=filename命令行工具PG18--filter=filename 指定一个文件名，从中读取要在转储中包含或排除的对象匹配模式。模式按照对应选项的同样规则解释：对于表，使用 -t/--table、--table-and-children、-T/--exclude-table 和 --exclude-table-and-children 的规则；对于模式，使用 -n/--schema 和 -N/--exclud…pg_dump › 选项