Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

ניהול מאגר חיבורים תומך גם בחיבורים עם AlloyDB Auth Proxy או AlloyDB Language Connectors.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הפעלה במופע קיים

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

המסוף

עוברים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה שם המשאב.
בדף Overview (סקירה כללית), עוברים אל Instances in your cluster (מופעים באשכול).
לוחצים על עריכת המאגר הראשי או על עריכת מאגר הקריאה.
בקטע Managed connection pool (מאגר חיבורים מנוהל), מסמנים את התיבה Enable managed connection pool (הפעלת מאגר חיבורים מנוהל).
אופציונלי: כדי להגדיר אפשרויות של מאגר חיבורים מנוהל, לוחצים על אפשרויות מתקדמות של מאגרים.

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

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 Language Connectors.

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

כשמפעילים את התכונה 'ניהול מאגר חיבורים' במופע 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.
הערה: אפשר להגיע למסד הנתונים של מסוף הסטטיסטיקות של מאגר שרת ה-Proxy לאימות רק באמצעות חיבור באמצעות לקוח שרת ה-Proxy לאימות של AlloyDB.
```
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
לוחצים על אשכול בעמודה שם המשאב.
בדף Overview (סקירה כללית), עוברים אל Instances in your cluster (מופעים באשכול).
לוחצים על עריכת מופע או על עריכת מאגר לקריאה עבור המופע שרוצים לשנות.
בקטע 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 \
    { \
      --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

ה-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_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

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

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

המסוף

עוברים לדף Clusters.

כניסה לדף Clusters
לוחצים על אשכול בעמודה שם המשאב.
בדף סקירה כללית, מחפשים את המופע שרוצים לראות את הסטטוס של ניהול מאגר חיבורים. בשדה 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
לוחצים על אשכול בעמודה שם המשאב.
בדף Overview (סקירה כללית), עוברים אל Instances in your cluster (מופעים באשכול).
לוחצים על עריכת מופע או על עריכת מאגר קריאה עבור המופע שרוצים להשבית בו את החיבור לניהול מאגרים.
בקטע Managed connection pool, מבטלים את הסימון בתיבה Enable managed connection pool.
לוחצים על עדכון המופע.

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

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 לערך 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 ציבוריות.

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

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

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

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

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

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

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

הפעלה במופע קיים

המסוף

gcloud

REST

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

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

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

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

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

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

המסוף

gcloud

REST

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

המסוף

gcloud

REST

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

המסוף

gcloud

REST

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

מגבלות

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