יצירה וניהול של מאגרי קריאה

בדף הזה מוסבר איך ליצור ולנהל מאגרי קריאה לעומסי עבודה גדולים של קריאה.

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

  1. מאגרי קריאה מכילים עותקים של מופע ראשי. אם עדיין לא עשיתם את זה, צרו מופע ראשי של Cloud SQL Enterprise Plus. מאגרי קריאה תומכים בקישוריות של כתובות IP ציבוריות, אבל לצורך המדריך הזה, צריך ליצור מכונה ראשית עם קישוריות של כתובת IP פרטית (PSA). מידע נוסף על מכונות ראשיות ועל רפליקציה זמין במאמר מידע על רפליקציה ב-Cloud SQL.
  2. אחרי שיוצרים את המכונה הראשית, בוחרים סיסמה למשתמש Root ומריצים את הפקודה הבאה כדי להגדיר את הסיסמה במכונה הראשית. שומרים את הסיסמה הזו כדי להשתמש בה בהמשך כשמתחברים למאגר הקריאה.
    3. ‫
        gcloud --project=PROJECT \
    sql users set-password root --host=% \
    --instance=PRIMARY_INSTANCE_NAME --prompt-for-password

    מחליפים את הפרטים הבאים:

    • ‫PROJECT: שם הפרויקט שבו רוצים שהמופע הראשי ומאגר הקריאה יהיו.
    • ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.

יצירת מאגר קריאה

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances create הבאה כדי ליצור מאגר קריאה עם כמה צמתים של מאגר קריאה:

      gcloud sql instances create READ_POOL_NAME \
      --tier=TIER --edition=ENTERPRISE_PLUS \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT \
      --master-instance-name=PRIMARY_INSTANCE_NAME

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: השם שרוצים להשתמש בו למאגר הקריאה.
  • ‫TIER: סוג המכונה שרוצים להשתמש בה לכל צומת במאגר הקריאה, כמו db-perf-optimized-N-4.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.
  • ‫PRIMARY_INSTANCE_NAME: השם של המופע הראשי שמשויך למאגר הקריאה, למשל my-primary-instance.

Terraform

כדי ליצור מאגר קריאה, משתמשים במשאב של Terraform. אחר כך מגדירים את מאפיין instance_type לערך "READ_POOL_INSTANCE" ואת מאפיין node_count למספר הצמתים שרוצים להשתמש בהם.

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


resource "google_sql_database_instance" "primary" {
  name             = "postgres-primary"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  instance_type = "CLOUD_SQL_INSTANCE"

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    backup_configuration {
      enabled = true
    }

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

resource "google_sql_database_instance" "replica" {
  name             = "postgres-replica"
  database_version = "POSTGRES_17"
  region           = "europe-west4"

  master_instance_name = google_sql_database_instance.primary.name
  instance_type        = "READ_POOL_INSTANCE"
  node_count           = 2

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"

    ip_configuration {
      ipv4_enabled = true
    }
  }
}

החלה של השינויים

כדי להחיל את ההגדרות של Terraform בפרויקט ב- Google Cloud , מבצעים את השלבים בקטעים הבאים.

הכנת Cloud Shell

  1. מפעילים את Cloud Shell.

  2. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Google Cloud

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

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

  1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. אם אתם עוקבים אחרי המדריך, תוכלו להעתיק את הקוד לדוגמה בכל קטע או שלב.

    מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

    לחלופין, אפשר גם להעתיק את הקוד מ-GitHub. כדאי לעשות את זה כשקטע הקוד של Terraform הוא חלק מפתרון מקצה לקצה.

  3. בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
  4. שומרים את השינויים.
  5. מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה. 
    terraform init

    אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google: 

    terraform init -upgrade

החלה של השינויים

  1. בודקים את ההגדרות ומוודאים שהמשאבים שמערכת Terraform תיצור או תעדכן תואמים לציפיות שלכם: 
    terraform plan

    מתקנים את ההגדרות לפי הצורך.

  2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform: 
    terraform apply

    ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

  3. פותחים את Google Cloud הפרויקט כדי לראות את התוצאות. במסוף Google Cloud , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

מחיקת השינויים

כדי למחוק את השינויים:

  1. כדי להשבית את ההגנה מפני מחיקה, בקובץ התצורה של Terraform מגדירים את הארגומנט deletion_protection לערך false. 
    deletion_protection =  "false"
  2. מריצים את הפקודה הבאה ומזינים yes בהודעה שמופיעה, כדי להחיל את הגדרות Terraform המעודכנות: 
    terraform apply

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

    terraform destroy

REST v1

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

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

  • ‫PROJECT: שם הפרויקט שבו רוצים שהמופע הראשי ומאגר הקריאה יהיו.
  • ‫REGION: האזור של מאגר הקריאה, למשל us-east1. האזור צריך להיות זהה לזה של המופע הראשי.
  • ‫TIER: סוג המכונה שרוצים להשתמש בה לכל צומת במאגר הקריאה, למשל db-perf-optimized-N-4.
  • ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.
  • ‫READ_POOL_NAME: השם שרוצים להשתמש בו למאגר הקריאה, למשל my-read-pool.
  • ‫DATABASE_VERSION: גרסת מסד הנתונים שבה רוצים להשתמש. לדוגמה, POSTGRES_16.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.
  • ‫FULL_NETWORK_NAME: הנתיב המלא ברשת שבו רוצים למקם את מאגר הקריאה, כמו projects/vpc-host-project/global/networks/my-network-name.

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

POST https://sqladmin.googleapis.com/v1/projects/PROJECT/instances

תוכן בקשת JSON: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

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

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

  • ‫PROJECT: שם הפרויקט שבו רוצים שהמופע הראשי ומאגר הקריאה יהיו.
  • ‫REGION: האזור של מאגר הקריאה, למשל us-east1. האזור צריך להיות זהה לזה של המופע הראשי.
  • ‫TIER: סוג המכונה שרוצים להשתמש בה לכל צומת במאגר הקריאה, למשל db-perf-optimized-N-4.
  • ‫PRIMARY_INSTANCE_NAME: השם של המכונה הראשית.
  • ‫READ_POOL_NAME: השם שרוצים להשתמש בו למאגר הקריאה, למשל my-read-pool.
  • ‫DATABASE_VERSION: גרסת מסד הנתונים שבה רוצים להשתמש. לדוגמה, POSTGRES_16.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.
  • ‫FULL_NETWORK_NAME: הנתיב המלא ברשת שבו רוצים למקם את מאגר הקריאה, כמו projects/vpc-host-project/global/networks/my-network-name.

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

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances

תוכן בקשת JSON: 

{
  "name": "READ_POOL_NAME",
  "masterInstanceName": "PRIMARY_INSTANCE_NAME",
  "project": "PROJECT",
  "databaseVersion": "DATABASE_VERSION",
  "region": "REGION",
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT,
  "settings": {
    "tier": "TIER",
    "edition": "ENTERPRISE_PLUS",
    "ipConfiguration": {
      "ipv4Enabled": false,
      "privateNetwork": "FULL_NETWORK_NAME"
    }
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

המרת עותק לקריאה בלבד למאגר לקריאה בלבד

כדי להמיר רפליקה לקריאה במהדורת Cloud SQL Enterprise Plus קיימת למאגר קריאה, צריך לציין את מספר הצמתים במאגר. במהלך תהליך ההמרה הזה, כתובת ה-IP של הרפליקה תהפוך לכתובת ה-IP של מאגר הקריאה (נקודת הקצה של הקריאה), כך שלקוחות קיימים יוכלו להתחבר למאגר בלי לבצע הגדרה מחדש.

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

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

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances patch הבאה כדי להמיר רפליקה לקריאה לשימוש במאגר לקריאה:

      gcloud sql instances patch READ_REPLICA_NAME \
      --instance-type=READ_POOL_INSTANCE --node-count=NODE_COUNT

מחליפים את הפרטים הבאים:

  • ‫READ_REPLICA_NAME: השם של העותק לקריאה שרוצים להמיר.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

Terraform

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

  • משנים את מאפיין instance_type מ- "READ_REPLICA_INSTANCE" ל-"READ_POOL_INSTANCE" ואת מאפיין node_count למספר הצמתים שרוצים להשתמש בהם.
  • אם הגדרתם אותו בעבר, צריך למחוק את המאפיין settings.availability_type.

REST v1

כדי להמיר רפליקה לקריאה למאגר לקריאה, משתמשים בשיטה patch של משאב המופעים.

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

  • ‫READ_REPLICA_NAME: השם של העותק לקריאה שרוצים להמיר, למשל my-read-replica.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_REPLICA_NAME

תוכן בקשת JSON: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

כדי להמיר רפליקה לקריאה למאגר לקריאה, משתמשים בשיטה patch של משאב המופעים.

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

  • ‫READ_REPLICA_NAME: השם של העותק לקריאה שרוצים להמיר, למשל my-read-replica.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_REPLICA_NAME

תוכן בקשת JSON: 

{
  "instanceType": "READ_POOL_INSTANCE",
  "nodeCount": NODE_COUNT
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

המרת מאגר קריאה לרפליקת קריאה

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances patch הבאה כדי להמיר רפליקה לקריאה לשימוש במאגר לקריאה:

      gcloud sql instances patch READ_POOL_NAME \
      --instance-type=READ_REPLICA_INSTANCE --availability-type=ZONAL

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: השם של מאגר הקריאה שרוצים להמיר.

Terraform

כדי להמיר מאגר קריאה לרפליקה לקריאה, צריך להשתמש במשאב של Terraform. קובץ המניפסט דומה לזה שבו השתמשתם במאמר יצירת בריכת קריאה. לאחר מכן, משנים את מאפיין instance_type מ-"READ_POOL_INSTANCE" ל-"READ_REPLICA_INSTANCE", מוחקים את מאפיין node_count ומגדירים את מאפיין settings.availability_type ל-ZONAL.

REST v1

כדי להמיר מאגר קריאה לרפליקה לקריאה, משתמשים בשיטה patch של משאב המופעים.

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

  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

כדי להמיר מאגר קריאה לרפליקה לקריאה, משתמשים בשיטה patch של משאב המופעים.

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

  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "instanceType": "READ_REPLICA_INSTANCE",
  "settings": {
    "availabilityType": "ZONAL"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

הצגת מידע על מאגר הקריאה

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances describe הבאה כדי לתאר את מאגר הקריאה:

      gcloud sql instances describe READ_POOL_NAME

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: שם מאגר הקריאה שרוצים לתאר.

דוגמה לתגובה עם כתובת IP ופרטי צומת:

      ...
      connectionName: my-project:us-central1:read-pool
      ipAddresses:
      - ipAddress: 10.3.0.108
        type: PRIVATE
      nodeCount: 2
      nodes:
      - dnsName: c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-f
        ipAddresses:
        - ipAddress: 10.3.0.112
          type: PRIVATE
        name: read-pool-node-01
        state: RUNNABLE
      - dnsName: 8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.
        gceZone: us-central1-c
        ipAddresses:
        - ipAddress: 10.3.0.113
          type: PRIVATE
        name: read-pool-node-02
        state: RUNNABLE

REST v1

משתמשים בשיטה get כדי להציג את הפרטים של מאגר הקריאה.

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

GET https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

משתמשים בשיטה get כדי להציג את הפרטים של מאגר הקריאה.

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  [...],
  "connectionName": "my-project:us-central1:read-pool",
  "ipAddresses": [
    {
      "type": "PRIVATE",
      "ipAddress": "10.3.0.108"
    }
  ],
  "nodeCount": 2,
  "nodes": [
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.112"
        }
      ],                                                                                                                 
      "name": "read-pool-node-01",
      "gceZone": "us-central1-f",
      "dnsName": "c5bdacb09ffc.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    },
    {
      "ipAddresses": [
        {
          "type": "PRIVATE",
          "ipAddress": "10.3.0.113"
        }
      ],
      "name": "read-pool-node-02",
      "gceZone": "us-central1-c",
      "dnsName": "8f77c454d6b2.j10o8yqc7pve.us-central1.sql.goog.",
      "state": "RUNNABLE"
    }
  ]
}

הוספה או הסרה של צמתים במאגר לקריאה

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

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances patch הבאה כדי לשנות את גודל מאגר הקריאה:

      gcloud sql instances patch READ_POOL_NAME \
      --node-count=NODE_COUNT

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: שם מאגר הקריאה.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

Terraform

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

REST v1

כדי להגדיל או להקטין את מספר הצמתים במאגר הקריאה, משתמשים בשיטה patch.

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "nodeCount": NODE_COUNT
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

כדי להגדיל או להקטין את מספר הצמתים במאגר הקריאה, משתמשים בשיטה patch.

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫NODE_COUNT: מספר הצמתים במאגר הקריאה שרוצים להגדיר. בוחרים מספר כלשהו מ-1 עד 20.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "nodeCount": NODE_COUNT
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

עריכה של הגדרות מאגר הקריאה

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

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances patch הבאה כדי לשנות את גודל מאגר הקריאה באופן אנכי, למשל על ידי שינוי סוג המכונה:

      gcloud sql instances patch READ_POOL_NAME \
      --tier=TIER

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: שם מאגר הקריאה.
  • ‫TIER: סוג המכונה שרוצים להחיל על כל צומת במאגר הקריאה, למשל db-perf-optimized-N-8.

Terraform

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

REST v1

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

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫TIER: סוג המכונה שרוצים להשתמש בה לכל צומת במאגר הקריאה, למשל db-perf-optimized-N-4.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "settings": {
    "tier": "TIER"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

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

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫TIER: סוג המכונה שרוצים להשתמש בה לכל צומת במאגר הקריאה, למשל db-perf-optimized-N-4.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

תוכן בקשת JSON: 

{
  "settings": {
    "tier": "TIER"
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

חיבור למאגר קריאה

יש הרבה דרכים להתחבר למאגר קריאה. בשלבים הבאים מוצגת דרך אחת להתחבר למאגר לקריאה באמצעות כתובת IP פרטית. הדרך הזו היא ליצור VM באותה רשת VPC שתשמש כמקור החיבור.

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

אם אתם מתחברים באמצעות שרת proxy ל-Cloud SQL Auth או Cloud SQL Connectors, הקפידו לעדכן לגרסה העדכנית. כדי לקבל תמיכה במאגר קריאה, הגרסאות המינימליות הנדרשות כוללות את הגרסאות הבאות:

  • שרת proxy ל-Cloud SQL Auth: ‏ v2.15.2
  • Cloud SQL Python Connector: v1.18.0
  • ‫Cloud SQL Go Connector: גרסה 1.16.0
  • Cloud SQL Node Connector: v1.7.0
  • Cloud SQL Java Connector: v1.24.0

המסוף

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

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

    כניסה לדף Cloud SQL Instances

    תועברו לדף הסקירה הכללית של המופע. לוחצים על מאגר הקריאה החדש כדי לראות את הפרטים, כולל כתובת ה-IP הפרטית שלו. בקטע Connect to this instance (התחברות למופע הזה), מעתיקים ושומרים את Connection name (שם החיבור) של המופע. הערך connection name הוא בפורמט projectID:region:instanceID. תשתמשו בערך הזה connection name בהמשך, כשמפעילים את שרת ה-proxy ל-Cloud SQL Auth.
  2. יוצרים מכונה וירטואלית ב-Compute Engine.
  3. פותחים שני חיבורי SSH למכונה הווירטואלית של Compute Engine. הם משמשים בשלבים הבאים להפעלת שרת proxy ל-Cloud SQL Auth ולהפעלת לקוח מסד הנתונים.
  4. מתקינים את הלקוח.
  5. מתקינים את שרת ה-proxy ל-Cloud SQL Auth.
  6. מפעילים את שרת ה-proxy ל-Cloud SQL Auth.
  7. מתחברים למכונה של Cloud SQL.

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

מחיקת מאגר קריאה

gcloud

במאמר התקנת ה-CLI של gcloud מוסבר איך להתקין את ה-CLI של gcloud ולהתחיל להשתמש בו. מידע על הפעלת Cloud Shell זמין במאמר בנושא שימוש ב-Cloud Shell.

משתמשים בפקודה gcloud sql instances delete הבאה כדי למחוק מאגר לקריאה:

      gcloud sql instances delete READ_POOL_NAME

מחליפים את הפרטים הבאים:

  • ‫READ_POOL_NAME: השם של מאגר הקריאה שרוצים למחוק.

REST v1

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

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT/instances/READ_POOL_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

REST v1beta4

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

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

  • ‫PROJECT: שם הפרויקט שבו נמצא מאגר הקריאה.
  • ‫READ_POOL_NAME: השם של מאגר הקריאה, למשל my-read-pool.

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

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT/instances/READ_POOL_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

אתם אמורים לקבל תגובת JSON שדומה לזו:

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