‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

הגדרת ניהול של מאגר חיבורים

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

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

לפני שמתחילים

מאגר החיבורים המנוהל תומך גם בחיבורים עם שרת ה-Proxy לאימות של AlloyDB או עם מחברי השפות ל-AlloyDB.

התפקידים הנדרשים

כדי לקבל את ההרשאה שנדרשת להפעלה ולשימוש במאגר מנוהל של חיבורים, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של AlloyDB (roles/alloydb.admin) במכונה של AlloyDB. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה alloydb.instances.update, שנדרשת כדי להפעיל מאגר חיבורים מנוהל ולהשתמש בו.

יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.

אפשרויות הגדרה מתקדמות

במאגר החיבורים המנוהל של AlloyDB אפשר להשתמש באפשרויות המתקדמות הבאות להגדרת המאגר. כדי להתאים אישית את מאגר החיבורים המנוהל בהתאם לצורכי המכונה, אתם יכולים להגדיר את ההגדרות האלה ברמת המכונה באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API של AlloyDB.

שם ההגדרה האישית	תיאור
מצב החיבור (`connection-pooling-pool-mode`)	במצב החיבור, אפשר לבחור בעסקה (ברירת המחדל) או בסשן. עסקה (`transaction`): מאגר חיבורים ברמת העסקה. חיבור לשרת מוקצה ללקוח במהלך טרנזקציה. אחרי שהטרנזקציה מסתיימת, החיבור לשרת מוחזר למאגר. סשן (`session`): מאגר חיבורים ברמת הסשן. חיבור לשרת מוקצה ללקוח במשך כל הזמן שהוא מחובר. אחרי שהלקוח מתנתק, החיבור לשרת חוזר למאגר.
גודל מאגר מקסימלי (`connection-pooling-max-pool-size`)	הגודל המקסימלי של מאגר החיבורים לכל זוג של משתמש ומסד נתונים. הערך יכול להיות בין `1` ל-`262,042` חיבורים, וערך ברירת המחדל הוא `50` חיבורים.
גודל מאגר מינימלי (`connection-pooling-min-pool-size`)	הגודל המינימלי של מאגר החיבורים. הערך יכול להיות בין `0` ל-`262,042` חיבורים, וערך ברירת המחדל הוא `0` חיבורים.
מספר החיבורים המקסימלי של לקוחות (`connection-pooling-max-client-connections`)	המספר המקסימלי של חיבורי לקוחות בו-זמניים שמותרים. הערך הזה יכול להיות בין `1` ל-`262,042` חיבורים, וערך ברירת המחדל הוא `5000` חיבורים.
זמן קצוב לתפוגה של חיבור לקוח לא פעיל (`connection-pooling-client-connection-idle-timeout`)	משך הזמן שבו חיבור של לקוח נשאר במצב של חוסר פעילות לפני שנגמר הזמן הקצוב לתפוגה. הערך הזה יכול להיות בין `0` ל-`2,147,483` שניות, וערך ברירת המחדל הוא `0` שניות.
זמן קצוב לתפוגה של חיבור לשרת לא פעיל (`connection-pooling-server-idle-timeout`)	משך הזמן שבו החיבור לשרת נשאר במצב של חוסר פעילות לפני שפג הזמן הקצוב לתפוגה. הערך הזה יכול להיות בין `0` ל-`2,147,483` שניות, וערך ברירת המחדל הוא `600` שניות.
זמן קצוב לתפוגה של המתנה לשאילתה(שניות) (`connection-pooling-query-wait-timeout`)	משך הזמן ששאילתה ממתינה עד שהזמן הקצוב לתפוגה שלה נגמר. הערך הזה יכול להיות בין `0` ל-`2,147,483` שניות, וערך ברירת המחדל הוא `120` שניות.
מספר מקסימלי של שאילתות מוכנות (`connection-pooling-max-prepared-statements`)	המספר המקסימלי של פקודות prepared statement שנשלחות במצב של איגוד טרנזקציות. הערך יכול להיות בין `0` ל-`262,042`, וערך ברירת המחדל הוא `0`.
התעלמות מפרמטרים של הפעלה (`connection-pooling-ignore-startup-parameters`)	רשימה מופרדת בפסיקים של פרמטרים להפעלה שמאגר החיבורים מתעלם מהם כשהם לא נמצאים במעקב בחבילות ההפעלה כברירת מחדל. ערך ברירת המחדל הוא `extra_float_digits`.
משך החיים של השרת (`connection-pooling-server-lifetime`)	משך הזמן המקסימלי שבו חיבור לשרת לא נמצא בשימוש לפני שמאגר החיבורים המנוהל סוגר אותו. הערך יכול להיות בין `0` ל-`2,147,483` שניות, וערך ברירת המחדל הוא `3600` שניות.
משתמשים בנתונים הסטטיסטיים (`connection-pooling-stats-users`)	רשימה מופרדת בפסיקים של משתמשי מסד נתונים שמורשים להתחבר למסוף הנתונים הסטטיסטיים. אפשר להגדיר את הפרמטר הזה באמצעות Google Cloud CLI או AlloyDB API. משתמשים מורשים יכולים לגשת למדדים מתקדמים, שנשמרים במסד הנתונים של `alloydb_mcp_stats_{pooler_id}` לכל מאגר.

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

כשמפעילים מאגר חיבורים מנוהל, גם החיבורים של שרת ה-proxy לאימות ב-AlloyDB נאספים במאגר נפרד שכולל רק חיבורים שנאספו במאגר עם שרת proxy לאימות ב-AlloyDB.

הפעלת מאגר חיבורים מנוהל

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

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

כדי ליצור מכונה ראשית חדשה עם מאגר חיבורים מנוהל, קראו את המאמר יצירת מכונה ראשית. אפשר להפעיל מאגר חיבורים מנוהל למכונה באמצעות מסוףGoogle Cloud ,‏ Google Cloud CLI או AlloyDB API.

הפעלה במכונה חדשה של מאגר קריאה

כדי ליצור מכונה חדשה של מאגר קריאה עם מאגר חיבורים מנוהל, קראו את המאמר יצירת מכונה של מאגר קריאה. אפשר להפעיל מאגר חיבורים מנוהל למכונה באמצעות מסוףGoogle Cloud ,‏ Google Cloud CLI או AlloyDB API.

הפעלה במכונה קיימת

אפשר להפעיל מאגר חיבורים מנוהל במכונה קיימת באמצעות מסוףGoogle Cloud ,‏ Google Cloud CLI או AlloyDB API.

המסוף

נכנסים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה Resource name.
בדף Overview, עוברים לקטע Instances in your cluster.
לוחצים על Edit primary או על Edit read pool.
בקטע Managed connection pool, מסמנים את התיבה Enable managed connection pool.
אופציונלי: כדי להגדיר אפשרויות של מאגר חיבורים מנוהל, לוחצים על Advanced pooling options.

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

gcloud

כדי להפעיל מאגר חיבורים מנוהל במכונה קיימת של מאגר ראשי או מאגר לקריאה בלבד, משתמשים בפקודה הבאה של gcloud alloydb instances update:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_ID: המזהה של מכונה ב-AlloyDB שרוצים להפעיל בה מאגר חיבורים מנוהל.
‫PROJECT_ID: מזהה הפרויקט
‫REGION_ID: מזהה האזור.
‫CLUSTER_ID: מזהה האשכול.

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

REST

כדי להפעיל מאגר חיבורים מנוהל במכונה ראשית קיימת או במכונה קיימת של מאגר לקריאה בלבד, משתמשים בפקודה הבאה ומגדירים את connectionPoolConfig:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION_ID: מזהה האזור של האשכול.
‫CLUSTER_ID: מזהה האשכול. הוא חייב להתחיל באות קטנה באנגלית ויכול להכיל אותיות קטנות, מספרים ומקפים.
‫INSTANCE_ID: מזהה המכונה.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

התחברות למאגר חיבורים מנוהל

ההתחברות למאגר חיבורים מנוהל זהה לחיבורים ישירים למסד נתונים, אבל ביציאה אחרת. מאגר החיבורים המנוהל מאזין ליציאה 6432. כל משתמש שנוסף למכונה של AlloyDB יכול להתחבר באמצעות מאגר חיבורים מנוהל.

התחברות באמצעות אימות מובנה

הפקודה שבדוגמה מחברת את המכונה ב-AlloyDB למאגר חיבורים מנוהל באמצעות אימות מובנה.

psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/postgres

מחליפים את מה שכתוב בשדות הבאים:

‫USERNAME: שם המשתמש של מסד הנתונים שמתחבר למכונה של AlloyDB.
‫PASSWORD: הסיסמה של המשתמש.
‫IP_ADDRESS: כתובת ה-IP של מכונת AlloyDB.

התחברות באמצעות חיבורי SSL

מצב ה-SSL של המכונה חל גם על כל החיבורים למאגר החיבורים המנוהל. כברירת מחדל, המערכת מקבלת רק חיבורי SSL. כדי לאפשר חיבורים לא מוצפנים, משתמשים בפקודה הבאה של gcloud alloydb instances update כדי להגדיר את מצב ה-SSL של המכונה ל-ALLOW_UNENCRYPTED_AND_ENCRYPTED.

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

התחברות באמצעות אימות IAM

אתם יכולים להתחבר למאגר חיבורים מנוהל באמצעות אימות IAM באחת משתי דרכים:

אימות באמצעות אסימון OAuth 2.0: משתמשים ב-CLI של gcloud כדי לקבל אסימון OAuth 2.0 ומשתמשים בו כסיסמה כשמתחברים ליציאה 6432. מידע נוסף זמין במאמר אימות באמצעות אסימון OAuth 2.0.
אימות אוטומטי: משתמשים ב-AlloyDB Auth Proxy עם הדגל --auto-iam-authn, או מפעילים אימות IAM באופן פרוגרמטי באמצעות מחברי שפות ל-AlloyDB.

הצגת נתונים סטטיסטיים על מאגרי חיבורים מנוהלים

כשמפעילים מאגר חיבורים מנוהל במכונה של AlloyDB, אפשר להתחבר למסוף הנתונים הסטטיסטיים המובנה כדי לראות מידע מפורט בזמן אמת על מאגרי החיבורים. אפשר לגשת למסוף הנתונים הסטטיסטיים ביציאה 6432 דרך כתובת IP פרטית באמצעות גישה לשירותים פרטיים או Private Service Connect. מסוף הנתונים הסטטיסטיים שימושי למעקב אחרי חיבורים פעילים או לא פעילים, לפתרון בעיות שקשורות לזמני המתנה ולאופטימיזציה של גודלי המאגרים.

כדי להשתמש בקונסולת הנתונים הסטטיסטיים, פועלים לפי השלבים הבאים:

כברירת מחדל, למשתמשים במסד הנתונים אין הרשאה לגשת למסוף הנתונים הסטטיסטיים. כדי לציין אילו משתמשים יכולים להתחבר למסד הנתונים, צריך להשתמש ב-Google Cloud CLI. הפעולה הזו מוסיפה אותם לרשימת ההיתרים של הגישה למסוף הנתונים הסטטיסטיים.

כדי להוסיף משתמש למסוף הנתונים הסטטיסטיים, משתמשים בפקודה gcloud alloydb instances update:
```
gcloud alloydb instances update INSTANCE_ID \
--project=PROJECT_ID \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--connection-pooling-stats-users=STATS_USERS
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫INSTANCE_ID: השם של מכונת AlloyDB שרוצים לתת למשתמשים הרשאה לגשת למסוף הנתונים הסטטיסטיים שלה.
- ‫STATS_USERS: רשימה מופרדת בפסיקים של שמות משתמשים במסד הנתונים.
- ‫PROJECT_ID: מזהה הפרויקט
- ‫REGION_ID: מזהה האזור.
- ‫CLUSTER_ID: מזהה האשכול.
מתחברים למכונה ביציאה 6432. כל מכונה נפרדת של מאגר החיבורים שומרת את המדדים שלה במסד נתונים עם מספר ייחודי. מציינים את מסד הנתונים הרלוונטי של הנתונים הסטטיסטיים של מאגר החיבורים שרוצים לעקוב אחריו:
- למאגרים רגילים, צריך להשתמש ב-alloydb_mcp_stats_POOLER_ID. המזהה הוא 1, עד למספר מאגרי החיבורים שפועלים במכונה.
- למאגר של שרת ה-proxy לאימות, משתמשים ב-alloydb_mcp_stats_authproxy_pooler1.
הערה: אפשר לגשת למסד הנתונים של מסוף הנתונים הסטטיסטיים של מאגר ה-Auth Proxy רק באמצעות חיבור דרך לקוח ה-Auth Proxy.
```
psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/alloydb_mcp_stats_1
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫POOLER_ID: המזהה של מאגר החיבורים. המזהה הוא 1, עד למספר מאגרי החיבורים שפועלים במכונה.
- ‫USERNAME: שם המשתמש של מסד הנתונים להתחברות למכונה של AlloyDB.
- ‫PASSWORD: הסיסמה של המשתמש.
- ‫IP_ADDRESS: כתובת ה-IP של מכונת AlloyDB. הכתובת חייבת להיות מסוג Private Service Connect ‏ (PSC) או גישה לשירותים פרטיים (PSA).
אחרי שמתחברים, מריצים פקודות SHOW שתואמות ל-PgBouncer כדי לראות מדדים, לדוגמה:
- ‫SHOW STATS;: הצגת נתונים סטטיסטיים כלליים לכל מסד נתונים.
- ‫SHOW POOLS;: רשימה של הסטטוסים של כל מאגרי החיבורים הנוכחיים.
- ‫SHOW CLIENTS;: הצגת מידע על החיבורים הנוכחיים של הלקוחות.

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

שינוי של מאגר החיבורים המנוהל של מכונה

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

אתם יכולים לשנות את אפשרויות ההגדרה של מאגר החיבורים המנוהל במכונה קיימת באמצעות מסוף Google Cloud ,‏ Google Cloud CLI או AlloyDB API.

המסוף

נכנסים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה Resource Name.
בדף Overview, עוברים לקטע Instances in your cluster.
לוחצים על Edit instance או על Edit read pool במכונה שרוצים לשנות.
בקטע Managed connection pool, מרחיבים את Advanced pooling options.
משנים את האפשרויות המתקדמות של מאגר הכתובות שרוצים לעדכן. אפשר לשנות את האפשרויות הבאות:
- מצב החיבור
- גודל מאגר מקסימלי
- גודל מאגר מינימלי
- מספר מקסימלי של חיבורי לקוחות
- זמן קצוב לתפוגה של חיבור לקוח לא פעיל(בשניות)
- זמן קצוב לתפוגה של חיבור לשרת לא פעיל(בשניות)
- זמן קצוב לתפוגה של המתנה לשאילתה(בשניות)
- מספר מקסימלי של הצהרות מוכנות
- התעלמות מפרמטרים של הפעלה
- משך החיים של השרתים
לוחצים על Update instance.

gcloud

כדי לשנות את אפשרויות ההגדרה של מאגר החיבורים המנוהל במכונה קיימת, משתמשים בפקודה הבאה של gcloud alloydb instances update:

  gcloud alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTIONS \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
      | --connection-pooling-max-prepared-statements=MAX_PREPARED_STATEMENTS \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_ID: השם של מכונת AlloyDB שרוצים לשנות את אפשרויות ניהול מאגר החיבורים שלה.
‫PROJECT_ID: מזהה הפרויקט
‫REGION_ID: מזהה האזור.
‫CLUSTER_ID: מזהה האשכול.
אפשר להגדיר את האפשרויות הבאות:
- ‫--connection-pooling-pool-mode. הערך צריך להיות session או transaction.
- --connection-pooling-max-pool-size
- --connection-pooling-min-pool-size
- --connection-pooling-max-client-connections
- --connection-pooling-server-idle-timeout
- --connection-pooling-query-wait-timeout
- --connection-pooling-ignore-startup-parameters
- --connection-pooling-max-prepared-statements
- --connection-pooling-server-lifetime
- --connection-pooling-client-connection-idle-timeout

REST

כדי לשנות את אפשרויות ההגדרה של מאגר החיבורים המנוהל במכונה קיימת, משתמשים בפקודה הבאה ומגדירים את connectionPoolConfig:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION_ID: מזהה האזור של האשכול.
‫CLUSTER_ID: מזהה האשכול. הוא חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
‫INSTANCE_ID: מזהה המכונה.
אפשר להגדיר את האפשרויות הבאות:
- ‫POOL_MODE. הערך צריך להיות session או transaction.
- MAX_POOL_SIZE
- MIN_POOL_SIZE
- MAX_CLIENT_CONNECTIONS
- SERVER_IDLE_TIMEOUT
- QUERY_WAIT_TIMEOUT
- IGNORE_STARTUP_PARAMETERS
- MAX_PREPARED_STATEMENTS
- SERVER_LIFETIME
- CLIENT_CONNECTION_IDLE_TIMEOUT
- STATS_USERS

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connections": "MAX_CLIENT_CONNECTIONS",
      "server_connection_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS",
      "max_prepared_statements": "MAX_PREPARED_STATEMENTS",
      "server_lifetime": "SERVER_LIFETIME",
      "client_connection_idle_timeout": "CLIENT_CONNECTION_IDLE_TIMEOUT",
      "stats_users": "STATS_USERS"
    }
  }
}

איך בודקים את הסטטוס של מאגר החיבורים המנוהל במכונה

אתם יכולים לראות את הסטטוס של מאגר החיבורים המנוהל של מכונה באמצעות מסוף Google Cloud , Google Cloud CLI או AlloyDB API.

המסוף

נכנסים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה Resource Name.
בדף Overview, מאתרים את המכונה שרוצים לראות את הסטטוס של מאגר החיבורים המנוהלים שלה. בשדה Managed connection pooling אפשר לראות אם המאגר מופעל או מושבת.

gcloud

כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה קיימת, משתמשים בפקודה הבאה של gcloud alloydb instances describe:

gcloud alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_ID: השם של מכונת AlloyDB שרוצים לראות את הסטטוס של מאגר החיבורים המנוהל שלה.
‫PROJECT_ID: מזהה הפרויקט
‫REGION_ID: מזהה האזור.
‫CLUSTER_ID: מזהה האשכול.

אם מאגר החיבורים המנוהל מופעל, מוחזרת התגובה הבאה:

True

REST

כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה של AlloyDB, משתמשים בפקודה הבאה ומחפשים את connectionPoolConfig:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION_ID: מזהה האזור של האשכול.
‫CLUSTER_ID: מזהה האשכול. הוא חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
‫INSTANCE_ID: מזהה המכונה.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

השבתת מאגר החיבורים המנוהל במכונה קיימת

אתם יכולים להשבית את מאגר החיבורים המנוהל במכונה קיימת באמצעות מסוףGoogle Cloud ,‏ Google Cloud CLI או AlloyDB API.

המסוף

נכנסים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה Resource Name.
בדף Overview, עוברים לקטע Instances in your cluster.
לוחצים על Edit instance או על Edit read pool במכונה שבה רוצים להשבית את מאגר החיבורים המנוהל.
בקטע Managed connection pool, מבטלים את הסימון של התיבה Enable managed connection pool.
לוחצים על Update instance.

הערה: אחרי שמשביתים את מאגר החיבורים המנוהל, כל החיבורים שנוצרו למאגר החיבורים המנוהל נמחקים.

gcloud

כדי להשבית את מאגר החיבורים המנוהל במכונה קיימת, משתמשים בפקודה הבאה של gcloud alloydb instances update:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

מחליפים את מה שכתוב בשדות הבאים:

‫INSTANCE_ID: השם של מכונת AlloyDB שבה רוצים להשבית את מאגר החיבורים המנוהל.
‫PROJECT_ID: מזהה הפרויקט
‫REGION_ID: מזהה האזור.
‫CLUSTER_ID: מזהה האשכול.

REST

כדי להשבית את מאגר החיבורים המנוהל במכונה קיימת, משתמשים בפקודה הבאה ומגדירים את connectionPoolConfig.enabled לערך false:

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט
‫LOCATION_ID: מזהה האזור של האשכול.
‫CLUSTER_ID: מזהה האשכול. הוא חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
‫INSTANCE_ID: מזהה המכונה.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "connectionPoolConfig": {
    "enabled": false
  }
}

מעקב אחרי מאגר החיבורים המנוהלים

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

שם המדד	תיאור
מספר מאגרי החיבורים `/database/conn_pool/num_pools`	המספר הכולל של מאגרי החיבורים לכל מסד נתונים.
חיבורי לקוחות `/database/conn_pool/client_connections`	מעקב אחרי מספר החיבורים של הלקוחות, מקובצים לפי הסטטוס של החיבור של הלקוח לכל מסד נתונים. הסטטוסים שכלולים במדד הזה הם: ‫`active`: מספר החיבורים הפעילים לכל מסד נתונים, כולל לקוחות לא פעילים שאין להם בקשות שאילתה בהמתנה. ‫`waiting`: מספר הלקוחות שממתינים לחיבור לשרת בכל מסד נתונים.
חיבורים לשרת `/database/conn_pool/server_connections`	מעקב אחרי מספר החיבורים לשרת, מקובצים לפי סטטוס החיבור לשרת לכל מסד נתונים. הסטטוסים שכלולים במדד הזה הם: ‫`active`: מספר החיבורים הפעילים לכל מסד נתונים. ‫`idle`: מספר החיבורים לשרת במצב חוסר פעילות לכל מסד נתונים.
זמן המתנה ממוצע `/database/conn_pool/client_connections_avg_wait_time`	הזמן הממוצע שכל הלקוחות ממתינים לשרת, במיקרו-שניות לכל מסד נתונים.

מידע נוסף זמין במאמר מדדים של AlloyDB.

מגבלות

המגבלות הבאות חלות:

אם אתם משתמשים במאגר חיבורים מנוהל במצב של מאגר טרנזקציות, התכונות הבאות של SQL לא נתמכות:
- SET/RESET
- LISTEN
- WITH HOLD CURSOR
- PREPARE/DEALLOCATE
- ‫PRESERVE/DELETE ROW טבלאות זמניות
- LOAD
- נעילות ייעוץ ברמת הסשן
- תוכניות מוכנות ברמת הפרוטוקול
אי אפשר להשתמש במאגר חיבורים מנוהל בחיבורים של כתובות IP ציבוריות.
אין תמיכה בחיבורים של משתמשים עם התפקיד PostgreSQL REPLICATION.

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

לפני שמתחילים

התפקידים הנדרשים

אפשרויות הגדרה מתקדמות

הפעלת מאגר חיבורים מנוהל

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

הפעלה במכונה חדשה של מאגר קריאה

הפעלה במכונה קיימת

המסוף

gcloud

REST

התחברות למאגר חיבורים מנוהל

התחברות באמצעות אימות מובנה

התחברות באמצעות חיבורי SSL

התחברות באמצעות אימות IAM

הצגת נתונים סטטיסטיים על מאגרי חיבורים מנוהלים

שינוי של מאגר החיבורים המנוהל של מכונה

המסוף

gcloud

REST

איך בודקים את הסטטוס של מאגר החיבורים המנוהל במכונה

המסוף

gcloud

REST

השבתת מאגר החיבורים המנוהל במכונה קיימת

המסוף

gcloud

REST

מעקב אחרי מאגר החיבורים המנוהלים

מגבלות

הגדרת ניהול של מאגר חיבורים