הגדרת דגלים של מסד נתונים במופע

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

משתמשים בדגלים של מסד הנתונים להרבה פעולות, כולל התאמת פרמטרים של PostgreSQL, התאמת אפשרויות והגדרה ושיפור של מופע. השינויים בערך של דגל מסד נתונים נשמרים עבור המופע שלו עד שמסירים את הדגל או משנים שוב את הערך שלו.

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

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

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

• זמן השבתה קצר. המדיניות הזו מופעלת כברירת מחדל. מומלץ להשתמש במדיניות הזו בכל אשכולות הייצור של AlloyDB, כי היא מצמצמת את זמן ההשבתה של האפליקציה.

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

  • ברוב עומסי העבודה, זמן ההשבתה של המופע הראשי הוא פחות משנייה אחת.

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

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

  • לא נדרש זמן השבתה של מופע מאגר הקריאה.

  • העדכון של הדגל במופע של מאגר הקריאה מסתיים אחרי כ-10 דקות.

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

  הערה: לא מומלץ להשתמש באפשרות FORCE_APPLY לעדכונים שיכולים לשנות את משפחת המכונות. לדוגמה, עדכון של מופע ממשפחת המכונות C4A למשפחת מכונות אחרת.

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

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

  • המופע הראשי חווה השבתה של דקה אחת בערך.

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

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

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

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

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

• בפרויקט שבו אתם משתמשים צריך להפעיל גישה ל-AlloyDB. Google Cloud
• צריך להיות לכם אחד מתפקידי ה-IAM האלה בפרויקט Google Cloud שבו אתם משתמשים:
  • ‫roles/alloydb.admin (תפקיד IAM מוגדר מראש של אדמין AlloyDB)
  • ‫roles/owner (תפקיד בסיסי ב-IAM: בעלים)
  • ‫roles/editor (תפקיד בסיסי ב-IAM עם הרשאת עריכה)

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

המסוף

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

   מעבר אל Clusters

2. לוחצים על אשכול בעמודה שם המשאב.

3. בדף סקירה כללית, עוברים אל Instances in your cluster (מופעים באשכול), בוחרים מופע ולוחצים על עריכה.

4. כדי להוסיף, לשנות או למחוק דגל של מסד נתונים מהמופע:

   הוספת דגל

   1. כדי להוסיף לדוגמה דגל מסד נתונים, לוחצים על הוספת דגל.
   2. בוחרים דגל מהרשימה New database flag (דגל חדש למסד הנתונים).
   3. צריך לספק ערך לדגל.
   4. לוחצים על סיום.

   שינוי דיווח

   1. כדי לשנות דגל מסד נתונים שקיים במופע, מרחיבים את דגל מסד הנתונים ומשנים את הערך של הדגל הקיים בקטע Edit database flag (עריכת דגל מסד נתונים).
   2. לוחצים על סיום.

   מחיקת דגל

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

5. לוחצים על עדכון המופע.

gcloud

משתמשים בפקודה gcloud alloydb instances update כדי לשנות את דגלי מסד הנתונים של מופע.

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

.

   gcloud alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID

כדי להחיל עדכונים של דגלים מהר יותר, צריך לכלול את הארגומנט --update-mode=FORCE_APPLY. מכיוון שהפעולה הזו עלולה להפחית באופן זמני את הביצועים של מסד הנתונים, מומלץ להימנע משימוש באפשרות הזו בסביבת ייצור.

   gcloud beta alloydb instances update INSTANCE_ID \
   --database-flags FLAGS_LIST \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID \
   --update-mode=FORCE_APPLY

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

• ‫INSTANCE_ID: המזהה של המכונה.
• ‫FLAGS_LIST: רשימה מופרדת בפסיקים של מפרטים של דגלים של מסד נתונים. כל מפרט מורכב משם הדגל, סימן שווה (=) והערך שיוקצה לדגלים. לדגלים של מסד נתונים שלא מקבלים ערכים, מציינים את שם הדגל ואחריו סימן שווה (=).
• ‫REGION_ID: האזור שבו המכונה ממוקמת, לדוגמה, us-central1.
• ‫CLUSTER_ID: המזהה של האשכול שבו נמצאת המכונה.
• ‫PROJECT_ID: המזהה של הפרויקט שבו נמצא האשכול. במהלך מחזור תחזוקה עם זמן השבתה נמוך או אפסי, אחרי שמשנים את הדגלים של מסד הנתונים.

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

   gcloud alloydb instances describe INSTANCE_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --project=PROJECT_ID