בדף הזה מוסבר איך להפעיל, להגדיר ולנטר את מאגר החיבורים המנוהל במכונות Cloud SQL.
התכונה "מאגר מנוהל של חיבורים" מאפשרת לשנות את קנה המידה של עומסי העבודה, באמצעות אופטימיזציה של ניצול המשאבים וזמן האחזור של החיבור למכונות באמצעות מאגר. למידע מפורט על מאגר החיבורים המנוהל ואיך להשתמש בו במכונות, קראו את הסקירה הכללית על מאגר החיבורים המנוהל.
לפני שמתחילים
- מוודאים שהמכונה עומדת בכל הדרישות לשימוש במאגר מנוהל של חיבורים.
- אם אתם משתמשים ב-CLI של gcloud, ודאו שגרסת ה-CLI של gcloud היא
515.0.0ואילך. - מוודאים שהמכונה משתמשת בארכיטקטורת הרשת החדשה של Cloud SQL. אם המכונה עדיין משתמשת בארכיטקטורת הרשת הישנה, שדרגו לארכיטקטורת הרשת החדשה.
- מוודאים שבמכונה יש את חיבורי השרת הנדרשים לכל vCPU שהוקצה בדגל
max_connectionsבהגדרות של מסד הנתונים. מידע נוסף זמין במאמר חיבורי שרתים שמשמשים לניהול מאגר החיבורים.
הפעלת מאגר חיבורים מנוהל
אפשר להפעיל את מאגר החיבורים המנוהל למכונה בזמן היצירה, או לערוך מכונה קיימת כדי להפעיל אותו.
הפעלת מאגר חיבורים מנוהל במכונה חדשה
כדי ליצור מכונה חדשה עם מאגר חיבורים מנוהל, קראו את המאמר יצירת מכונות. אפשר להפעיל את מאגר החיבורים המנוהל במכונה חדשה רק באמצעות ה-CLI של gcloud או Cloud SQL API.
הפעלת מאגר חיבורים מנוהל במכונה קיימת
כדי להפעיל את מאגר החיבורים המנוהל במכונה קיימת:
המסוף
נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .
מאתרים את המכונה שרוצים להפעיל בה את מאגר החיבורים המנוהל. כדי לפתוח את דף הסקירה הכללית של המכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance, מרחיבים את Connections.
כדי להפעיל את Managed Connection Pooling, מסמנים את התיבה Enable Managed Connection Pool.
לוחצים על Save.
gcloud
משתמשים בפקודה gcloud sql instances כדי להפעיל את מאגר החיבורים המנוהל.
gcloud sql instances patch INSTANCE_NAME \
--enable-connection-pooling
מחליפים את מה שכתוב בשדות הבאים:
-
INSTANCE_NAME: השם של המכונה ב-Cloud SQL.
REST v1
משתמשים בפקודה הבאה ומגדירים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": true
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
משתמשים בפקודה הבאה ומגדירים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": true
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
משתמשים במשאב הבא של Terraform:
שינוי של מאגר החיבורים המנוהל של מכונה
אחרי שמפעילים את Managed Connection Pooling, אפשר להתאים אישית את Managed Connection Pooling בהתאם לצורכי המכונה באמצעות אפשרויות הגדרה מתקדמות. אפשרויות ההגדרה האלה נקראות דגלי מאגר של Managed Connection Pooling. ההגדרות שנוספות לניהול מאגר החיבורים חלות על כל מאגר חיבורים שמשמש את המכונה. מאגר חיבורים הוא שירות proxy של מסד נתונים שמנהל מאגרי חיבורים בין אפליקציות לקוח לבין שרת מסד הנתונים. מכיוון שמספר מאגרי החיבורים ב-Cloud SQL משתנה בהתאם לגודל המכונה (מאגר חיבורים אחד לכל 4 מעבדי vCPU, עם מינימום של מאגר חיבורים אחד), צריך לקבוע את ערכי ההגדרות בהתאם לגודל המכונה ולדרישות של גודל המאגר. במאמר אפשרויות הגדרה מתקדמות מפורט מידע נוסף על אפשרויות ההגדרה המתקדמות, ערכי ברירת המחדל והטווחים שלהן.
כדי לשנות את אפשרויות ההגדרה המתקדמות של Managed Connection Pooling במכונה:
המסוף
נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .
מאתרים את המכונה שרוצים להפעיל בה את מאגר החיבורים המנוהל. כדי לפתוח את דף הסקירה הכללית של המכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance, מרחיבים את Connections.
בקטע Managed connection pool, מרחיבים את Advanced pooling options.
משנים את האפשרויות המתקדמות של מאגר הזיכרון שרוצים לעדכן.
לוחצים על Save.
gcloud
משתמשים בפקודה gcloud sql instances כדי לשנות את אפשרויות ההגדרה.
gcloud sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
מחליפים את מה שכתוב בשדות הבאים:
-
INSTANCE_NAME: השם של המכונה ב-Cloud SQL. -
CONFIGURATION_NAME: השם של אפשרות ההגדרה. רשימה של כל אפשרויות ההגדרה המתקדמות מופיעה במאמר אפשרויות הגדרה מתקדמות. -
CONFIGURATION_VALUE: הערך החדש של אפשרות ההגדרה שנבחרה.
REST v1
כדי לשנות את ההגדרות המתקדמות של Managed Connection Pooling, משתמשים בפקודה הבאה ומגדירים את ConnectionPoolConfig:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"flags":
[
{
"name": "CONFIGURATION_NAME",
"value":"CONFIGURATION_VALUE"
}
]
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
כדי לשנות את ההגדרות המתקדמות של Managed Connection Pooling, משתמשים בפקודה הבאה ומגדירים את ConnectionPoolConfig:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"flags":
[
{
"name": "CONFIGURATION_NAME",
"value":"CONFIGURATION_VALUE"
}
]
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
כדי לשנות את ההגדרות המתקדמות של מאגר החיבורים המנוהל, משתמשים במשאב Terraform הבא:
השבתת מאגר החיבורים המנוהל במכונה
אפשר להשבית את מאגר החיבורים המנוהל במכונה קיימת באמצעותCloud de Confiance המסוף, ה-CLI של gcloud או Cloud SQL API.
כדי להשבית את מאגר החיבורים המנוהל במכונה:
המסוף
נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .
מוצאים את המכונה שרוצים להשבית בה את מאגר החיבורים המנוהל. כדי לפתוח את דף הסקירה הכללית של המכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Customize your instance, מרחיבים את Connections.
כדי להשבית את Managed Connection Pooling, מבטלים את הסימון בתיבה Enable Managed Connection Pool.
לוחצים על Save.
gcloud
משתמשים בפקודה gcloud sql instances כדי להשבית את מאגר החיבורים המנוהל.
gcloud sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: השם של המכונה ב-Cloud SQL.
REST v1
כדי להשבית את מאגר החיבורים המנוהל במכונה, משתמשים בפקודה הבאה ומגדירים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": false
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
כדי להשבית את מאגר החיבורים המנוהל במכונה, משתמשים בפקודה הבאה ומגדירים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט
- INSTANCE_ID: מזהה המכונה
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
תוכן בקשת JSON:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": false
}
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
כדי להשבית את מאגר החיבורים המנוהל במכונה, משתמשים במשאב Terraform הבא:
הצגת הסטטוס של מאגר החיבורים המנוהל של מכונה
אתם יכולים לראות את הסטטוס של מאגר החיבורים המנוהל של מכונה באמצעות מסוף Cloud de Confiance , ה-CLI של gcloud או Cloud SQL API.
כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה של מהדורת Cloud SQL Enterprise Plus:
המסוף
נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .
מאתרים את המכונה שרוצים לבדוק את סטטוס מאגר החיבורים המנוהל שלה. כדי לפתוח את דף הסקירה הכללית של המכונה, לוחצים על שם המכונה.
בקטע Connections אפשר לראות אם המאגר המנוהל של החיבורים מופעל או מושבת.
gcloud
כדי לראות את הסטטוס של מאגר החיבורים המנוהל של מכונה, משתמשים בפקודה gcloud sql instances describe:
gcloud sql instances describe INSTANCE_NAME \
--format="value(settings.connectionPoolConfig.connectionPoolingEnabled)"
מחליפים את מה שכתוב בשדות הבאים:
PROJECT_ID: השם של המכונה ב-Cloud SQL.אם האפשרות Managed Connection Pooling מופעלת, מתקבלת התגובה הבאה:
connectionPoolingEnabled: true
REST v1
כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה של Cloud SQL, משתמשים בפקודה הבאה ומחפשים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: המזהה או מספר הפרויקט ב- Cloud de Confiance שמכיל את המכונה.
- INSTANCE_NAME: השם של המכונה ב-Cloud SQL. אם במכונה הזו מופעל Private Service Connect, נקודות קצה של Private Service Connect ברשתות VPC יכולות להתחבר אליה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
REST v1beta4
כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה של Cloud SQL, משתמשים בפקודה הבאה ומחפשים את connectionPoolingEnabled:
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: המזהה או מספר הפרויקט ב- Cloud de Confiance שמכיל את המכונה.
- INSTANCE_NAME: השם של המכונה ב-Cloud SQL. אם במכונה הזו מופעל Private Service Connect, נקודות קצה של Private Service Connect ברשתות VPC יכולות להתחבר אליה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
מעקב אחרי מאגר החיבורים המנוהלים
אתם יכולים לעקוב אחרי האופן שבו מאגר החיבורים המנוהל פועל במכונות של Cloud SQL, באמצעות המדדים הבאים של מאגר החיבורים המנוהל של Cloud SQL:
| שם המדד | תיאור |
|---|---|
| client_connections | מעקב אחרי מספר החיבורים לפי הסטטוס של חיבור הלקוח. הסטטוסים שנכללים במדד הזה הם:
|
| client_connections_attempts_count | מספר הניסיונות של לקוחות להתחבר שהתקבלו בכל מאגר חיבורים. |
| client_connections_avg_wait_time | הזמן הממוצע שכל הלקוחות ממתינים לשרת. |
| client_connections_error_count | מספר השגיאות בכל מאגר חיבורים שגורמות לניתוק הלקוח, כולל שגיאות אימות, שגיאות בהגדרת החיבור של הלקוח ושגיאות בחיבור לשרת. |
| num_pools | המספר הכולל של מאגרי החיבורים לכל מסד נתונים. |
| server_connections | מעקב אחרי מספר החיבורים לשרת לפי סטטוס החיבור לשרת. הסטטוסים שנכללים במדד הזה
הם:
|
למידע נוסף על המדדים האלה, ראו מדדי Cloud SQL. כדי לראות את המדדים האלה במסוף Cloud de Confiance , עיינו במאמר הצגת מדדים בדף הסקירה הכללית של מכונות Cloud SQL.