pg_ctl · PHP知識總結

       pg_ctl是一個用于初始化PostgreSQL數據庫集簇，啟動、停止或重啟PostgreSQL數據庫服務器，或者顯示一個正在運行服務器的狀態的工具。 | 命令格式 | 解釋 | | --- | --- | | **pg_ctl init[db]** [-D DATADIR] [-s] [-o OPTIONS] | `init`或`initdb`模式會創建一個新的PostgreSQL數據庫集簇，也就是將由一個單一服務器實例管理的數據庫集合。這個模式會調用`initdb`命令 | | **pg_ctl start** [-D datadir] [-l filename] [-W] [-t seconds] [-s] <br> [-o options] [-p path] [-c] | `start`模式啟動一個新的服務器。該服務器被啟動在后臺，并且它的標準輸出被附加到`/dev/null` | | **pg_ctl stop** [-D datadir] [-m s[mart] \| f[ast] \| i[mmediate]] [-W] <br> [-t seconds] [-s]| `stop`模式關閉運行在指定數據目錄中的服務器。 | | **pg_ctl restart** [-D datadir] [-m s[mart] \| f[ast] \| i[mmediate]] [-W] <br> [-t seconds] [-s] [-o options] [-c] | `restart`模式實際上會先執行一個停止操作然后緊接著執行一個啟動操作 | | **pg_ctl reload** [-D datadir] [-s] | `reload`模式會向`postgres`服務器進程發送一個SIGHUP信號，使它重新讀取配置文件(`postgresql.conf`等) 使配置生效，而無需重啟服務器| | **pg_ctl status** [-D datadir] | `status`模式檢查一個服務器是否運行在指定的數據目錄中。如果有一個服務器正在運行，其PID和用來調用它的命令行選項將被顯示。如果服務器沒有在運行，pg\_ctl將返回退出狀態 3。如果沒有指定一個可以訪問的數據目錄，pg\_ctl將返回退出狀態 4。 | | **pg_ctl promote** [-D datadir] [-W] [-t seconds] [-s] | 將備庫提升為主庫 | | **pg_ctl logrotate** [-D datadir] [-s] | `logrotate`模式輪換服務器日志文件 | | **pg_ctl kill** signal_name process_id | `kill`模式向一個指定進程發送一個信號 | > **option：** >* **-D, --pgdata=DATADIR：** 指定數據庫配置文件的文件系統位置。如果這個選項被忽略，將使用環境變量`PGDATA` >* **-s, --silent：** 只打印錯誤，不打印信息性的消息 >* **-t, --timeout=SECS：** 指定等待一個操作完成時要等待的最大秒數（見選項`-w`）。默認為`PGCTLTIMEOUT`環境變量的值，如果該環境變量沒有設置則默認為60秒 >* **-V, --version ：** 打印pg\_ctl版本并退出。 >* **-w, --wait ：** 等待操作完成。模式`start`、`stop`、`restart`、`promote`以及`register`支持這個選項，并且對那些模式是默認的。 > * 在等待時，`pg_ctl`會一遍又一遍地檢查服務器的PID文件，在兩次檢查之間會休眠一小段時間。當PID文件指示該服務器已經做好準備接受連接時，啟動操作被認為完成。當服務器移除PID文件時，關閉操作被認為完成。`pg_ctl`會基于啟動或關閉的成功與否返回一個退出代碼。 > * 如果操作在超時時間（見選項`-t`）內未能完成，則`pg_ctl`會以一個非零退出狀態退出。但是注意該操作可能會在后臺繼續進行并且最終取得成功 >* **-W, --no-wait ：** 不等待操作完成，該選項與-w相反 > * 如果禁用等待，所請求的動作會被觸發，但是不會有關于其成功與否的反饋。在這種情況下，可能必須用服務器日志文件或外部監控系統來檢查該操作的進度以及成功與否。 > * 在9.4以前版本的PostgreSQL中，這是除`stop`模式之外的模式的默認選項。 >* **-?, --help ：** 顯示有關pg\_ctl命令行參數的幫助并退出 >* **-c, --core-files：** 在可行的平臺上嘗試允許服務器崩潰產生核心文件，方法是提升在核心文件上的任何軟性資源限制。這通過允許從一個失敗的服務器進程中獲得一個棧跟蹤而有助于調試或診斷問題 >* **-l, --log=FILENAME：** 追加服務器日志輸出到*`filename`*。如果該文件不存在，它會被創建。umask被設置成 077，這樣默認情況下不允許其他用戶訪問該日志文件 >* **-o, --options=OPTIONS ：** 指定被直接傳遞給`postgres`命令的選項。`-o`可以被指定多次，這些選項應該通常被單引號或雙引號包圍來確保它們被作為一個組傳遞 >* **-p PATH-TO-POSTGRES ：** 指定`postgres`可執行程序的位置。默認情況下，`postgres`可執行程序可以從`pg_ctl`相同的目錄得到 >* **-m, --mode=MODE：** `mode`可以是`smart`、`fast`或`immediate`，或者這三者之一的第一個字母。如果這個選項被忽略，則`fast`是默認值 > * “Smart”模式不允許新連接，然后等待所有現有的客戶端斷開連接以及任何在線備份結束 > * “Fast”模式（默認）不會等待客戶端斷開連接并且將終止進行中的在線備份。所有活動事務都被回滾并且客戶端被強制斷開連接 > * “Immediate”模式將立刻中止所有服務器進程，而不是做一次干凈的關閉，這種選擇將導致下一次重啟時進行一次崩潰恢復 | 使用實例 | 解釋 | | --- | --- | | pg\_ctl promote -D /data/pg | 將備庫提升為主庫 | | pg_ctl -o "-F -p 5433" restart | 使用端口 5433 重啟并在重啟時禁用`fsync` |