一、概述

控制 PostgreSQL 服務(wù)的工具。

二、語(yǔ)法

--初始化數(shù)據(jù)庫(kù)實(shí)例
pg_ctl init[db] [-D datadir] [-s] [-o initdb-options]

--啟動(dòng)數(shù)據(jù)庫(kù)實(shí)例
pg_ctl start [-D datadir] [-l filename] [-W] [-t seconds] [-s] [-o options] [-p path] [-c]

--停止數(shù)據(jù)庫(kù)實(shí)例
pg_ctl stop [-D datadir] [-m s[mart] | f[ast] | i[mmediate] ] [-W] [-t seconds] [-s]

--重啟數(shù)據(jù)庫(kù)實(shí)例
pg_ctl restart [-D datadir] [-m s[mart] | f[ast] | i[mmediate] ] [-W] [-t seconds] [-s] [-o options] [-c]

--重新加載數(shù)據(jù)庫(kù)配置文件
pg_ctl reload [-D datadir] [-s]

--查看數(shù)據(jù)庫(kù)狀態(tài)
pg_ctl status [-D datadir]

--備庫(kù)切換為主庫(kù)
pg_ctl promote [-D datadir] [-W] [-t seconds] [-s]

--輪換服務(wù)器日志文件
pg_ctl logrotate [-D datadir] [-s]

--向一個(gè)指定進(jìn)程發(fā)送一個(gè)消息
pg_ctl kill signal_name process_id 

--注冊(cè)服務(wù)（Windows）
pg_ctl register [-D datadir] [-N servicename] [-U username] [-P password] [-S a[uto] | d[emand] ] [-e source] [-W] [-t seconds] [-s] [-o options]

--移除服務(wù)（Windows）
pg_ctl unregister [-N servicename]

init 或 initdb：調(diào)用initdb命令。詳見(jiàn)initdb。

參數(shù)說(shuō)明：

-c 或 --core-files：生成服務(wù)器崩潰產(chǎn)生核心文件。
-D datadir 或 --pgdata=datadir：指定數(shù)據(jù)庫(kù)數(shù)據(jù)文件位置。如果這個(gè)選項(xiàng)被忽略，將使用環(huán)境變量 PGDATA。
-l filename 或 --log=filename：追加服務(wù)器日志輸出到 filename。
-m mode 或 --mode=mode：指定關(guān)閉模式。mode 可以是 smart、fast 或 immediate，或者這三者之一的第一個(gè)字母。如果這個(gè)選項(xiàng)被忽略，則 fast 是默認(rèn)值。
-o options 或 --options=options：指定被直接傳遞給 postgres 命令的選項(xiàng)。-o 可以被指定多次，所有給定的選項(xiàng)都會(huì)被傳過(guò)去。這些選項(xiàng)應(yīng)該通常被單引號(hào)或雙引號(hào)包圍來(lái)確保它們被作為一個(gè)組傳遞。
-o initdb-options 或 --options=initdb-options：指定要直接傳遞給 initdb 命令的選項(xiàng)。-o 可以被指定多次，所有給定的選項(xiàng)都會(huì)被傳過(guò)去。這些選項(xiàng)應(yīng)該通常被單引號(hào)或雙引號(hào)包圍來(lái)確保它們被作為一個(gè)組傳遞。
-p path：指定 postgres 可執(zhí)行程序的位置。默認(rèn)情況下，postgres 可執(zhí)行程序可以從 pg_ctl 相同的目錄得到，或者如果沒(méi)有在那里找到，則在硬寫(xiě)的安裝目錄中獲得。除非你正在做一些不同尋常的事并且得到錯(cuò)誤說(shuō)沒(méi)有找到 postgres 可執(zhí)行程序，這個(gè)選項(xiàng)不是必需的。在 init 模式中，這個(gè)選項(xiàng)類(lèi)似于指定了initdb可執(zhí)行程序的位置。
-s 或 --silent：只打印錯(cuò)誤，不打印信息性的消息。
-t seconds 或 --timeout=seconds：指定等待一個(gè)操作完成時(shí)要等待的最大秒數(shù)（見(jiàn)選項(xiàng) -w）。默認(rèn)為 PGCTLTIMEOUT 環(huán)境變量的值，如果該環(huán)境變量沒(méi)有設(shè)置則默認(rèn)為60秒。
-V 或 --version：打印 pg_ctl 版本并退出。
-w 或 --wait：等待操作完成。模式 start、stop、restart、promote 以及 register 支持這個(gè)選項(xiàng)，并且對(duì)那些模式是默認(rèn)的。在等待時(shí)，pg_ctl 會(huì)一遍又一遍地檢查服務(wù)器的 PID 文件，在兩次檢查之間會(huì)休眠一小段時(shí)間。當(dāng) PID 文件指示該服務(wù)器已經(jīng)做好準(zhǔn)備接受連接時(shí)，啟動(dòng)操作被認(rèn)為完成。當(dāng)服務(wù)器移除 PID 文件時(shí)，關(guān)閉操作被認(rèn)為完成。pg_ctl 會(huì)基于啟動(dòng)或關(guān)閉的成功與否返回一個(gè)退出代碼。如果操作在超時(shí)時(shí)間（見(jiàn)選項(xiàng)-t）內(nèi)未能完成，則 pg_ctl 會(huì)以一個(gè)非零退出狀態(tài)退出。但是注意該操作可能會(huì)在后臺(tái)繼續(xù)進(jìn)行并且最終取得成功。
-W 或 --no-wait：不等待操作完成。這是選項(xiàng) -w 的對(duì)立面。如果禁用等待，所請(qǐng)求的動(dòng)作會(huì)被觸發(fā)，但是不會(huì)有關(guān)于其成功與否的反饋。在這種情況下，可能必須用服務(wù)器日志文件或外部監(jiān)控系統(tǒng)來(lái)檢查該操作的進(jìn)度以及成功與否。在以前版本的PostgreSQL中，這是除 stop 模式之外的模式的默認(rèn)選項(xiàng)。

參數(shù)說(shuō)明（Windows）：

-e source：作為一個(gè) Windows 服務(wù)運(yùn)行時(shí)，pg_ctl 用來(lái)在事件日志中記錄日志的事件源的名稱(chēng)。默認(rèn)是 PostgreSQL。注意這只控制由 pg_ctl 本身發(fā)送的消息，一旦開(kāi)始，服務(wù)器將使用 event_source 參數(shù)中指定的事件源。如果服務(wù)器在啟動(dòng)時(shí)很早（在該參數(shù)被設(shè)置前）就失敗，它可能也會(huì)使用默認(rèn)的事件源名稱(chēng) PostgreSQL 來(lái)記錄。
-N servicename：要注冊(cè)的系統(tǒng)服務(wù)的名稱(chēng)。這個(gè)名稱(chēng)將被用于服務(wù)名和顯示名。默認(rèn) PostgreSQL。
-P password：用于運(yùn)行該服務(wù)的用戶(hù)的口令。
-S start-type：要注冊(cè)的系統(tǒng)服務(wù)的啟動(dòng)類(lèi)型。啟動(dòng)類(lèi)型可以是 auto、demand 或者兩者之一的第一個(gè)字母。如果這個(gè)選項(xiàng)被忽略，則 auto 是默認(rèn)值。
-U username：用于運(yùn)行該服務(wù)的用戶(hù)的用戶(hù)名。對(duì)于域用戶(hù)，使用格式 DOMAIN\username。

三、示例

--啟動(dòng) 
pg_ctl start

--要使用端口 5433 啟動(dòng)，并且運(yùn)行時(shí)不使用fsync： 
pg_ctl -o "-F -p 5433" start
 
--停止
pg_ctl stop
pg_ctl stop -m smart

--重啟
pg_ctl restart

--如果指定了-o，則會(huì)替換任何之前的選項(xiàng)。要使用端口 5433 重啟并在重啟時(shí)禁用fsync： 
pg_ctl -o "-F -p 5433" restart

--查看狀態(tài)
pg_ctl status
pg_ctl: server is running (PID: 13718)
/usr/local/pgsql/bin/postgres "-D" "/usr/local/pgsql/data" "-p" "5433" "-B" "128"
第二行是在重啟模式可能被調(diào)用的命令行。 

總結(jié)

到此這篇關(guān)于PostgreSql中pg_ctl命令的文章就介紹到這了,更多相關(guān)pgsql pg_ctl命令內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！