שדרוג מופע למהדורת Cloud SQL Enterprise Plus באמצעות שדרוג במקום

‫MySQL | PostgreSQL | SQL Server

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

שדרוג למהדורת Cloud SQL Enterprise Plus מספק לכם כמה יתרונות ושיפורים בביצועים. מידע נוסף זמין במאמר מבוא למהדורות של Cloud SQL ל-PostgreSQL.

כדי להפעיל את השיפורים האלה במכונות הקיימות של Cloud SQL Enterprise Edition, צריך לשדרג אותן ל-Cloud SQL Enterprise Plus Edition. תהליך השדרוג נמשך כמה דקות, וההשבתה שלו היא כמעט אפס. המעבר למהדורת Enterprise של Cloud SQL יכול לגרום להשבתה של עד 60 שניות.

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

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

מוודאים שמריצים מכונת Cloud SQL במהדורת Enterprise ב-PostgreSQL 12 ואילך.

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

בדיקת מיקום האחסון של יומני העסקאות שמשמשים לשחזור לנקודת זמן

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

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

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

שדרוג מכונה למהדורת Cloud SQL Enterprise Plus

כדי לשדרג מופע של מהדורת Cloud SQL Enterprise למהדורת Cloud SQL Enterprise Plus, צריך לפעול לפי השלבים שמתוארים בקטע הזה.

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Choose a Cloud SQL edition, לוחצים על Upgrade.
בחלונית שדרוג ל-Enterprise Plus, מזינים את מזהה המופע ולוחצים על שדרוג המהדורה.

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

gcloud

בדוגמת הקוד הבאה אפשר לראות איך משדרגים את המופע למהדורת Cloud SQL Enterprise Plus:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

אופציונלי: אפשר גם להפעיל מטמון נתונים עבור המופע על ידי הוספת הדגל --enable-data-cache.

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

‫PROJECT_ID: מזהה הפרויקט של המופע שרוצים לשדרג.
‫INSTANCE_ID: השם של המכונה שרוצים לשדרג.
‫MACHINE_TYPE: סוג המכונה של המופע שרוצים לשדרג אליו. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise Plus זמין במאמר סוגי מכונות למופעים של מהדורת Cloud SQL Enterprise Plus.

REST

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

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

‫PROJECT_ID: מזהה הפרויקט של המופע שרוצים לשדרג.
‫INSTANCE_ID: מזהה המכונה של המכונה שרוצים לשדרג.
‫MACHINE_TYPE: סוג המכונה של המופע שרוצים לשדרג אליו. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise Plus זמין במאמר סוגי מכונות למופעים של מהדורת Cloud SQL Enterprise Plus.

אופציונלי: אפשר להפעיל מטמון נתונים על ידי הגדרת הפרמטר dataCacheEnabled כ-true.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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

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

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

‫PROJECT_ID: מזהה הפרויקט של המופע שרוצים לשדרג.
‫INSTANCE_ID: מזהה המכונה של המכונה שרוצים לשדרג.
‫MACHINE_TYPE: סוג המכונה של המופע שרוצים לשדרג אליו. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise Plus זמין במאמר סוגי מכונות למופעים של מהדורת Cloud SQL Enterprise Plus.

אופציונלי: אפשר להפעיל מטמון נתונים על ידי הגדרת הפרמטר dataCacheEnabled כ-true.

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

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/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/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

מיקום האחסון של יומני העסקאות שמשמשים ל-PITR

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

התנאים הבאים חלים על תהליך העברת המיקום:

התהליך נמשך בערך כמו משך הזמן של הגדרת ה-PITR‏ transactionLogRetentionDays עד להשלמת המעבר ל-Cloud Storage.
במהלך המעבר ל-Cloud Storage, מומלץ לא לשנות את הגדרת התצורה של transactionLogRetentionDays PITR. גם אם תגדילו את transactionLogRetentionDays, יומני הרישום של פעולות הכתיבה לא יישמרו בדיסק יותר מ-7 ימים, שהוא ברירת המחדל למופע של Cloud SQL במהדורת Enterprise.

ברירות מחדל של אחסון גיבויים ויומנים ב-Cloud SQL Enterprise Plus

אחרי השדרוג למהדורת Cloud SQL Enterprise Plus, תקופת השמירה של יומן העסקאות שמוגדרת כברירת מחדל לכל המכונות המשודרגות תגדל ל-14 ימים. כדי להגדיל את חלון השמירה של PITR, צריך להגדיל את הערך של תקופת השמירה של יומן העסקאות. ההגדלה הזו, וכל הגדלה אחרת שתגדירו, תיכנס לתוקף רק אחרי שתקופת השמירה הקודמת תסתיים. לדוגמה, אם הערך הישן של ימי השמירה של יומן העסקאות הוא 7, והערך החדש הוגדל ל-14, אז חלון הזמן ל-PITR במשך 7 הימים הראשונים אחרי השדרוג הוא רק 7 ימים. ביום השמיני, חלון ה-PITR הופך ל-8 ימים, ביום התשיעי הוא הופך ל-9 ימים, עד שחלון השמירה גדל סופית ל-14 ימים ביום ה-14.

בנוסף, מספר הגיבויים האוטומטיים שמוגדר כברירת מחדל גדל מ-8 ל-15.

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

מעבר למהדורת Cloud SQL Enterprise

המסוף

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

כניסה לדף Cloud SQL Instances
כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
לוחצים על Edit.
בקטע Choose a Cloud SQL edition, לוחצים על Switch to Enterprise.
בחלונית מעבר ל-Enterprise, מזינים את מזהה המופע ולוחצים על החלפת מהדורה.

אפשרות נוספת היא לעבור למהדורת Cloud SQL Enterprise. לשם כך, לוחצים על Switch to Enterprise בקטע Configuration בדף Overview של המופע.

gcloud

בדוגמת הקוד הבאה אפשר לראות איך משנים את המופע למהדורת Cloud SQL Enterprise:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

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

‫PROJECT_ID: מזהה הפרויקט של המכונה.
‫INSTANCE_ID: שם המכונה.
‫MACHINE_TYPE: סוג המכונה של המופע שאליו רוצים לעבור. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise זמין במאמר סוגי מכונות למופעי Cloud SQL Enterprise.

REST

הפקודה הבאה משנה את המופע למהדורת Cloud SQL Enterprise ומפעילה פעולת הפעלה מחדש.

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

‫PROJECT_ID: מזהה הפרויקט של המכונה.
‫INSTANCE_ID: מזהה המכונה של המכונה.
‫MACHINE_TYPE: סוג המכונה של המופע שאליו רוצים לעבור. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise זמין במאמר סוגי מכונות למופעי Cloud SQL Enterprise.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

אתם אמורים לקבל תגובת 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

הפקודה הבאה משנה את המופע למהדורת Cloud SQL Enterprise ומפעילה פעולת הפעלה מחדש.

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

‫PROJECT_ID: מזהה הפרויקט של המכונה.
‫INSTANCE_ID: מזהה המכונה של המכונה.
‫MACHINE_TYPE: סוג המכונה של המופע שאליו רוצים לעבור. מידע נוסף על סוגי מכונות למהדורת Cloud SQL Enterprise זמין במאמר סוגי מכונות למופעי Cloud SQL Enterprise.

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

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

תוכן בקשת JSON:

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

‫Curl (Linux,‏ macOS או Cloud Shell)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

‎PowerShell (Windows)

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/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/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

ברירות המחדל של אחסון גיבויים ויומנים ב-Cloud SQL Enterprise edition

כשעוברים למהדורת Cloud SQL Enterprise, מיקום האחסון של יומני העסקאות שמשמשים ל-PITR לא משתנה. אם המכונה שלכם במהדורת Cloud SQL Enterprise Plus מאחסנת את יומני העסקאות שלה לשחזור לנקודת זמן ב-Cloud Storage, היומנים יישארו ב-Cloud Storage. עם זאת, במקום לשמור יומני עסקאות למשך 14 ימים עבור PITR כברירת מחדל, ברירת המחדל השתנתה ל-7 ימים. הגדרות הגיבוי לא משתנות.

יצירה אוטומטית של נקודת הקצה לכתיבה

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

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

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

מידע נוסף על מהדורת Cloud SQL Enterprise Plus

שדרוג מופע למהדורת Cloud SQL Enterprise Plus באמצעות שדרוג במקום קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

בדיקת מיקום האחסון של יומני העסקאות שמשמשים לשחזור לנקודת זמן

שדרוג מכונה למהדורת Cloud SQL Enterprise Plus

המסוף

gcloud

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

REST v1beta4

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

מיקום האחסון של יומני העסקאות שמשמשים ל-PITR

ברירות מחדל של אחסון גיבויים ויומנים ב-Cloud SQL Enterprise Plus

מעבר למהדורת Cloud SQL Enterprise

המסוף

gcloud

REST

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

REST v1beta4

‫Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

ברירות המחדל של אחסון גיבויים ויומנים ב-Cloud SQL Enterprise edition

יצירה אוטומטית של נקודת הקצה לכתיבה

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

שדרוג מופע למהדורת Cloud SQL Enterprise Plus באמצעות שדרוג במקום