pg_receivexlog · PostgreSQL 中文文檔 9.3

# pg_receivexlog ## Name pg_receivexlog?--?PostgreSQL集群中的流事務日志 ## Synopsis `pg_receivexlog` [`_option_`...] ## 描述 pg_receivexlog用于從一個運行的PostgreSQL 集群中流事務日志。該事務日志流使用流復制協議，并寫入到文件的本地目錄中。這個目錄可以被用作使用時間點恢復的歸檔目錄（參閱[Section 24.3](#calibre_link-466)）。 pg_receivexlog在服務器上產生事務日志時實時流事務日志，并且不像[archive_command](#calibre_link-467)那樣等待段的完成。因為這個原因，當使用pg_receivexlog時不需要設置[archive_timeout](#calibre_link-468)。事務日志在普通的PostgreSQL連接上流出，并且使用復制控制。必須由超級用戶或有`REPLICATION`權限的用戶（參閱 [Section 20.2](#calibre_link-469)）連接，并且`pg_hba.conf` 必須明確的允許復制連接。服務器也必須配置的[max_wal_senders](#calibre_link-470)足夠高，使流至少有一個會話可用。如果失去連接，或者不能初步建立，帶有一個非致命錯誤，pg_receivexlog 將無限的重試連接，并盡快重建流。要避免這種行為，使用`-n`參數。 ## 選項下列的命令行選項控制輸出的位置和格式。 `-D` `_directory_``--directory=``_directory_` 寫輸出的目錄。這個參數是必需的。下列的命令行選項控制程序的運行。 `-n` `--no-loop` 不要循環連接錯誤。相反，立即帶有錯誤退出。 `-v` `--verbose` 啟用冗余模式。下列的命令行選項控制數據庫連接參數。 `-d` `_connstr_` `--dbname=``_connstr_` 聲明用來連接到服務器的參數，作為一個連接字符串。參閱[Section 31.1.1](#calibre_link-458)獲取更多信息。該選項被稱為`--dbname`是為了與其他客戶端應用的一致性，但是因為 pg_receivexlog不連接到集群中的任何特別的數據庫，所以將忽略連接字符串中的數據庫名字。 `-h` `_host_` `--host=``_host_` 聲明服務器正在運行的機器的主機名。如果這個值以一個斜線開始，則被用作Unix域套接字的目錄。默認從`PGHOST`環境變量中獲取（如果設置了），否則嘗試一個Unix域套接字連接。 `-p` `_port_` `--port=``_port_` 聲明服務器正在監聽的TCP端口或本地Unix域套接字文件擴展。缺省是`PGPORT` 環境變量（如果設置了），否則是內編譯的缺省。 `-s` `_interval_` `--status-interval=``_interval_` 聲明狀態數據包發送回服務器的秒數。這允許對服務器進程的更簡單的監視。為了避免連接超時，零值完全禁用定期狀態更新，盡管服務器需要時仍然發送一個更新。缺省值是10秒。 `-U` `_username_` `--username=``_username_` 連接的用戶名。 `-w` `--no-password` 從不發出密碼提示問題。如果服務器要求密碼認證并且密碼不可用于其他意思如 `.pgpass`文件，則連接嘗試將會失敗。該選項在批量工作和不存在用戶輸入密碼的腳本中很有幫助。 `-W` `--password` 強制pg_receivexlog在連接到數據庫之前提示一個密碼。這個選項從來不是至關重要的，因為如果服務器需求密碼認證，則pg_receivexlog 自動提示一個密碼。不過，pg_receivexlog 將在找出服務器想要一個密碼上浪費一個連接嘗試。在某些情況下，值得輸入`-W` 以避免額外的連接嘗試。其他選項也可用： `-V` `--version` 打印pg_receivexlog版本然后退出。 `-?` `--help` 顯示關于pg_receivexlog命令行參數的幫助然后退出。 ## 環境變量這個工具，類似大多數其他PostgreSQL實用工具，也使用由libpq支持的環境變量（參閱[Section 31.14](#calibre_link-39)）。 ## 注意當使用pg_receivexlog而不是[archive_command](#calibre_link-467)時，服務器將持續回收事務日志文件，即使備份沒有適當的歸檔，因為這里沒有失敗的命令。可以通過在文件還未適當的歸檔時有一個[archive_command](#calibre_link-467)失敗來繞開： ``` archive_command = 'sleep 5 && test -f /mnt/server/archivedir/%f' ``` 最初的時限是必須的，因為pg_receivexlog使用異步復制工作，并且因此稍微落后于主機。 ## 例子要從服務器`mydbserver`流事務日志，并將其存儲到本地目錄 `/usr/local/pgsql/archive`中： ``` <samp class="literal">$</samp> <kbd class="literal">pg_receivexlog -h mydbserver -D /usr/local/pgsql/archive</kbd> ``` ## 又見 [pg_basebackup](#calibre_link-471)