pgbouncer - מקוון בענן

תָכְנִית:

שֵׁם

pgbouncer - פולר חיבורים קל משקל עבור PostgreSQL

תַקצִיר

pgbouncer [-d][-R][-v][-u משתמש]
pgbouncer -V|-h

במחשבי Windows, האפשרויות הן:

pgbouncer.exe [-v][-u משתמש]
pgbouncer.exe -V|-h

אפשרויות נוספות להגדרת שירות Windows:

pgbouncer.exe --regservice
pgbouncer.exe --unregservice

תיאור

pgbouncer הוא מאגר חיבורים של PostgreSQL. ניתן להתחבר לכל יישום יעד
pgbouncer כאילו זה היה שרת PostgreSQL, ו pgbouncer ייצור חיבור ל-
שרת בפועל, או שהוא יעשה שימוש חוזר באחד מהחיבורים הקיימים שלו.

מטרת pgbouncer היא להפחית את השפעת הביצועים של פתיחת חיבורים חדשים
PostgreSQL

על מנת לא להתפשר על סמנטיקה של עסקאות עבור איגום חיבורים, pgbouncer
תומך במספר סוגי איגום בעת סיבוב חיבורים:

מוֹשָׁב בריכה
שיטה מנומסת ביותר. כאשר הלקוח מתחבר, יוקצה חיבור לשרת
זה במשך כל משך הזמן שהלקוח נשאר מחובר. כאשר הלקוח מתנתק,
חיבור השרת יוחזר לבריכה. זוהי שיטת ברירת המחדל.

עסקה בריכה
חיבור שרת מוקצה ללקוח רק במהלך עסקה. מתי
PgBouncer שם לב שהעסקה הסתיימה, חיבור השרת יוחזר
לתוך הבריכה.

הצהרה בריכה
השיטה הכי אגרסיבית. חיבור השרת יוחזר לבריכה
מיד לאחר השלמת שאילתה. עסקאות מרובות הצהרות אינן מותרות
מצב זה כפי שהם ישברו.

ממשק הניהול של pgbouncer מורכב מכמה חדשים לְהַצִיג פקודות זמינות
כאשר הוא מחובר למסד נתונים 'וירטואלי' מיוחד pgbouncer.

התחלה מהירה

הגדרה ושימוש בסיסיים כדלקמן.

1. צור קובץ pgbouncer.ini. פרטים ב pgbouncer(5). דוגמה פשוטה:

[מאגרי מידע]
template1 = host=127.0.0.1 port=5432 dbname=template1

[pgbouncer]
יציאת האזנה = 6543
listen_addr = 127.0.0.1
auth_type = md5
auth_file = users.txt
logfile = pgbouncer.log
pidfile = pgbouncer.pid
admin_users = משתמש מסוים

2. לִיצוֹר users.txt קובץ המכיל משתמשים המורשים ב:

"someuser" "אותה_סיסמה_כמו_בשרת"

3. לְהַשִׁיק pgbouncer:

$ pgbouncer -d pgbouncer.ini

4. שלח את הבקשה שלך (או את psql לקוח) להתחבר ל pgbouncer במקום ישירות ל
שרת PostgreSQL:

$ psql -p 6543 -U someuser template1

5. לנהל pgbouncer על ידי התחברות למאגר הניהול המיוחד pgbouncer ו
הנפקת לְהַצִיג עֶזרָה; להתחיל:

$ psql -p 6543 -U someuser pgbouncer
pgbouncer=# הצג עזרה;
הודעה: שימוש בקונסולה
פרט:
הצג [עזרה|קונפיגורציה|מאגרי מידע|FDS|בריכות|לקוחות|שרתים|Sockets|רשימות|גרסה]
מקש SET = arg
העלאה
פוגה
השעיה
תקציר
השבתה

6. אם ביצעת שינויים בקובץ pgbouncer.ini, תוכל לטעון אותו מחדש באמצעות:

pgbouncer=# טען מחדש;

פקודה קו מתגים

-d רץ ברקע. בלעדיו התהליך ירוץ בחזית. הערה: לא
לעבוד על ווינדוס, pgbouncer צריך לפעול שם כשירות.

-R בצע אתחול מקוון. זה אומר להתחבר לתהליך הפועל, לטעון את
לפתוח שקעים ממנו, ולאחר מכן להשתמש בהם. אם אין תהליך פעיל, אתחל
בדרך כלל. הערה: עובד רק אם מערכת ההפעלה תומכת בשקעי Unix וב- unix_socket_dir is
לא מושבת בתצורה. לא עובד על מחשבי Windows. לא עובד עם TLS
חיבורים, הם נשמטים.

-u המשתמש
עבור למשתמש הנתון בעת ​​ההפעלה.

-v הגבר את מידת המלל. ניתן להשתמש מספר פעמים.

-q שקט - אל תיכנס ל-stdout. שים לב שזה לא משפיע על מילולי הרישום, בלבד
אסור להשתמש ב-stdout. לשימוש בסקריפטים של init.d.

-V הצג גרסה.

-h הצג עזרה קצרה.

--regservice
Win32: רשום את pgbouncer להפעלה כשירות Windows. ה שם השירות config
ערך הפרמטר משמש כשם לרישום תחתיו.

--unregservice
Win32: בטל את הרישום של שירות Windows.

אדמין קונסוליה

המסוף זמין על ידי חיבור כרגיל למסד הנתונים pgbouncer:

$ psql -p 6543 pgbouncer

רק משתמשים הרשומים בפרמטרים של תצורה admin_users or stats_users מורשים ל
היכנס לקונסולה. (חוץ ממתי auth_mode=כל, אז כל משתמש רשאי להיכנס בתור
stats_user.)

בנוסף, שם המשתמש pgbouncer מותר להיכנס ללא סיסמה, אם הכניסה
מגיע דרך שקע Unix וללקוח יש את אותו משתמש Unix כמו לתהליך הפועל.

לְהַצִיג פקודות
השמיים לְהַצִיג פקודות פלט מידע. כל פקודה מתוארת להלן.

לְהַצִיג סטטיסטיקה;
מציג סטטיסטיקות.

מסד נתונים
נתונים סטטיסטיים מוצגים לפי מסד נתונים.

total_requests
המספר הכולל של בקשות SQL מאוחדות על ידי pgbouncer.

סך_התקבל
נפח כולל בבתים של תעבורת רשת שהתקבלה על ידי pgbouncer.

סך_נשלח
נפח כולל בבתים של תעבורת רשת שנשלחה על ידי pgbouncer.

total_query_time
המספר הכולל של מיקרו-שניות שהושקע על ידי pgbouncer כאשר מחובר באופן פעיל ל
PostgreSQL

avg_req
ממוצע בקשות לשנייה בתקופת הנתונים האחרונה.

avg_recv
ממוצע בתים שהתקבלו (מלקוחות) לשנייה.

avg_sent
ממוצע בתים שנשלחו (ללקוחות) לשנייה.

avg_query
משך שאילתה ממוצע במיקרו-שניות.

לְהַצִיג שרתים;
סוג S, לשרת.

המשתמש שם משתמש pgbouncer משתמש כדי להתחבר לשרת.

מסד נתונים
שם בסיס הנתונים.

היו מצב החיבור לשרת pgbouncer, אחד מ פעיל, מְשׁוּמָשׁ or להתבטל.

Addr כתובת ה-IP של שרת PostgreSQL.

נמל יציאה של שרת PostgreSQL.

local_addr
כתובת תחילת החיבור במחשב המקומי.

local_port
יציאת התחלת חיבור במחשב מקומי.

זמן_חיבור
מתי נוצר החיבור.

זמן הבקשה
מתי הוגשה הבקשה האחרונה.

ptr כתובת של אובייקט פנימי עבור חיבור זה. משמש כמזהה ייחודי.

קישור כתובת חיבור הלקוח שאליו השרת משויך.

remote_pid
Pid של תהליך השרת האחורי. במקרה שהחיבור נעשה דרך שקע יוניקס ומערכת הפעלה
תומך בקבלת מידע מזהה תהליך, זה מערכת ההפעלה pid. אחרת זה מופק מ
בטל שרת מנות שנשלח, שאמור להיות PID במקרה שהשרת הוא Postgres, אבל זה כן
מספר אקראי במקרה שהשרת זה PgBouncer אחר.

לְהַצִיג לקוחות;
סוג ג, ללקוח.

המשתמש משתמש מחובר ללקוח.

מסד נתונים
שם בסיס הנתונים.

היו מצב חיבור הלקוח, אחד מ פעיל, מְשׁוּמָשׁ, המתנה or להתבטל.

Addr כתובת ה-IP של הלקוח.

נמל לקוח פורט מחובר.

local_addr
כתובת סיום החיבור במחשב המקומי.

local_port
יציאת קצה חיבור במחשב מקומי.

זמן_חיבור
חותמת זמן של זמן חיבור.

זמן הבקשה
חותמת זמן של בקשת הלקוח האחרונה.

ptr כתובת של אובייקט פנימי עבור חיבור זה. משמש כמזהה ייחודי.

קישור כתובת חיבור השרת שהלקוח משויך אליו.

remote_pid
מזהה תהליך, במקרה שהלקוח מתחבר דרך שקע UNIX ומערכת ההפעלה תומכת בקבלתו.

לְהַצִיג בריכות;
כניסה חדשה לבריכה מתבצעת עבור כל זוג (מסד נתונים, משתמש).

מסד נתונים
שם בסיס הנתונים.

המשתמש שם משתמש.

cl_active
חיבורי לקוח המקושרים לחיבור שרת ויכולים לעבד שאילתות.

cl_ממתין
חיבורי לקוח שלחו שאילתות אך עדיין לא קיבלו חיבור לשרת.

sv_active
חיבורי שרת שקישרו ללקוח.

sv_idle
חיבורי שרת שאינם בשימוש ושמישים באופן מיידי עבור שאילתות לקוח.

sv_used
חיבורי שרת שהיו לא פעילים יותר מ server_check_delay, אז הם צריכים
server_check_query לרוץ עליו לפני שניתן יהיה להשתמש בו.

sv_tested
גם חיבורי שרת שפועלים כעת server_reset_query or
server_check_query.

sv_login
חיבורי שרת נמצאים כעת בתהליך התחברות.

maxwait
כמה זמן המתין הלקוח הראשון (הישן ביותר) בתור, בשניות. אם זה מתחיל
עולה, אז מאגר השרתים הנוכחי לא מטפל בבקשות מספיק מהר.
הסיבה עשויה להיות שרת עמוס יתר על המידה או פשוט קטן מדי מידת בריכה הגדרה.

מצב_בריכה
מצב הבריכה בשימוש.

לְהַצִיג רשימות;
הצג את המידע הפנימי הבא, בעמודות (לא בשורות):

מאגרי מידע
ספירת מאגרי מידע.

משתמשים ספירת משתמשים.

ברכות ספירת הבריכות.

free_clients
ספירת לקוחות בחינם.

משומשים_לקוחות
ספירת לקוחות בשימוש.

login_clients
ספירת הלקוחות ב התחבר מדינה.

שרתים_חופשיים
ספירת שרתים בחינם.

שרתים_משומשים
ספירת השרתים בשימוש.

לְהַצִיג משתמשים;
שם שם המשתמש

מצב_בריכה
במקום זאת, ישמש ה-pool_mode של המשתמש, או NULL אם ברירת המחדל תשמש.

לְהַצִיג מסדי נתונים;
שם שם ערך מסד הנתונים שהוגדר.

המארח Host pgbouncer מתחבר ל.

נמל Port pgbouncer מתחבר אליו.

מסד נתונים
שם מסד הנתונים האמיתי pgbouncer מתחבר אליו.

כוח_משתמש
כאשר המשתמש הוא חלק ממחרוזת החיבור, החיבור בין pgbouncer ו
PostgreSQL נאלץ למשתמש הנתון, לא משנה מה משתמש הלקוח.

מידת בריכה
מספר מקסימלי של חיבורי שרת.

מצב_בריכה
במקום זאת, ייעשה שימוש ב-pool_mode של מסד הנתונים, או NULL אם ברירת המחדל תשמש.

לְהַצִיג FDS;
פקודה פנימית - מציג רשימה של FDS בשימוש עם מצב פנימי מצורף אליהם.

כאשר למשתמש המחובר יש שם משתמש "pgbouncer", מתחבר דרך שקע יוניקס ויש לו
אותו UID כמו תהליך הפעלה, ה-fds בפועל מועברים על החיבור. זֶה
המנגנון משמש לביצוע הפעלה מחדש מקוונת. הערה: זה לא עובד במחשבי Windows.

פקודה זו גם חוסמת לולאת אירועים פנימית, כך שאין להשתמש בה בזמן PgBouncer
בשימוש.

fd ערך מספרי של מתאר קובץ.

משימה אחד פולר, לקוחות or שרת.

המשתמש משתמש בחיבור באמצעות ה-FD.

מסד נתונים
מסד נתונים של החיבור באמצעות ה-FD.

Addr כתובת ה-IP של החיבור באמצעות ה-FD, יוניקס אם נעשה שימוש בשקע יוניקס.

נמל יציאה המשמשת את החיבור באמצעות ה-FD.

לבטל מפתח ביטול עבור חיבור זה.

קישור fd עבור שרת/לקוח מתאים. NULL אם לא פעיל.

לְהַצִיג CONFIG;
הצג את הגדרות התצורה הנוכחיות, אחת בכל שורה, עם העמודות הבאות:

מפתח שם משתנה תצורה

ערך ערך תצורה

משתנה
או כן or לא, מראה אם ​​ניתן לשנות את המשתנה תוך כדי ריצה. אם לא, ה
ניתן לשנות את המשתנה רק בזמן האתחול.

לְהַצִיג DNS_HOSTS;
הצג שמות מארחים במטמון DNS.

המארח
שם מארח.

Ttl כמה שניות עד לחיפוש הבא.

כתובות רשימת כתובות מופרדת בפסיק.

לְהַצִיג DNS_ZONES
הצג אזורי DNS במטמון.

שם אזור
שם אזור.

סידורי סדרה נוכחית.

לספור שמות מארחים השייכים לאזור זה.

התַהֲלִיך שליטה פקודות
פוגה [db];
PgBouncer מנסה להתנתק מכל השרתים, ממתין תחילה לסיום כל השאילתות.
הפקודה לא תחזור לפני שכל השאילתות יסתיימו. לשימוש בזמן של
הפעלה מחדש של מסד הנתונים.

אם יינתן שם מסד הנתונים, רק מסד הנתונים הזה יושהה.

מושבת db;
דחה את כל חיבורי הלקוח החדשים במסד הנתונים הנתון.

הפעל db;
אפשר חיבורי לקוח חדשים לאחר חיבורים קודמים מושבת פקודה.

KILL db;
שחרר מיד את כל חיבורי הלקוח והשרת במסד נתונים נתון.

להשעות;
כל מאגרי השקע נשטפים ו-PgBouncer מפסיק להאזין לנתונים עליהם. ה
הפקודה לא תחזור לפני שכל המאגרים יהיו ריקים. לשימוש בזמן PgBouncer
אתחול מקוון.

תקציר [db];
המשך עבודה מהקודם פוגה or השעיה פקודה.

כיבוי;
תהליך PgBouncer ייצא.

לִטעוֹן מִחָדָשׁ;
תהליך PgBouncer יטען מחדש את קובץ התצורה שלו ויעדכן את ההגדרות הניתנות לשינוי.

אותות
הרשמה טען מחדש את התצורה. זהה להוצאת פקודה לִטעוֹן מִחָדָשׁ; על הקונסולה.

סיגינט כיבוי בטוח. אותו דבר כמו הנפקה הַפסָקָה; ו כיבוי; על הקונסולה.

טווח יעד
כיבוי מיידי. אותו דבר כמו הנפקה כיבוי; על הקונסולה.

ליבבנט הגדרות
מ-libevent docs:

אפשר להשבית את התמיכה ב-epoll, kqueue, devpoll, poll
או בחר על ידי הגדרת משתנה הסביבה EVENT_NOEPOLL,
EVENT_NOKQUEUE, EVENT_NODEVPOLL, EVENT_NOPOLL או EVENT_NOSELECT,
בהתאמה.

על ידי הגדרת משתנה הסביבה EVENT_SHOW_METHOD, libevent
מציג את שיטת ההתראות של הליבה שבה היא משתמשת.

השתמש ב-pgbouncer באינטרנט באמצעות שירותי onworks.net