PG_CTL - Khởi tạo, bắt đầu, dừng hoặc điều khiển APostgreSQLtỷ lệ kèo bóng đá chủ
PG_CTL init [db][-D Datadir] [-S] [-O InitDB-Options11029_11032
PG_CTL Bắt đầu[-D Datadir] [-L FileName] [-W] [-T giây] [-S] [-O Tùy tỷ lệ kèo bóng đá] [-P đường dẫn] [-C]
PG_CTL Dừng[-D Datadir] [-M S [Mart] | f [AST] | i [mmediate]] [-W] [-T giây] [-S]
PG_CTL Khởi động lại[-D Datadir] [12462_12466 S [Mart] | f [AST] | i [mmediate]] [-W] [-T giây] [-S] [-O Tùy tỷ lệ kèo bóng đá] [-C]
PG_CTL Tải lại[-D Datadir] [-S]
PG_CTL trạng thái[-D Datadir]
PG_CTL Quảng cáo[-D Datadir] [-W] [-T giây] [13710_13714]
PG_CTL giết Signal_name process_id
Trên Microsoft Windows, cũng:
PG_CTL Đăng ký[-D Datadir] [-N ServiceName] [-U tên người dùng] [-P Mật khẩu] [-S A [UTO] | d [emand]] [-e Nguồn] [-W] [-T giây] [14824_14828] [-O Tùy tỷ lệ kèo bóng đá]
PG_CTL uningister[-N ServiceName]
PG_CTLlà một tiện ích để khởi tạo A15362_15374Cụm cơ sở dữ liệu, bắt đầu, dừng hoặc khởi động lạiPostgreSQLtỷ lệ kèo bóng đá chủ cơ sở dữ liệu (Postgres) hoặc hiển thị trạng thái của tỷ lệ kèo bóng đá chủ đang chạy. Mặc dù tỷ lệ kèo bóng đá chủ có thể được khởi động thủ công,PG_CTLĐóng gói các tác vụ như chuyển hướng đầu ra nhật ký và tách ra khỏi nhóm thiết bị đầu cuối và quy trình. Nó cũng cung cấp các tùy chọn thuận tiện để tắt tỷ lệ kèo bóng đá.
TheinithoặcinitDBchế độ tạo ra một mớiPostgreSQLCụm cơ sở dữ liệu, nghĩa là một tập hợp các cơ sở dữ liệu sẽ được quản lý bởi một phiên bản tỷ lệ kèo bóng đá chủ duy nhất. Chế độ này gọiinitDBlệnh. Nhìn thấyinitDBĐể biết chi tiết.
Bắt đầuchế độ khởi chạy một tỷ lệ kèo bóng đá chủ mới. tỷ lệ kèo bóng đá chủ được khởi động trong nền và đầu vào tiêu chuẩn của nó được gắn vào/dev/null(hoặcNULtrên Windows). Trên các hệ thống giống như unix, theo mặc định, đầu ra tiêu chuẩn và lỗi tiêu chuẩn của tỷ lệ kèo bóng đá chủ được gửi đếnPG_CTL16751_16817PG_CTLSau đó, nên được chuyển hướng đến một tệp hoặc được chuyển sang một quy trình khác như chương trình xoay nhật ký nhưrotatelogs; nếu không thìPostgressẽ viết đầu ra của nó vào thiết bị đầu cuối điều khiển (từ nền) và sẽ không rời khỏi nhóm quy trình của shell. Trên Windows, theo mặc định, đầu ra tiêu chuẩn và lỗi tiêu chuẩn của tỷ lệ kèo bóng đá chủ được gửi đến thiết bị đầu cuối. Những hành vi mặc định này có thể được thay đổi bằng cách sử dụng-LĐể nối đầu ra của tỷ lệ kèo bóng đá chủ vào tệp nhật ký. Sử dụng một trong hai-Lhoặc chuyển hướng đầu ra được khuyến nghị.
DừngChế độ tắt tỷ lệ kèo bóng đá chủ đang chạy trong thư mục dữ liệu được chỉ định. Ba phương thức tắt khác nhau có thể được chọn với-MTùy tỷ lệ kèo bóng đá.SmartMode không cho phép kết nối mới, sau đó chờ tất cả các tỷ lệ kèo bóng đá khách hiện tại ngắt kết nối và bất kỳ bản sao lưu trực tuyến nào để hoàn thành. Nếu tỷ lệ kèo bóng đá chủ ở chế độ chờ nóng, bản sao phục hồi và phát trực tuyến sẽ bị chấm dứt khi tất cả các tỷ lệ kèo bóng đá khách đã ngắt kết nối.FastHồi18047_18267ngay lập tứcHồiChế độ sẽ hủy bỏ tất cả các quy trình tỷ lệ kèo bóng đá chủ ngay lập tức, mà không cần tắt tỷ lệ kèo bóng đá. Lựa chọn này sẽ dẫn đến chu kỳ phục hồi sự cố trong khi bắt đầu tỷ lệ kèo bóng đá chủ tiếp theo.
Khởi động lạichế độ thực hiện hiệu quả một điểm dừng theo sau là bắt đầu. Điều này cho phép thay đổiPostgresTùy chọn dòng lệnh hoặc thay đổi tùy chọn tệp cấu hình không thể thay đổi mà không khởi động lại tỷ lệ kèo bóng đá chủ. Nếu các đường dẫn tương đối được sử dụng trên dòng lệnh trong khi bắt đầu tỷ lệ kèo bóng đá chủ,Khởi động lạicó thể thất bại trừ khiPG_CTLđược thực thi trong cùng thư mục hiện tại như trong khi bắt đầu tỷ lệ kèo bóng đá chủ.
Tải lạichế độ chỉ cần gửiPostgresQuá trình tỷ lệ kèo bóng đá chủ ASIGHUPTín hiệu, khiến nó đọc lại tỷ lệ kèo bóng đá tệp cấu hình của nó (19239_19256, pg_hba.conf, v.v.). Điều này cho phép thay đổi các tùy chọn tệp cấu hình không yêu cầu khởi động lại tỷ lệ kèo bóng đá chủ đầy đủ để có hiệu lực.
trạng tháiChế độ kiểm tra xem tỷ lệ kèo bóng đá chủ có đang chạy trong thư mục dữ liệu được chỉ định hay không. Nếu có, tỷ lệ kèo bóng đá chủ củaPIDvà các tùy chọn dòng lệnh được sử dụng để gọi nó được hiển thị. Nếu tỷ lệ kèo bóng đá chủ không chạy,pg_ctlTrả về trạng thái thoát của 3. Nếu không được chỉ định thư mục dữ liệu có thể truy cập,PG_CTLTrả về trạng thái thoát là 4.
quảng báMode ra lệnh tỷ lệ kèo bóng đá chủ dự phòng đang chạy trong thư mục dữ liệu được chỉ định để kết thúc chế độ chờ và bắt đầu các hoạt động đọc-ghi.
giếtChế độ gửi tín hiệu đến một quy trình được chỉ định. Điều này chủ yếu có giá trị trênMicrosoft Windowskhông có tích hợpgiếtlệnh. Sử dụng--HelpĐể xem danh sách tỷ lệ kèo bóng đá tên tín hiệu được hỗ trợ.
Đăng kýChế độ đăng kýPostgreSQLtỷ lệ kèo bóng đá chủ dưới dạng dịch vụ hệ thống trênMicrosoft Windows. The-S20626_20683AutoHồi(Tự động khởi động dịch vụ khi khởi động hệ thống) hoặcYêu cầuHồi(Bắt đầu dịch vụ theo yêu cầu).
unpisterMode Unvergisters Dịch vụ hệ thống trênMicrosoft Windows. Điều này hoàn tác tỷ lệ kèo bóng đá hiệu ứng củaĐăng kýlệnh.
-C--Core-FilesCố gắng cho phép các sự cố tỷ lệ kèo bóng đá chủ tạo ra các tệp lõi, trên các nền tảng có thể, bằng cách nâng bất kỳ giới hạn tài nguyên mềm nào được đặt trên các tệp lõi. Điều này rất hữu ích trong việc gỡ lỗi hoặc chẩn đoán các vấn đề bằng cách cho phép một dấu vết ngăn xếp từ quy trình tỷ lệ kèo bóng đá chủ không thành công.
-DDatadir-pgdata =DatadirChỉ định vị trí hệ thống tệp của các tệp cấu hình cơ sở dữ liệu. Nếu tùy tỷ lệ kèo bóng đá này bị bỏ qua, biến môi trườngPGDATAđược sử dụng.
-LFileName--log =FileNameNối đầu ra nhật ký tỷ lệ kèo bóng đá chủ vàoFileName. Nếu tệp không tồn tại, nó được tạo ra. TheUmaskđược đặt thành 077, vì vậy quyền truy cập vào tệp nhật ký không được phép cho người dùng khác theo mặc định.
-MMode--mode =ModeChỉ định chế độ tắt tỷ lệ kèo bóng đá.Modecó thểSMART, nhanhhoặcngay lập tứchoặc chữ cái đầu tiên của một trong ba người này. Nếu tùy tỷ lệ kèo bóng đá này bị bỏ qua,nhanhlà mặc định.
-OTùy tỷ lệ kèo bóng đá--Options =Tùy tỷ lệ kèo bóng đáChỉ định các tùy tỷ lệ kèo bóng đá sẽ được truyền trực tiếp choPostgreslệnh.-OCó thể được chỉ định nhiều lần, với tất cả các tùy tỷ lệ kèo bóng đá đã cho được truyền qua.
TheTùy tỷ lệ kèo bóng đáthường được bao quanh bởi tỷ lệ kèo bóng đá trích dẫn đơn hoặc đôi để đảm bảo rằng chúng được truyền qua dưới dạng một nhóm.
-O24047_24063--Options =24173_24189Chỉ định các tùy tỷ lệ kèo bóng đá sẽ được truyền trực tiếp choinitDBlệnh.-OCó thể được chỉ định nhiều lần, với tất cả các tùy tỷ lệ kèo bóng đá đã cho được truyền qua.
TheInitDB-Optionsthường được bao quanh bởi tỷ lệ kèo bóng đá trích dẫn đơn hoặc đôi để đảm bảo rằng chúng được truyền qua dưới dạng một nhóm.
-Pđường dẫnChỉ định vị trí củaPostgresthực thi. Theo mặc định24919_24929thực thi được lấy từ cùng thư mục vớiPG_CTLhoặc không thành công, thư mục cài đặt có dây cứng. Không cần thiết phải sử dụng tùy tỷ lệ kèo bóng đá này trừ khi bạn đang làm điều gì đó bất thường và gặp lỗi màPostgresKhông tìm thấy thực thi.
ininitChế độ, tùy tỷ lệ kèo bóng đá này chỉ định tương tự vị trí củainitDBthực thi.
-S--SilentChỉ in lỗi, không có tin nhắn thông tin.
-Tgiây--Timeout =giâyChỉ định số giây tối đa để chờ đợi khi chờ hoàn thành thao tác (xem Tùy tỷ lệ kèo bóng đá-W). Mặc định là giá trị củapgctltimeoutBiến môi trường hoặc, nếu không đặt, thành 60 giây.
-V--VersionIn ThePG_CTLPhiên bản và Thoát.
-W--waitĐợi hoạt động hoàn thành. Điều này được hỗ trợ cho tỷ lệ kèo bóng đá chế độBắt đầu, Dừng, Khởi động lại, Quảng cáovàĐăng ký, và là mặc định cho tỷ lệ kèo bóng đá chế độ đó.
Khi chờ đợi,PG_CTLLiên tục kiểm tra tỷ lệ kèo bóng đá chủPIDTệp, ngủ trong một khoảng thời gian ngắn giữa tỷ lệ kèo bóng đá séc. Khởi động được coi là hoàn thành khiPIDTệp cho biết tỷ lệ kèo bóng đá chủ đã sẵn sàng chấp nhận kết nối. Tắt tỷ lệ kèo bóng đá được coi là hoàn thành khi tỷ lệ kèo bóng đá chủ tháoPIDTệp.PG_CTLTrả về mã thoát dựa trên sự thành công của khởi động hoặc tắt tỷ lệ kèo bóng đá.
Nếu thao tác không hoàn thành trong thời gian chờ (xem Tùy tỷ lệ kèo bóng đá-T), sau đóPG_CTLThoát với trạng thái thoát khác không. Nhưng lưu ý rằng hoạt động có thể tiếp tục trong nền và cuối cùng thành công.
-W--no-waitKhông đợi hoạt động hoàn thành. Điều này trái ngược với tùy tỷ lệ kèo bóng đá-W.
Nếu chờ đợi bị vô hiệu hóa, hành động được yêu cầu được kích hoạt, nhưng không có phản hồi về thành công của nó. Trong trường hợp đó, tệp nhật ký tỷ lệ kèo bóng đá chủ hoặc hệ thống giám sát bên ngoài sẽ phải được sử dụng để kiểm tra tiến trình và thành công của hoạt động.
Trong tỷ lệ kèo bóng đá bản phát hành trước của PostgreSQL, đây là mặc định ngoại trừDừngchế độ.
-?--HelpHiển thị trợ giúp vềPG_CTLĐối số dòng lệnh và thoát.
Nếu một tùy tỷ lệ kèo bóng đá được chỉ định là hợp lệ, nhưng không liên quan đến chế độ hoạt động đã tỷ lệ kèo bóng đá,28859_28867bỏ qua nó.
-eNguồnTên của nguồn sự kiện choPG_CTLĐể sử dụng để đăng nhập vào nhật ký sự kiện khi chạy dưới dạng dịch vụ Windows. Mặc định làPostgreSQL. Lưu ý rằng điều này chỉ kiểm soát tỷ lệ kèo bóng đá tin nhắn được gửi từPG_CTLchính nó; Khi bắt đầu, tỷ lệ kèo bóng đá chủ sẽ sử dụng nguồn sự kiện được chỉ định bởievent_sourcetham số. Nếu tỷ lệ kèo bóng đá chủ bị lỗi rất sớm khi khởi động, trước khi tham số đó đã được đặt, nó cũng có thể đăng nhập bằng tên nguồn sự kiện mặc địnhPostgreSQL.
-NServiceNameTên của dịch vụ hệ thống để đăng ký. Tên này sẽ được sử dụng làm tên dịch vụ và tên hiển thị. Mặc định làPostgreSQL.
-PMật khẩuMật khẩu cho người dùng chạy dịch vụ như.
-SBắt đầu loạiLoại bắt đầu của dịch vụ hệ thống.Bắt đầu loạicó thểAutohoặcYêu cầuhoặc chữ cái đầu tiên của một trong hai người này. Nếu tùy tỷ lệ kèo bóng đá này bị bỏ qua,Autolà mặc định.
-Utên người dùngTên người dùng để người dùng chạy dịch vụ là. Đối với người dùng miền, hãy sử dụng định dạngDOMAIN \ username.
pgctltimeoutGiới hạn mặc định về số giây để chờ đợi khi chờ khởi động hoặc tắt tỷ lệ kèo bóng đá hoàn tất. Nếu không được đặt, mặc định là 60 giây.
PGDATAVị trí thư mục dữ liệu mặc định.
hầu hếtPG_CTLtỷ lệ kèo bóng đá chế độ yêu cầu biết vị trí thư mục dữ liệu; Do đó,-DTùy tỷ lệ kèo bóng đá là bắt buộc trừ khiPGDATAđược đặt.
PG_CTL, giống như hầu hết tỷ lệ kèo bóng đá khácPostgreSQLTiện ích, cũng sử dụng tỷ lệ kèo bóng đá biến môi trường được hỗ trợ bởilibpq(xemPhần 34.14).
32356_32411Postgres.
Postmaster.pidPG_CTLKiểm tra tệp này trong thư mục dữ liệu để xác định xem tỷ lệ kèo bóng đá chủ có đang chạy hay không.
Postmaster.optsNếu tệp này tồn tại trong thư mục dữ liệu,PG_CTL(trongKhởi động lạichế độ) sẽ chuyển nội dung của tệp làm tùy tỷ lệ kèo bóng đá choPostgres, trừ khi được ghi đè bởi-OTùy tỷ lệ kèo bóng đá. Nội dung của tệp này cũng được hiển thị trongtrạng tháichế độ.
33651_33724
$PG_CTL Bắt đầu
Để khởi động tỷ lệ kèo bóng đá chủ bằng cổng 5433 và chạy mà không cầnfsync, Sử dụng:
$PG_CTL -O "-F -P 5433" Bắt đầu
Để dừng tỷ lệ kèo bóng đá chủ, sử dụng:
$PG_CTL STOP
The-MTùy tỷ lệ kèo bóng đá cho phép kiểm soátLàm thế nàotỷ lệ kèo bóng đá chủ tắt:
$PG_CTL STOP -M SMART
Khởi động lại tỷ lệ kèo bóng đá chủ gần như tương đương với việc dừng tỷ lệ kèo bóng đá chủ và khởi động lại, ngoại trừ theo mặc định,PG_CTLLưu và sử dụng lại các tùy chọn dòng lệnh được chuyển đến ví dụ đã chạy trước đó. Để khởi động lại tỷ lệ kèo bóng đá chủ bằng các tùy chọn tương tự như trước đây, sử dụng:
$PG_CTL Khởi động lại
Nhưng nếu-O35220_35311fsyncKhi khởi động lại:
$PG_CTL -O "-F -P 5433" Khởi động lại
Đây là đầu ra trạng thái mẫu từPG_CTL:
$Trạng thái PG_CTLPG_CTL: tỷ lệ kèo bóng đá chủ đang chạy (PID: 13718) /usr/local/pgsql/bin/postgres "-d" "/usr/local/pgsql/data" "-p" "5433" "-b" "128"
Dòng thứ hai là lệnh sẽ được gọi trong chế độ khởi động lại.