Phiên bản được hỗ trợ:hiện tại(17) /16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không được hỗ trợ:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng soi kèo bóng đá truoctran trang chohiện tạiPhiên bản hoặc soi kèo bóng đá truoctran trong các phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

soi kèo bóng đá truoctranPG_CTL

tên

PG_CTL-Khởi tạo, bắt đầu, dừng hoặc Khởi động lại APostgreSQLsoi kèo bóng đá truoctran chủ

Synopsis

PG_CTLinit [db] [-s] [-dDatadir] [-osoi kèo bóng đá truoctran]

PG_CTLBắt đầu [-w] [-tgiây] [-s] [-dDatadir] [-lFileName] [-osoi kèo bóng đá truoctran] [-pđường dẫn] [-c]

PG_CTLDừng [-w] [-tgiây] [-s] [-dDatadir] [-M S [Mart] | f [AST] | Tôi [mmediate] ]

PG_CTLKhởi động lại [-w] [-tgiây] [-s] [-dDatadir] [-c] [-m s [Mart] | f [AST] | i [mmediate]] [-osoi kèo bóng đá truoctran]

PG_CTLTải lại [-S] [-dDatadir]

PG_CTLstatus [-dDatadir]

pg_ctlgiếtSignal_name process_id

PG_CTLĐăng ký [-NServiceName] [-utên người dùng] [-pMật khẩu] [-dDatadir] [-w] [-tgiây] [-s] [-osoi kèo bóng đá truoctran]

PG_CTLunnegister [-nServiceName]

Mô tả

pg_ctllà soi kèo bóng đá truoctran tiện ích cho Khởi tạo APostgreSQLCụm cơ sở dữ liệu, bắt đầu, dừng hoặc khởi động lạiPostgreSQLsoi kèo bóng đá truoctran chủ phụ trợ (Postgres) hoặc hiển thị trạng thái của một soi kèo bóng đá truoctran chủ đang chạy. Mặc dù soi kèo bóng đá truoctran chủ có thể được khởi động thủ công,PG_CTLĐóng gói các tác vụ như khi chuyển hướng đầu ra nhật ký và tách ra đúng cách Thiết bị đầu cuối và nhóm quy trình. Nó cũng cung cấp các soi kèo bóng đá truoctran thuận tiện cho lần tắt được kiểm soát.

TheinithoặcinitDBchế độ tạo ra soi kèo bóng đá truoctran mớiPostgreSQLCụm cơ sở dữ liệu. Một cơ sở dữ liệu cụm là một tập hợp các cơ sở dữ liệu được quản lý bởi một phiên bản soi kèo bóng đá truoctran chủ. Chế độ này gọiinitDBLệnh. Nhìn thấyinitDBĐể biết chi tiết.

inBắt đầuchế độ, một soi kèo bóng đá truoctran chủ mới là ra mắt. soi kèo bóng đá truoctran chủ được khởi động trong nền và tiêu chuẩn Đầu vào đượ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 soi kèo bóng đá truoctran chủ là Gửi đếnPG_CTLđầu ra tiêu chuẩn (không phải lỗi tiêu chuẩn). Đầu ra tiêu chuẩn củaPG_CTLSau đó nên được chuyển hướng đến soi kèo bóng đá truoctran tệp hoặc được đưa vào soi kèo bóng đá truoctran quy trình khác như chương trình xoay log nhưrotatelogs; nếu không thìPostgressẽ viết đầu ra của nó vào điều khiển thiết bị đầu cuối (từ nền) và sẽ không rời khỏi vỏ Nhóm xử lý. Trên Windows, theo mặc định, tiêu chuẩn của soi kèo bóng đá truoctran chủ Đầu ra và lỗi tiêu chuẩn được gửi đến thiết bị đầu cuối. Những mặc định này Hành vi có thể được thay đổi bằng cách sử dụng-Lđến Nối đầu ra soi kèo bóng đá truoctran chủ vào tệp nhật ký.

inDừngchế độ, soi kèo bóng đá truoctran chủ đó là Chạy trong thư mục dữ liệu được chỉ định bị tắt. Ba Các phương thức tắt khác nhau có thể được chọn với-Msoi kèo bóng đá truoctran:"Smart"chế độ chờ kết thúc chế độ sao lưu trực tuyến và tất cả các khách hàng ngắt kết nối. Đây là mặc định. Nếu soi kèo bóng đá truoctran chủ đang phục hồi, phục hồi và sao chép phát trực tuyến sẽ bị chấm dứt một khi tất cả soi kèo bóng đá truoctran khách đã ngắt kết nối."Fast"chế độ không chờ khách hàng ngắt kết nối và sẽ chấm dứt Sao lưu trực tuyến trong tiến trình. Tất cả các giao dịch hoạt động được thực hiện trở lại và khách hàng bị ngắt kết nối, sau đó soi kèo bóng đá truoctran chủ là Tắt."ngay lập tức"Chế độ sẽ hủy bỏ Tất cả các quy trình soi kèo bóng đá truoctran chủ mà không cần tắt soi kèo bóng đá truoctran. Điều này sẽ dẫn đến RECOVERE chạy khi khởi động lại.

Khởi động lạichế độ thực hiện hiệu quả soi kèo bóng đá truoctran Dừng lại theo sau là bắt đầu. Điều này cho phép thay đổiPostgressoi kèo bóng đá truoctran dòng lệnh.

Tải lạichế độ chỉ cần gửiPostgresQuy trình ASIGHUPTín hiệu, khiến nó đọc lại nó Tệp cấu hình (PostgreSql.conf, pg_hba.conf, v.v.). Điều này cho phép Thay đổi các soi kèo bóng đá truoctran tệp cấu hình không yêu cầu Hoàn thành khởi động lại để có hiệu lực.

trạng tháiChế độ kiểm tra xem soi kèo bóng đá truoctran chủ có phải là Chạy trong thư mục dữ liệu được chỉ định. Nếu là,PIDvà dòng lệnh Các soi kèo bóng đá truoctran được sử dụng để gọi nó được hiển thị.

giếtchế độ cho phép bạn gửi tín hiệu đến soi kèo bóng đá truoctran quy trình được chỉ định. Điều này đặc biệt có giá trị đối vớiMicrosoft WindowsKhông có soi kèo bóng đá truoctrangiếtLệnh. Sử dụng--HelpĐể xem danh sách tín hiệu được hỗ trợ tên.

Đăng kýchế độ cho phép bạn đăng ký Dịch vụ hệ thống trênMicrosoft Windows.

unregisterchế độ cho phép bạn Mở soi kèo bóng đá truoctran dịch vụ hệ thống trênMicrosoft Windows, Đã đăng ký trước đó vớiĐăng kýlệnh.

soi kèo bóng đá truoctran

-C

Cố gắng cho phép các sự cố soi kèo bóng đá truoctran chủ tạo ra các tệp lõi, trên các nền tảng có sẵn, bằng cách nâng bất kỳ sự mềm mại nào Giới hạn tài nguyên đặt trên chúng. Đ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 thu được từ một quy trình soi kèo bóng đá truoctran chủ không thành công.

-DDatadir

Chỉ định vị trí hệ thống tệp của cơ sở dữ liệu Tệp. Nếu điều này bị bỏ qua, biến môi trườngpgdatađược sử dụng.

-LFileName

Nối đầu ra nhật ký soi kèo bóng đá truoctran chủ vàoFileName. Nếu tệp không tồn tại, nó được tạo ra. TheUmaskIS đặt thành 077, vì vậy hãy truy cập vào tệp nhật ký từ những người dùng khác là không được phép theo mặc định.

-MMode

Chỉ định chế độ tắt soi kèo bóng đá truoctran.Modecó thểSmart, nhanhhoặcngay lập tứchoặc chữ cái đầu tiên của soi kèo bóng đá truoctran trong ba.

-Osoi kèo bóng đá truoctran

Chỉ định các soi kèo bóng đá truoctran sẽ được truyền trực tiếp choPostgreslệnh.

Các soi kèo bóng đá truoctran thường được bao quanh bởi đơn hoặc đôi trích dẫn để đảm bảo rằng chúng được truyền qua như một nhóm.

-PPath

Chỉ định vị trí củaPostgresthực thi. Theo mặc địnhPostgresthực thi được lấy từ cùng thư mục vớiPG_CTL, hoặc Không thành công, thư mục cài đặt có dây cứng. Nó là không cần thiết phải sử dụng soi kèo bóng đá truoctran này trừ khi bạn đang làm một cái gì đó bất thường và gặp lỗi màPostgresKhông tìm thấy thực thi.

ininitChế độ, soi kèo bóng đá truoctran này chỉ định tương tự vị trí củainitDBthực thi.

-S

Chỉ có lỗi in, không có tin nhắn thông tin.

-t

Số giây để chờ đợi khi chờ bắt đầu hoặc Tắt soi kèo bóng đá truoctran để hoàn thành.

-W

Đợi bắt đầu hoặc tắt soi kèo bóng đá truoctran hoàn tất. Mặc định Thời gian chờ là 60 giây. Đây là tùy chọn mặc định cho tắt soi kèo bóng đá truoctran. Việc tắt soi kèo bóng đá truoctran thành công được chỉ định bằng cách loại bỏ ThePIDTệp. Vì Bắt đầu, soi kèo bóng đá truoctran thành côngPSQL -LCho biết thành công.PG_CTLWill cố gắng sử dụng cổng thích hợp choPSQL. Nếu biến môi trườngPGPORTtồn tại, được sử dụng. Nếu không, nó sẽ xem nếu soi kèo bóng đá truoctran cổng đã được đặt trongPostgreSql.confTệp. Nếu không Trong số đó được sử dụng, nó sẽ sử dụng cổng mặc địnhPostgreSQLđã được biên soạn với (5432 theo mặc định). Khi chờ đợi,PG_CTLSẽ trả về mã thoát chính xác dựa trên sự thành công của khởi động hoặc tắt soi kèo bóng đá truoctran.

-W

Không chờ bắt đầu hoặc tắt soi kèo bóng đá truoctran hoàn tất. Đây là mặc định cho bắt đầu và khởi động lại.

soi kèo bóng đá truoctran cho Windows

-NServiceName

Tên của dịch vụ hệ thống để đăng ký. Tên sẽ được sử dụng làm cả tên dịch vụ và màn hình tên.

-PMật khẩu

Mật khẩu để người dùng khởi động dịch vụ.

-Utên người dùng

Tên người dùng để người dùng khởi động dịch vụ. Vì Người dùng miền, sử dụng định dạngDOMAIN \ username.

Môi trường

PGDATA

Vị trí thư mục dữ liệu mặc định.

PGHOST

Tên soi kèo bóng đá truoctran chủ mặc định hoặc vị trí ổ cắm miền Unix choPSQL(được sử dụng bởi-Wsoi kèo bóng đá truoctran).

PGPORT

Số cổng mặc định choPSQL(được sử dụng bởi-Wsoi kèo bóng đá truoctran).

Để biết các biến soi kèo bóng đá truoctran chủ bổ sung, xemPostgres. Tiện ích này, giống như hầu hết các khácPostgreSQLTiện ích, cũng sử dụng các biến môi trường được hỗ trợ bởilibpq(xemPhần 31.13).

Files

Postmaster.pid

Sự tồn tại của tệp này trong thư mục dữ liệu được sử dụng Để giúpPG_CTLXác định Nếu soi kèo bóng đá truoctran chủ hiện đang chạy hay không.

Postmaster.opts

Nếu tệp này tồn tại trong thư mục dữ liệu,PG_CTL(inKhởi động lạichế độ) sẽ vượt qua nội dung của Tệp dưới dạng soi kèo bóng đá truoctran choPostgres, trừ khi được ghi đè bởi-Osoi kèo bóng đá truoctran. Nội dung của cái này Tệp cũng được hiển thị trongstatuschế độ.

PostgreSql.conf

Tệp này, nằm trong thư mục dữ liệu, được phân tích cú pháp Tìm cổng thích hợp để sử dụng vớiPSQLKhi-Wđược đưa ra trongBắt đầuchế độ.

Ghi chú

Chờ bắt đầu hoàn toàn không phải là một hoạt động được xác định rõ và có thể thất bại nếu điều khiển truy cập được thiết lập để một soi kèo bóng đá truoctran khách cục bộ Không thể kết nối mà không có tương tác thủ công (ví dụ: mật khẩu xác thực). Để biết các biến kết nối bổ sung, xemPhần 31.13và cho mật khẩu, Cũng xemPhần 31,14.

ví dụ

Khởi động soi kèo bóng đá truoctran chủ

Để khởi động soi kèo bóng đá truoctran chủ:

$ PG_CTL Bắt đầu

Một ví dụ về khởi động soi kèo bóng đá truoctran chủ, chặn cho đến khi soi kèo bóng đá truoctran chủ đã xuất hiện là:

$ PG_CTL -W Bắt đầu

Đối với soi kèo bóng đá truoctran chủ sử dụng cổng 5433 và chạy mà không cófsync, Sử dụng:

$ PG_CTL -O "-F -P 5433" Bắt đầu

Dừng soi kèo bóng đá truoctran chủ

$ PG_CTL STOP

Dừng soi kèo bóng đá truoctran chủ. Sử dụng-MSwitch cho phép soi kèo bóng đá truoctran người điều khiểnLàm thế nàoPhần phụ trợ tắt.

Khởi động lại soi kèo bóng đá truoctran chủ

Khởi động lại soi kèo bóng đá truoctran chủ gần như tương đương với việc dừng soi kèo bóng đá truoctran chủ và khởi động lại ngoại trừPG_CTLLưu và sử dụng lại các tùy chọn dòng lệnh đã được chuyển đến trường hợp chạy trước đó. Để khởi động lại soi kèo bóng đá truoctran chủ ở dạng đơn giản nhất, sử dụng:

$ PG_CTL Khởi động lại

Để khởi động lại soi kèo bóng đá truoctran chủ, chờ nó tắt và đến hướng lên:

$ PG_CTL -W RESTART

Để khởi động lại bằng cổng 5433 và vô hiệu hóafsyncSau khi khởi động lại:

$ PG_CTL -O "-F -P 5433" Khởi động lại

Hiển thị trạng thái soi kèo bóng đá truoctran chủ

Đây là đầu ra trạng thái mẫu từPG_CTL:

$ Trạng thái PG_CTL
PG_CTL: soi kèo bóng đá truoctran chủ đang chạy (PID: 13718)
Dòng lệnh là:
/usr/local/pgsql/bin/postgres '-d' '/usr/local/pgsql/data' '-p' '5433' '-b' '128'

Đây là dòng lệnh sẽ được gọi khi khởi động lại cách thức.

Xem thêm

initDB, Postgres