نام (NAME)

pg_isready - بررسی وضعیت اتصال سرور PostgreSQL

خلاصه دستور (SYNOPSIS)

pg_isready [connection-option...] [option...]

توضیحات (DESCRIPTION)

دستور pg_isready ابزاری برای بررسی وضعیت اتصال به یک سرور پایگاه‌دادهٔ PostgreSQL است. وضعیت خروج، نتیجهٔ بررسی اتصال را مشخص می‌کند.

گزینه‌ها (OPTIONS)

-d dbname
--dbname=dbname

-h hostname
--host=hostname

-p port
--port=port

-q
--quiet

-t seconds
--timeout=seconds

-U username
--username=username

-V
--version

-?
--help

وضعیت خروج (EXIT STATUS)

دستور pg_isready اگر سرور به‌طور عادی اتصالات را بپذیرد مقدار 0، اگر سرور اتصالات را رد کند (مثلاً هنگام راه‌اندازی) مقدار 1، اگر پاسخی به تلاش برای برقراری اتصال داده نشود مقدار 2، و اگر هیچ تلاشی انجام نشود (مثلاً به دلیل پارامترهای نامعتبر) مقدار 3 را به پوسته برمی‌گرداند.

محیط (ENVIRONMENT)

دستور pg_isready، مانند اکثر ابزارهای دیگر PostgreSQL، از متغیرهای محیطی پشتیبانی‌شده توسط libpq نیز استفاده می‌کند (بخش 32.15 را ببینید).

متغیر محیطی PG_COLOR مشخص می‌کند که آیا در پیام‌های عیب‌یابی از رنگ استفاده شود یا خیر. مقادیر ممکن عبارت‌اند از always، auto و never.

نکات (NOTES)

برای دریافت وضعیت سرور نیازی به ارائهٔ مقادیر صحیح نام کاربری، گذرواژه یا نام پایگاه‌داده نیست؛ با این حال، اگر مقادیر نادرست ارائه شوند، سرور تلاش ناموفق برای برقراری اتصال را در گزارش‌های خود ثبت خواهد کرد.

مثال‌ها (EXAMPLES)

استفادهٔ معمول:

$ pg_isready
/tmp:5432 - accepting connections
$ echo $?
0

اجرا با پارامترهای اتصال به یک کلاستر PostgreSQL در حال راه‌اندازی:

$ pg_isready -h localhost -p 5433
localhost:5433 - rejecting connections
$ echo $?
1

اجرا با پارامترهای اتصال به یک کلاستر PostgreSQL غیرپاسخگو:

$ pg_isready -h someremotehost
someremotehost:5432 - no response
$ echo $?
2