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

בדף הזה מוסבר איך להפעיל, להגדיר ולנטר את מאגר החיבורים המנוהל במכונות Cloud SQL.

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

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

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

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

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

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

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

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

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

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

  3. לוחצים על Edit.

  4. בקטע Customize your instance, מרחיבים את Connections.

  5. כדי להפעיל את Managed Connection Pooling, מסמנים את התיבה Enable Managed Connection Pool.

  6. לוחצים על 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:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_enable" {
  name                = "postgres-instance-managed-connection-pooling-enable"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true # Set to true here
    }
  }
}

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

אחרי שמפעילים את Managed Connection Pooling, אפשר להתאים אישית את Managed Connection Pooling בהתאם לצורכי המכונה באמצעות אפשרויות הגדרה מתקדמות. אפשרויות ההגדרה האלה נקראות דגלי מאגר של Managed Connection Pooling. ההגדרות שנוספות לניהול מאגר החיבורים חלות על כל מאגר חיבורים שמשמש את המכונה. מאגר חיבורים הוא שירות proxy של מסד נתונים שמנהל מאגרי חיבורים בין אפליקציות לקוח לבין שרת מסד הנתונים. מכיוון שמספר מאגרי החיבורים ב-Cloud SQL משתנה בהתאם לגודל המכונה (מאגר חיבורים אחד לכל 4 מעבדי vCPU, עם מינימום של מאגר חיבורים אחד), צריך לקבוע את ערכי ההגדרות בהתאם לגודל המכונה ולדרישות של גודל המאגר. במאמר אפשרויות הגדרה מתקדמות מפורט מידע נוסף על אפשרויות ההגדרה המתקדמות, ערכי ברירת המחדל והטווחים שלהן.

כדי לשנות את אפשרויות ההגדרה המתקדמות של Managed Connection Pooling במכונה:

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

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

  3. לוחצים על Edit.

  4. בקטע Customize your instance, מרחיבים את Connections.

  5. בקטע Managed connection pool, מרחיבים את Advanced pooling options.

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

  6. לוחצים על 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 הבא:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_modify" {
  name                = "postgres-instance-managed-connection-pooling-modify"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true
      flags {
        name  = "max_pool_size" # Modify the value of an existing flag
        value = "10"
      }
    }
  }
}

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

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

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

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

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

  3. לוחצים על Edit.

  4. בקטע Customize your instance, מרחיבים את Connections.

  5. כדי להשבית את Managed Connection Pooling, מבטלים את הסימון בתיבה Enable Managed Connection Pool.

  6. לוחצים על 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 הבא:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_disable" {
  name                = "postgres-instance-managed-connection-pooling-disable"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      # Set to false to disable Managed Connection Pooling. You can also remove the block entirely.
      connection_pooling_enabled = false
    }
  }
}

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

אתם יכולים לראות את הסטטוס של מאגר החיבורים המנוהל של מכונה באמצעות מסוף Cloud de Confiance , ה-CLI של gcloud או Cloud SQL API.

כדי לראות את הסטטוס של מאגר החיבורים המנוהל במכונה של מהדורת Cloud SQL Enterprise Plus:

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Cloud de Confiance .

    כניסה לדף Cloud SQL Instances

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

    בקטע 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:

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

ה-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:

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

ה-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 מעקב אחרי מספר החיבורים לפי הסטטוס של חיבור הלקוח. הסטטוסים שנכללים במדד הזה הם:
  • ‫active: מספר החיבורים הפעילים לכל מסד נתונים, כולל לקוחות לא פעילים שאין להם בקשות שאילתה בהמתנה.
  • ‫waiting: מספר הלקוחות שממתינים לחיבור לשרת בכל מסד נתונים.
client_connections_attempts_count מספר הניסיונות של לקוחות להתחבר שהתקבלו בכל מאגר חיבורים.
client_connections_avg_wait_time הזמן הממוצע שכל הלקוחות ממתינים לשרת.
client_connections_error_count מספר השגיאות בכל מאגר חיבורים שגורמות לניתוק הלקוח, כולל שגיאות אימות, שגיאות בהגדרת החיבור של הלקוח ושגיאות בחיבור לשרת.
num_pools המספר הכולל של מאגרי החיבורים לכל מסד נתונים.
server_connections מעקב אחרי מספר החיבורים לשרת לפי סטטוס החיבור לשרת. הסטטוסים שנכללים במדד הזה הם:
  • ‫active: מספר החיבורים הפעילים לכל מסד נתונים.
  • ‫waiting: מספר החיבורים לשרת במצב חוסר פעילות לכל מסד נתונים.

למידע נוסף על המדדים האלה, ראו מדדי Cloud SQL. כדי לראות את המדדים האלה במסוף Cloud de Confiance , עיינו במאמר הצגת מדדים בדף הסקירה הכללית של מכונות Cloud SQL.

המאמרים הבאים