יצירת מופעים

בדף הזה מוסבר איך ליצור מכונה של Cloud SQL ל-PostgreSQL.

למידע מפורט על כל הגדרות המכונה, ראו הגדרות מכונה.

במכונה חדשה שנוצרה יש מסד נתונים של postgres.

מספר המכונות המקסימלי שאפשר להגדיר בפרויקט אחד תלוי בארכיטקטורת הרשת של המכונות האלה:

  • ארכיטקטורת רשת חדשה של SQL: אפשר ליצור עד 1,000 מכונות בכל פרויקט.
  • ארכיטקטורת רשת SQL ישנה: אפשר ליצור עד 100 מכונות לכל פרויקט.
  • שימוש בשתי הארכיטקטורות: המגבלה תהיה בין 100 ל-1,000, בהתאם להתפלגות המכונות בין שתי הארכיטקטורות.

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

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

  1. נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloud ליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Install the gcloud CLI.

  5. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  8. Verify that billing is enabled for your Google Cloud project.

  9. Install the gcloud CLI.

  10. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  11. To initialize the gcloud CLI, run the following command: 

    gcloud init
  12. מוודאים שבחשבון המשתמש שלכם מוגדרים התפקידים הבאים:

    כניסה לדף IAM

    מידע נוסף על תפקידים והרשאות

יצירת מכונה של PostgreSQL

המסוף

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

    כניסה לדף Cloud SQL Instances

  2. לוחצים על Create instance.
  3. לוחצים על מופע חדש.
  4. בחלונית Choose your database engine שבדף Create an instance, לוחצים על Choose PostgreSQL.

  5. בקטע Choose a Cloud SQL edition בדף Create a SQL Server instance, בוחרים את מהדורת Cloud SQL למכונה: Enterprise או Enterprise Plus.

    מידע נוסף על מהדורות Cloud SQL זמין במאמר מבוא למהדורות Cloud SQL.

  6. בוחרים את המהדורה שמוגדרת מראש למכונה. כדי לראות את ההגדרות הקבועות מראש שזמינות, לוחצים על התפריט Edition preset.
  7. בקטע Instance info, בוחרים את גרסת מסד הנתונים של המכונה. כדי לראות את הגרסאות הזמינות, לוחצים על התפריט Database version.

    אי אפשר לערוך את גרסת מסד הנתונים אחרי שיוצרים את המכונה.

  8. בשדה Instance ID שבחלונית Instance info, מזינים מזהה למכונה.

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

  9. מזינים סיסמה למשתמש postgres.

    10. כדי לראות את הסיסמה בטקסט גלוי, לוחצים על הסמל הצגת הסיסמה.

    אתם יכולים להזין את הסיסמה באופן ידני או ללחוץ על Generate כדי ש-Cloud SQL ייצור סיסמה באופן אוטומטי.

  10. אופציונלי: מגדירים מדיניות סיסמאות למכונה באופן הבא:
    1. מסמנים את התיבה הפעלת מדיניות סיסמאות.
    2. לוחצים על הכפתור Set password policy, מגדירים אחת או יותר מהאפשרויות הבאות ולוחצים על Save.
      • אורך מינימלי: מספר התווים המינימלי שהסיסמה צריכה להכיל.
      • מורכבות הסיסמה: בדיקה אם הסיסמה היא שילוב של אותיות קטנות, אותיות גדולות, מספרים ותווים לא אלפאנומריים.
      • הגבלת השימוש החוזר בסיסמאות: מציינת את מספר הסיסמאות הקודמות שאי אפשר להשתמש בהן שוב.
      • לא לאפשר שם משתמש: מונע שימוש בשם המשתמש בסיסמה.
      • הגדרת מרווח הזמן לשינוי הסיסמה: מציינת את מספר השעות המינימלי שאחריו אפשר לשנות את הסיסמה.
  11. בקטע Choose region and zonal availability, בוחרים את האזור והתחום של המכונה. הזמינות של האזורים עשויה להשתנות בהתאם למהדורה של Cloud SQL ל-PostgreSQL. מידע נוסף זמין במאמר מידע על הגדרות של מכונות.

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

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

    התנאים הבאים חלים כשמשתמשים באזור המשני במהלך יצירת המכונה:

    • כברירת מחדל, האזור הראשי הוא Any והאזור המשני הוא Any (different from primary).
    • אם מציינים גם את האזור הראשי וגם את האזור המשני, הם חייבים להיות אזורים שונים.
  12. בקטע Customize your instance, מעדכנים את ההגדרות של המכונה. לוחצים על הצגת אפשרות ההגדרה כדי להציג את קבוצות ההגדרות. אחר כך מרחיבים את הקבוצות שרוצים לבדוק ומתאימים אישית את ההגדרות. בצד שמאל מוצג סיכום של כל האפשרויות שבחרתם. ההתאמה האישית של הגדרות המכונה האלה היא אופציונלית. ערכי ברירת המחדל מוקצים בכל מקרה שבו לא בוצעו התאמות אישיות.

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

    הגדרה הערות
    סוג מכונה
    סוג המכונה בוחרים באפשרות "ליבת מעבד משותפת" או "ליבת מעבד ייעודית". בליבת מעבד משותפת, כל סוג מכונה מסווג לפי מספר המעבדים (הליבות) וכמות הזיכרון של המכונה.
    ליבות מספר יחידות ה-vCPU של המכונה. מידע נוסף
    זיכרון נפח הזיכרון של המכונה, ב-GB. מידע נוסף
    בהתאמה אישית בסוג המכונה Dedicated core, במקום לבחור הגדרה מוגדרת מראש, לוחצים על הכפתור Custom כדי ליצור מכונה עם הגדרה בהתאמה אישית. כשבוחרים באפשרות הזו, צריך לבחור את מספר הליבות ואת כמות הזיכרון של המכונה. מידע נוסף
    מטמון הנתונים
    הפעלת מטמון הנתונים כברירת מחדל, האפשרות להפעיל את מטמון הנתונים נבחרת באופן אוטומטי במכונות של Cloud SQL ל-PostgreSQL במהדורת Enterprise Plus. אם לא רוצים להפעיל את מטמון הנתונים, מבטלים את הסימון בתיבה Enable data cache. מידע נוסף על מטמון נתונים זמין במאמר מטמון נתונים.
    אחסון
    סוג האחסון קובע אם המכונה משתמשת באחסון SSD או HDD. מידע נוסף
    נפח אחסון נפח האחסון שהוקצה למכונה. מידע נוסף
    הפעלת הגדלה אוטומטית של נפח האחסון ההגדרה הזו קובעת אם Cloud SQL יספק באופן אוטומטי נפח אחסון נוסף למכונה כשהמקום הפנוי יתחיל להיגמר. מידע נוסף
    הצפנה
    הצפנה בניהול Googleזו אפשרות ברירת המחדל.
    מפתח הצפנה בניהול הלקוח (CMEK)בוחרים באפשרות להשתמש במפתח עם Cloud Key Management Service. מידע נוסף
    חיבורים
    כתובת IP פרטית מוסיפה כתובת IP פרטית למכונה. בוחרים חיבור של גישה לשירותים פרטיים, חיבור של Private Service Connect או את שניהם למכונה. הבחירה שלכם מספקת את החיבור לרשת הפרטית של המכונה. בכל המקרים, נדרשת הגדרה נוספת.

    כדי לבחור ולהגדיר גישה לשירותים פרטיים:

    1. מסמנים את התיבה Private Services Access (PSA).
    2. בתפריט הנפתח רשת VPC, בוחרים את שם הרשת שהמכונה מתחברת אליה.
    3. בתפריט הנפתח Allocated IP range, בוחרים באפשרות Automatic או בטווח כתובות IP ספציפי עם שם.

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

    כדי לבחור ולהגדיר את Private Service Connect:

    1. מסמנים את התיבה Private Service Connect (PSC)‎.
    2. לוחצים על הוספת נקודת קצה.
    3. בקטע Endpoint setup, מבצעים את הפעולות הבאות:
      • בכרטיס New Endpoint, בוחרים את הפרויקט שבו רוצים להגדיר את נקודת הקצה מהתפריט הנפתח Project.
      • בתפריט הנפתח Network, בוחרים רשת לנקודת הקצה.
      • אם Network Connectivity API עדיין לא מופעל, לוחצים על Enable.
    4. כדי להגדיר את ההרשאות ליצירה אוטומטית של מדיניות החיבור לשירות, לוחצים על Confirm Network Setup.

    מידע נוסף על הגדרת Private Service Connect זמין במאמר הגדרת Private Service Connect.
    כתובת IP ציבורית מוסיפה כתובת IP ציבורית למכונה. אחר כך אפשר להוסיף רשתות מורשות כדי להתחבר למכונה.

    למכונה יכולה להיות גם כתובת IP ציבורית וגם כתובת IP פרטית.

    מידע נוסף על שימוש בכתובת IP ציבורית
    רשתות מורשות

    מוסיפים את השם של הרשת החדשה ואת כתובת הרשת. מידע נוסף
    יש הרשאה ל-Data API

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

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

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

    צריך לבחור את סוג רשות האישורים (CA) שחותמת על אישור השרת של מכונת Cloud SQL הזו. מידע נוסף

    כברירת מחדל, כשיוצרים מכונה במסוף Google Cloud , המכונה משתמשת ברשות אישורים פנימית בניהול Google (GOOGLE_MANAGED_INTERNAL_CA), שהיא האפשרות של רשות אישורים לכל מכונה.
    רוטציה אוטומטית של אישורי השרת

    אם בוחרים באפשרות של רשות אישורים (CA) של CAS בניהול Google (GOOGLE_MANAGED_CAS_CA) או באפשרות של רשות אישורים פנימית של CAS בניהול הלקוח (CUSTOMER_MANAGED_CAS_CA) כמצב ה-CA של השרת במכונה, אפשר לבחור אם להחליף באופן אוטומטי את אישור השרת במכונה. מידע נוסף על רוטציה אוטומטית של אישורי שרת ב-Cloud SQL זמין במאמר הפעלת רוטציה אוטומטית של אישורי שרת.

    האפשרות הזו מושבתת כברירת מחדל.
    הגנה על נתונים
    רמת הגיבוי אפשרות הגיבוי של המכונה. אתם יכולים לבחור בין גיבויים משופרים לבין גיבויים רגילים.
    גיבויים אוטומטיים חלון הזמן שבו אתם רוצים שהגיבויים יתחילו. מידע נוסף
    בחירת המיקום לאחסון הגיבוייםברוב תרחישי השימוש, בוחרים באפשרות Multi-region. אם אתם צריכים לאחסן גיבויים באזור ספציפי, למשל מסיבות רגולטוריות, בחרו באפשרות Region ובחרו את האזור שלכם מהתפריט הנפתח Location.
    כמה גיבויים אוטומטיים לשמורמספר הגיבויים האוטומטיים שרוצים לשמור (מיום אחד עד 365 ימים). מידע נוסף
    הפעלת שחזור מערכת מנקודה מסוימת בזמן (PITR) הפעלת שחזור מערכת מנקודה מסוימת בזמן (PITR) וכתיבה מראש ביומן (WAL). מידע נוסף
    הפעלת ההגנה מפני מחיקה קובע אם להגן על מכונה מפני מחיקה מקרית. מידע נוסף
    הפעלת גיבויים שנשמרו אחרי מחיקת המכונה ההגדרה קובעת אם גיבויים אוטומטיים וגיבויים על פי דרישה נשמרים אחרי שמוחקים מכונה. מידע נוסף
    בוחרים כמה ימים לשמור את היומנים. הגדרת שמירה של יומן כתיבה מראש למשך יום אחד עד 7 ימים. הגדרת ברירת המחדל היא 7 ימים. מידע נוסף
    תחזוקה
    חלון מועדף מגדיר חלון זמן של שעה שבו Cloud SQL יכול לבצע עבודות תחזוקה במכונה שעלולות לגרום לשיבושים. אם לא תגדירו חלון זמן, יכול להיות שפעולות תחזוקה שמשבשות את הפעילות יתבצעו בכל זמן. מידע נוסף
    סדר העדכונים התזמון המועדף לעדכוני מכונות, ביחס למכונות אחרות באותו פרויקט. מידע נוסף
    דגלים
    הוספת דגל אתם יכולים להשתמש בדגלים לניהול מסד נתונים כדי לשלוט בהגדרות ובפרמטרים של המכונה. מידע נוסף
    תובנות לגבי שאילתות
    הפעלת Query Insights

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

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

gcloud

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

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

    2. במכונות של מהדורת Cloud SQL Enterprise Plus: 
        gcloud sql instances create INSTANCE_NAME \
    --database-version=DATABASE_VERSION \
    --region=REGION \
    --tier=TIER \
    --edition=ENTERPRISE_PLUS

    במכונות של Cloud SQL Enterprise: 
        gcloud sql instances create INSTANCE_NAME \
    --database-version=DATABASE_VERSION \
    --region=REGION \
    --cpu=NUMBER_CPUS \
    --memory=MEMORY_SIZE \
    --edition=ENTERPRISE
    לחלופין, אתם יכולים להשתמש בדגל --tier אם בחרתם ב-db-f1-micro או ב-db-g1-small כסוג המכונה: 
        gcloud sql instances create INSTANCE_NAME \
      --tier=API_TIER_STRING \
      --region=REGION

    יש מגבלות על הערכים של מעבדי ה-vCPU וגודל הזיכרון:

    • מספר המעבדים הווירטואליים צריך להיות 1 או מספר זוגי בין 2 ל-96.
    • הזיכרון צריך להיות:
      • ‫0.9GB עד 6.5GB לכל vCPU
      • כפולה של 256MB
      • לפחות 3.75GB‏ (3,840MB)

    לדוגמה, הפקודה הבאה יוצרת מכונה של Cloud SQL Enterprise עם שני מעבדי vCPU וזיכרון בנפח 7,680MB:

      gcloud sql instances create myinstance \
  --database-version=POSTGRES_16 \
  --cpu=2 \
  --memory=7680MB \
  --region=us-central1

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

      gcloud sql instances create myinstance \
  --database-version=POSTGRES_16 \
  --tier=db-perf-optimized-N-4 \
  --edition=ENTERPRISE_PLUS \
  --region=us-central1
    במאמר בחירת סדרת מכונות מוסבר איך לבחור את הגודל של משאבי המחשוב (--cpu) והזיכרון (--memory).

    ערך ברירת המחדל של REGION הוא us-central1.

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

    אם אתם יוצרים מכונה לזמינות גבוהה, אתם יכולים לציין גם את האזור הראשי וגם את האזור המשני באמצעות הפרמטרים --zone ו---secondary-zone. התנאים הבאים חלים כשמשתמשים באזור המשני במהלך יצירה או עריכה של מכונה:

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

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

    הגדרה פרמטר הערות
    פרמטרים נדרשים
    גרסת מסד הנתונים --database-version גרסת מסד הנתונים, שמבוססת על מהדורת Cloud SQL.
    אזור --region לעיון בערכים תקינים
    הגדרת מדיניות סיסמאות
    הפעלת מדיניות הסיסמאות --enable-password-policy מפעילה את מדיניות הסיסמאות כשמשתמשים בה. כברירת מחדל, מדיניות הסיסמאות מושבתת. כשמשביתים את המדיניות באמצעות הפרמטר --clear-password-policy, הפרמטרים האחרים של מדיניות הסיסמאות מתאפסים.
    אורך מינימלי --password-policy-min-length מציינת את מספר התווים המינימלי שהסיסמה חייבת להכיל.
    מורכבות הסיסמה --password-policy-complexity ההגדרה הזו מפעילה את בדיקת מורכבות הסיסמה כדי לוודא שהסיסמה מכילה לפחות תו אחד מכל אחד מהסוגים הבאים: אותיות קטנות, אותיות גדולות, מספרים ותווים שאינם אלפאנומריים. מגדירים את הערך בתור COMPLEXITY_DEFAULT.
    הגבלת השימוש החוזר בסיסמאות --password-policy-reuse-interval מציינת את מספר הסיסמאות הקודמות שאי אפשר להשתמש בהן שוב.
    חסימת שם המשתמש --password-policy-disallow-username-substring מונעת שימוש בשם המשתמש בסיסמה. כדי להשבית את הבדיקה, משתמשים בפרמטר --no-password-policy-disallow-username-substring.
    הגדרת מרווח שינוי הסיסמה --password-policy-password-change-interval מציינת את משך הזמן המינימלי שאחריו אפשר לשנות את הסיסמה, לדוגמה, 2m למשך 2 דקות.
    קישוריות
    מאגר חיבורים מנוהל --enable-connection-pooling מפעיל את Managed Connection Pooling במכונה החדשה. אחרי שיוצרים את המכונה, אפשר לקבוע הגדרות מתקדמות של Managed Connection Pooling.

    הערה: התכונה הזו זמינה רק למכונות של מהדורת Cloud SQL Enterprise Plus שמוגדרות בהתאם לדרישות של ניהול מאגר החיבורים.
    כתובת IP פרטית

    גישה לשירותים פרטיים

    --network

    ‫--no-assign-ip (אופציונלי)

    ‫--allocated-ip-range-name (אופציונלי)

    ‫--enable-google-private-path (אופציונלי)



    Private Service Connect

    --no-assign-ip

    --enable-private-service-connect

    --allowed-psc-projects

    --psc-auto-connections

    --enable-psc-auto-connection-policy

    		 ‫--network: השם של רשת ה-VPC שבה רוצים להשתמש במכונה הזו. כבר צריכה להיות מוגדרת גישה לשירותים פרטיים ברשת. בפרויקטים חדשים או ריקים, צריך להפעיל את servicenetworking.googleapis.com, להקצות טווח של כתובות IP ולהגדיר קישור (peering) בין רשתות VPC לפני שיוצרים את המכונה. זמין רק לפקודת הבטא (gcloud beta sql instances create).

    ‫--no-assign-ip: למכונה תהיה רק כתובת IP פרטית.

    ‫--allocated-ip-range-name: אם מצוין, מגדיר שם טווח שמוקצה לו טווח כתובות IP. לדוגמה, google-managed-services-default. שם הטווח צריך לעמוד בדרישות של RFC-1035 ולהיות באורך של 1-63 תווים. (gcloud alpha sql instances create).

    ‫--enable-google-private-path: אם משתמשים בפרמטר הזה, מאפשרים לשירותי Google Cloud אחרים, כמו BigQuery, לגשת לנתונים ב-Cloud SQL ולבצע שאילתות על הנתונים האלה דרך חיבור פרטי.

    הפרמטר הזה תקף רק אם:

    • אתם משתמשים בפרמטר --no-assign-ip.
    • בפרמטר --network מציינים את השם של רשת ה-VPC שבה רוצים להשתמש כדי ליצור חיבור פרטי.

    במכונות Cloud SQL שמשתמשות ב-Private Service Connect לחיבורים דרך כתובת IP פרטית, משתמשים בדגלים הבאים:

    --enable-private-service-connect: מאפשר חיבורים של רשתות פרטיות למכונה של Cloud SQL באמצעות Private Service Connect. מידע נוסף זמין במאמר סקירה כללית על Private Service Connect ב-Cloud SQL.

    ‫--allowed-psc-projects: רשימה מופרדת בפסיקים של מזהי פרויקטים או מספרי פרויקטים מורשים, שמהם נקודות הקצה של Private Service Connect יכולות להתחבר למכונות של Cloud SQL.

    ‫--psc-auto-connections: אם אתם מגדירים נקודות קצה באופן אוטומטי למכונה של Cloud SQL, אתם צריכים להשתמש בדגל כדי לציין את הרשתות והפרויקטים של הצרכן בשביל נקודות הקצה של Private Service Connect.

    ‫--enable-psc-auto-connection-policy: אם צוין, Google Cloud יוצר או מעדכן מדיניות של חיבור לשירות ברשת ובפרויקט של הצרכן בשביל נקודת הקצה של Private Service Connect.

    מידע נוסף על הגדרת Private Service Connect זמין במאמר הגדרת Private Service Connect.
    גישה ל-Data API --data-api-access שולט בקישוריות למכונה באמצעות Data API. היא מושבתת כברירת מחדל. מגדירים את הערך ALLOW_DATA_API כדי לאפשר למשתמשים להשתמש ב-Data API כדי להתחבר למכונה. במכונות שמוגדרות עם כתובת IP פרטית בלבד, משתמשים מורשים יכולים לשלוח קריאה ל-Data API במכונה מהאינטרנט הציבורי. מגדירים את הערך DISALLOW_DATA_API כדי לא לאפשר שימוש ב-Data API.
    כתובת IP ציבורית --authorized-networks בחיבורים של כתובות IP ציבוריות, רק חיבורים מרשתות מורשות יכולים להתחבר למכונה. מידע נוסף
    אכיפת SSL

    --ssl-mode

    --require-ssl

    הפרמטר ssl-mode אוכף את SSL/TLS בחיבורים. מידע נוסף זמין במאמר הגדרות של Cloud SQL ל-PostgreSQL.

    הפרמטר require-ssl קובע אם לאכוף חיבורי SSL דרך IP או לא. ‫require-ssl הוא פרמטר מדור קודם. במקום זאת, אתם צריכים להשתמש ב-ssl-mode. מידע נוסף זמין במאמר IpConfiguration.
    מצב CA של השרת --server-ca-mode

    הדגל --server-ca-mode מגדיר את הסוג של רשות האישורים (CA) של השרת במכונה. אפשר לבחור אחת מהאפשרויות הבאות:

    • ‫GOOGLE_MANAGED_INTERNAL_CA: זהו ערך ברירת המחדל. באפשרות הזו, רשות אישורים (CA) פנימית שמוקדשת לכל מכונה של Cloud SQL חותמת על אישור השרת של המכונה הזו.
    • ‫GOOGLE_MANAGED_CAS_CA: באפשרות הזו נעשה שימוש בהיררכיית CA שמורכבת מ-CA בסיסי ומ-CAs של שרתים משניים שמנוהלים על ידי Cloud SQL ומתארחים ב- Google Cloud Certificate Authority Service (שירות CA). רשויות האישורים המשניות של השרת באזור חותמות על אישורי השרת ומשותפות בין המכונות באזור.
    • CUSTOMER_MANAGED_CAS_CA: באפשרות הזו אתם מגדירים את היררכיית ה-CA ומנהלים את הרוטציה של אישורי ה-CA. יוצרים מאגר CA ב-CA Service באותו אזור של המכונה. אחד מרשויות האישורים במאגר משמש לחתימה על אישור השרת. מידע נוסף מופיע במאמר שימוש ברשות אישורים בניהול הלקוח.
    רוטציה אוטומטית של אישורי השרת --server-certificate-rotation-mode

    הדגל --server-certificate-rotation-mode מגדיר את סוג מצב הרוטציה של אישור השרת של המכונה. אפשר לבחור אחת מהאפשרויות הבאות:

    • ‫NO_AUTOMATIC_ROTATION: זהו ערך ברירת המחדל. אם בוחרים באפשרות הזו, לא יהיה סבב אוטומטי של אישורי שרת. צריך לבצע רוטציה של אישורי השרת באופן ידני.
    • ‫AUTOMATIC_ROTATION_DURING_MAINTENANCE: באפשרות הזו, הרוטציה האוטומטית של אישורי השרת מופעלת במהלך התחזוקה המתוזמנת של Cloud SQL או במהלך עדכוני תחזוקה בשירות עצמי. הערך של server_ca_mode צריך להיות GOOGLE_MANAGED_CAS_CA או CUSTOMER_MANAGED_CAS_CA.
    ארכיטקטורת רשת --enforce-new-sql-network-architecture אכיפת השימוש בארכיטקטורת הרשת החדשה במכונה בזמן היצירה. אם משתמשים בדגל הזה כשיוצרים מכונה לפני שהפרויקט שודרג באופן מלא לארכיטקטורת הרשת החדשה, יכול להיות שתהיה צריכת יתר של כתובות IP או שהמכונות לא ייווצרו אם לא נשארו מספיק כתובות IP בטווח הכתובות שהוקצה. מידע נוסף זמין במאמרים שדרוג מכונה לארכיטקטורת הרשת החדשה והקצאת טווח של כתובות IP.
    סוג המכונה והאחסון
    סוג המכונה --tier משמש לציון מכונה של ליבת מעבד משותפת (db-f1-micro או db-g1-small). להגדרה של מכונה בהתאמה אישית, צריך להשתמש בפרמטרים --cpu או --memory. אפשר לקרוא את המאמר בחירת סדרת מכונות כדי לראות את ההגדרות האפשריות.
    סוג האחסון --storage-type קובע אם המכונה משתמשת באחסון SSD או HDD. מידע נוסף
    נפח אחסון --storage-size נפח האחסון שהוקצה למכונה, ב-GB. מידע נוסף
    הגדלה אוטומטית של נפח האחסון --storage-auto-increase ההגדרה הזו קובעת אם Cloud SQL יספק באופן אוטומטי נפח אחסון נוסף למכונה כשהמקום הפנוי יתחיל להיגמר. מידע נוסף
    מגבלת ההגדלה האוטומטית של נפח האחסון --storage-auto-increase-limit קובע את הגודל המקסימלי של האחסון ב-Cloud SQL, ב-GB. ערך ברירת המחדל הוא unlimited, שמאפשר להגדיל את נפח האחסון עד לנפח המקסימלי שזמין לרמת המכונה. מידע נוסף
    מטמון נתונים (אופציונלי) --enable-data-cache הפעלה או השבתה של מטמון הנתונים של המכונות. מידע נוסף זמין במאמר מטמון נתונים.
    גיבויים אוטומטיים וזמינות גבוהה
    זמינות גבוהה --availability-type במכונה עם זמינות גבוהה, מגדירים את הערך REGIONAL. מידע נוסף
    אזור משני --secondary-zone אם יוצרים מכונה לזמינות גבוהה, אפשר לציין גם את האזור הראשי וגם את האזור המשני באמצעות --zone ו---secondary-zone parameters. ההגבלות הבאות חלות כשמשתמשים באזור המשני במהלך יצירה או עריכה של מכונה:
    • האזורים חייבים להיות אזורים תקינים.
    • אם מציינים את האזור המשני, צריך לציין גם את האזור הראשי.

      • אם מציינים את האזור הראשי והאזור המשני, הם חייבים להיות אזורים שונים.

      אם מציינים את האזור הראשי והמשני, הם חייבים להיות באותו אזור.
    גיבויים אוטומטיים --backup-start-time חלון הזמן שבו אתם רוצים שהגיבויים יתחילו. מידע נוסף
    הגדרות שמירה של גיבויים אוטומטיים --retained-backups-count מספר הגיבויים האוטומטיים שרוצים לשמור. מידע נוסף
    הגדרות שמירה של יומן בינארי --retained-transaction-log-days מספר הימים לשמירת יומני כתיבה מראש לשחזור מערכת מנקודה מסוימת בזמן. מידע נוסף
    שחזור מערכת מנקודה מסוימת בזמן (PITR) --enable-point-in-time-recovery הפעלת שחזור מערכת מנקודה מסוימת בזמן (PITR) וכתיבה מראש ביומן (WAL). מידע נוסף
    הוספת דגלים לניהול מסד נתונים
    דגלים לניהול מסד נתונים --database-flags אתם יכולים להשתמש בדגלים לניהול מסד נתונים כדי לשלוט בהגדרות ובפרמטרים של המכונה. מידע נוסף על דגלים לניהול מסדי נתונים
    לוח זמנים לתחזוקה
    חלון זמן לתחזוקה --maintenance-window-day,
    --maintenance-window-hour    		 מגדיר חלון זמן של שעה שבו Cloud SQL יכול לבצע עבודות תחזוקה שמשבשות את הפעילות במכונה. אם לא מגדירים חלון זמן, אפשר לבצע תחזוקה משבשת בכל שלב. מידע נוסף
    תזמון פעולות התחזוקה --maintenance-release-channel התזמון המועדף לעדכוני מכונות, ביחס למכונות אחרות באותו פרויקט. משתמשים ב-preview לעדכונים מוקדמים יותר, וב-production לעדכונים מאוחרים יותר. מידע נוסף
    שילוב עם Vertex AI
    --enable-google-ml-integration מאפשרת למכונות Cloud SQL להתחבר ל-Vertex AI כדי להעביר ל-AI בקשות לחיזויים ולתובנות בזמן אמת.
    --database-flags cloudsql.enable_google_ml_integration=on הפעלת הדגל הזה מאפשרת לשלב את Cloud SQL עם Vertex AI.
    תובנות לגבי שאילתות
    --insights-config-query-insights-enabled הפעלת תובנות לגבי שאילתות כדי לספק ניתוח של שאילתות ותוכניות לביצוע שאילתות.
    SAN בהתאמה אישית
    הוספת שם חלופי של בעלים (SAN) בהתאמה אישית --custom-subject-alternative-names=DNS_NAMES

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

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

    אם אתם לא משתמשים ב-Cloud SQL Auth Proxy, תשתמשו בכתובת הזו ככתובת המארח שהאפליקציות או הכלים שלכם משתמשים בה כדי להתחבר למכונה.

  3. מגדירים את הסיסמה למשתמש postgres: 
          gcloud sql users set-password postgres \
      --instance=INSTANCE_NAME \
      --password=PASSWORD

Terraform

כדי ליצור מכונה, משתמשים במשאב של Terraform.

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

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

כך מחילים את ההגדרות של Terraform בפרויקט ב- Google Cloud :

הכנת Cloud Shell

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

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

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

    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

יצירת המכונה

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

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

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

  • ‫PROJECT_ID: מזהה הפרויקט
  • ‫INSTANCE_ID: מזהה המכונה
  • ‫REGION: האזור
  • DATABASE_VERSION: מחרוזת enum של גרסת מסד הנתונים (לדוגמה, POSTGRES_18)
  • ‫PASSWORD: הסיסמה של משתמש Root
  • ‫MACHINE_TYPE: מחרוזת enum של סוג המכונה (רמה), למשל: db-custom-[CPUS]-[MEMORY_MBS]

  • ‫EDITION_TYPE: מהדורת Cloud SQL שלכם

  • ‫DATA_CACHE_ENABLED: (אופציונלי) מגדירים את הערך true כדי להפעיל את מטמון הנתונים במכונה
  • ‫PRIVATE_NETWORK: מציינים את השם של רשת הענן הווירטואלי הפרטי (VPC) שבה רוצים להשתמש במכונה הזו. הגישה לשירותים פרטיים כבר צריכה להיות מוגדרת ברשת.
  • ‫AUTHORIZED_NETWORKS: בקישורים דרך IP ציבוריים, מציינים את החיבורים מרשתות מורשות שיכולות להתחבר למכונה.
  • ‫CA_MODE: מציינים היררכיה של רשות אישורים למכונה, GOOGLE_MANAGED_INTERNAL_CA או GOOGLE_MANAGED_CAS_CA. אם לא מציינים את serverCaMode, הגדרת ברירת המחדל היא GOOGLE_MANAGED_INTERNAL_CA. התכונה הזו נמצאת בגרסת טרום-השקה (Preview).
  • ‫SERVER_CERTIFICATE_ROTATION_MODE: כדי להגדיר רוטציה אוטומטית של אישורי השרת במכונה, מציינים את הערך AUTOMATIC_ROTATION_DURING_MAINTENANCE. אם לא מציינים את serverCertificateRotationMode, הגדרת ברירת המחדל היא NO_AUTOMATIC_ROTATION.
  • DNS_NAMES: מוסיפים רשימה מופרדת בפסיקים של עד שלושה שמות DNS לאישור השרת של המכונה ב-Cloud SQL. אתם יכולים לאבטח כמה שמות DNS באמצעות אישור אחד. התכונה הזו זמינה בגרסת Preview ורק למכונות CUSTOMER_MANAGED_CAS_CA.

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

  • ‫enablePasswordPolicy: הפעלת מדיניות הסיסמאות כשהערך הוא true.

    כדי להסיר את מדיניות הסיסמאות, אפשר להשתמש בבקשת PATCH עם הערך null בשדה enablePasswordPolicy. במקרה כזה, הפרמטרים האחרים של מדיניות הסיסמאות מאופסים.

  • ‫minLength: מציין את מספר התווים המינימלי שהסיסמה חייבת להכיל.
  • ‫complexity: בדיקה אם הסיסמה היא שילוב של אותיות קטנות, אותיות רישיות, מספרים ותווים לא אלפאנומריים. ערך ברירת המחדל הוא COMPLEXITY_DEFAULT.
  • ‫reuseInterval: מציינת את מספר הסיסמאות הקודמות שאי אפשר להשתמש בהן שוב.
  • ‫disallowUsernameSubstring: אם הערך הוא true, אי אפשר להשתמש בשם המשתמש בסיסמה.
  • ‫passwordChangeInterval: מציין את משך הזמן המינימלי שאחריו אפשר לשנות את הסיסמה. הערך הוא בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, ומסתיים ב-s. לדוגמה, 3.5s.

כדי ליצור את המכונה כך שתוכל להשתלב עם Vertex AI, צריך לכלול את האובייקט enableGoogleMlIntegration בבקשה. השילוב הזה מאפשר להחיל מודלים גדולים של שפה (LLM) שמתארחים ב-Vertex AI על מסד נתונים של Cloud SQL ל-PostgreSQL.

מגדירים את הפרמטרים הבאים, לפי הצורך:

  • enableGoogleMlIntegration: כאשר פרמטר זה מוגדר ל-true, מופעי Cloud SQL יכולים להתחבר ל-Vertex AI כדי להעביר בקשות לתחזיות בזמן אמת ותובנות ל-AI
  • cloudsql.enable_google_ml_integration: כשהפרמטר הזה מוגדר לערך on, אפשר לשלב את Cloud SQL עם Vertex AI

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

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

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

תוכן בקשת JSON: 

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableGoogleMlIntegration": "true" | "false"
    "databaseFlags":
    [
      {
        "name": "cloudsql.enable_google_ml_integration",
        "value": "on" | "off"
      }
    ]
    "dataCacheConfig": {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
    "backupConfiguration": {
      "enabled": true
    },
    "passwordValidationPolicy": {
      "enablePasswordPolicy": true
      "minLength": "MIN_LENGTH",
      "complexity": COMPLEXITY_DEFAULT,
      "reuseInterval": "REUSE_INTERVAL",
      "disallowUsernameSubstring": "DISALLOW_USERNAME_SUBSTRING",
      "passwordChangeInterval": "PASSWORD_CHANGE_INTERVAL"
    },
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      "ipv4Enabled": false,
      "enablePrivatePathForGoogleCloudServices": true,
      "serverCaMode": "CA_MODE",
      "serverCertificateRotationMode": "SERVER_CERTIFICATE_ROTATION_MODE",
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "dataApiAccess": "ALLOW_DATA_API"
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2019-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

אחזור של כתובת ה-IPv4

אחזור של כתובת ה-IPv4 שהוקצתה באופן אוטומטי למכונה החדשה:

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה שנוצר בשלב הקודם

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

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

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

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_18",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-f1-micro",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "us-west1-a",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "18:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "1",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "project-id",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "SECOND_GEN",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "connectionName": "project-id:region:instance-id",
  "name": "instance-id",
  "region": "us-west1",
  "gceZone": "us-west1-a"
}

מחפשים את השדה ipAddress בתשובה.

REST v1beta4

יצירת המכונה

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

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

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

  • ‫PROJECT_ID: מזהה הפרויקט
  • ‫INSTANCE_ID: מזהה המכונה
  • ‫REGION: האזור
  • DATABASE_VERSION: מחרוזת enum של גרסת מסד הנתונים (לדוגמה, POSTGRES_18)
  • ‫PASSWORD: הסיסמה של משתמש Root
  • ‫MACHINE_TYPE: מחרוזת enum של סוג המכונה (רמה), למשל: db-custom-[CPUS]-[MEMORY_MBS]

  • ‫EDITION_TYPE: מהדורת Cloud SQL שלכם

  • ‫DATA_CACHE_ENABLED: (אופציונלי) מגדירים את הערך true כדי להפעיל את מטמון הנתונים במכונה
  • ‫PRIVATE_NETWORK: מציינים את השם של רשת הענן הפרטי הווירטואלי (VPC) שבה רוצים להשתמש במכונה הזו. כבר צריך להגדיר גישה לשירותים פרטיים ברשת.
  • ‫AUTHORIZED_NETWORKS: בחיבורים של כתובות IP ציבוריות, מציינים את החיבורים מרשתות מורשות שיכולות להתחבר למכונה.
  • ‫CA_MODE: מציינים היררכיה של רשות אישורים למכונה, GOOGLE_MANAGED_INTERNAL_CA או GOOGLE_MANAGED_CAS_CA. אם לא מציינים את serverCaMode, הגדרת ברירת המחדל היא GOOGLE_MANAGED_INTERNAL_CA. התכונה הזו נמצאת בגרסת טרום-השקה (Preview).
  • ‫SERVER_CERTIFICATE_ROTATION_MODE: כדי להגדיר רוטציה אוטומטית של אישורי השרת במכונה, מציינים את הערך AUTOMATIC_ROTATION_DURING_MAINTENANCE. אם לא מציינים את serverCertificateRotationMode, הגדרת ברירת המחדל היא NO_AUTOMATIC_ROTATION.
  • DNS_NAMES: מוסיפים רשימה מופרדת בפסיקים של עד שלושה שמות DNS לאישור השרת של המכונה ב-Cloud SQL. אתם יכולים לאבטח כמה שמות DNS באמצעות אישור אחד. התכונה הזו זמינה בגרסת Preview ורק למכונות CUSTOMER_MANAGED_CAS_CA.

כדי להגדיר מדיניות סיסמאות כשיוצרים מכונה, צריך לכלול את האובייקט passwordValidationPolicy בבקשה. מגדירים את הפרמטרים הבאים, לפי הצורך:

  • ‫enablePasswordPolicy: הפעלת מדיניות הסיסמאות כשהערך הוא true.

    כדי להסיר את מדיניות הסיסמאות, אפשר להשתמש בבקשת PATCH עם הערך null בשדה enablePasswordPolicy. במקרה כזה, הפרמטרים האחרים של מדיניות הסיסמאות מאופסים.

  • ‫minLength: מציין את מספר התווים המינימלי שהסיסמה חייבת להכיל.
  • ‫complexity: בדיקה אם הסיסמה היא שילוב של אותיות קטנות, אותיות רישיות, מספרים ותווים לא אלפאנומריים. ערך ברירת המחדל הוא COMPLEXITY_DEFAULT.
  • ‫reuseInterval: מציינת את מספר הסיסמאות הקודמות שאי אפשר להשתמש בהן שוב.
  • ‫disallowUsernameSubstring: אם הערך הוא true, אי אפשר להשתמש בשם המשתמש בסיסמה.
  • ‫passwordChangeInterval: מציין את משך הזמן המינימלי שאחריו אפשר לשנות את הסיסמה. הערך הוא בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, ומסתיים ב-s. לדוגמה, 3.5s.

כדי ליצור את המכונה כך שתוכל להשתלב עם Vertex AI, צריך לכלול את האובייקט enableGoogleMlIntegration בבקשה. השילוב הזה מאפשר להחיל מודלים גדולים של שפה (LLM) שמתארחים ב-Vertex AI על מסד נתונים של Cloud SQL ל-PostgreSQL.

מגדירים את הפרמטרים הבאים, לפי הצורך:

  • enableGoogleMlIntegration: כאשר פרמטר זה מוגדר ל-true, מופעי Cloud SQL יכולים להתחבר ל-Vertex AI כדי להעביר בקשות לתחזיות בזמן אמת ותובנות ל-AI
  • cloudsql.enable_google_ml_integration: כשהפרמטר הזה מוגדר לערך on, אפשר לשלב את Cloud SQL עם Vertex AI

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

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

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

תוכן בקשת JSON: 

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableGoogleMlIntegration": "true" | "false"
    "databaseFlags":
    [
      {
        "name": "cloudsql.enable_google_ml_integration",
        "value": "on" | "off"
      }
    ]
    "dataCacheConfig": {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
    "backupConfiguration": {
      "enabled": true
    },
    "passwordValidationPolicy": {
      "enablePasswordPolicy": true
      "minLength": "MIN_LENGTH",
      "complexity": COMPLEXITY_DEFAULT,
      "reuseInterval": "REUSE_INTERVAL",
      "disallowUsernameSubstring": "DISALLOW_USERNAME_SUBSTRING",
      "passwordChangeInterval": "PASSWORD_CHANGE_INTERVAL"
    },
    "ipConfiguration": {
      "privateNetwork": "PRIVATE_NETWORK",
      "authorizedNetworks": [AUTHORIZED_NETWORKS],
      "ipv4Enabled": false,
      "enablePrivatePathForGoogleCloudServices": true,
      "serverCaMode": "CA_MODE",
      "serverCertificateRotationMode": "SERVER_CERTIFICATE_ROTATION_MODE",
      "customSubjectAlternativeNames": "DNS_NAMES"
    },
    "dataApiAccess": "ALLOW_DATA_API"
  },
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE"
}

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

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

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

אחזור של כתובת ה-IPv4

אחזור של כתובת ה-IPv4 שהוקצתה באופן אוטומטי למכונה החדשה:

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

  • ‫project-id: מזהה הפרויקט
  • ‫instance-id: מזהה המכונה שנוצר בשלב הקודם

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

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

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

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0_18",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-f1-micro",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "us-west1-a",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "18:00",
      "kind": "sql#backupConfiguration",
      "enabled": true,
      "binaryLogEnabled": true
    },
    "settingsVersion": "1",
    "storageAutoResizeLimit": "0",
    "storageAutoResize": true,
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "project-id",
  "serviceAccountEmailAddress": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "backendType": "SECOND_GEN",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "connectionName": "project-id:region:instance-id",
  "name": "instance-id",
  "region": "us-west1",
  "gceZone": "us-west1-a"
}

מחפשים את השדה ipAddress בתשובה.

כדי לראות איך בקשת ה-API הבסיסית בארכיטקטורת REST בנויה למשימה הזו, עיינו ב-APIs Explorer בדף instances:insert.

יצירת נקודת הקצה לכתיבה

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

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

סוגי מכונות

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

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

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

מידע נוסף זמין במאמר בחירת סדרת מכונות.

פתרון בעיות

שגיאה פתרון בעיות
הודעת שגיאה: The zone or region does not have sufficient resources to handle the request at the moment.

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

כדי לפתור את הבעיה, נסו ליצור את המכונה באזור אחר או באותו אזור שבו התקבלה השגיאה, אבל בשעה אחרת ביום.
הודעת שגיאה: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. אין יותר כתובות זמינות בטווח ה-IP שהוקצה. יכולים להיות כמה תרחישים אפשריים:
  • הגודל של טווח כתובות ה-IP שהוקצה לחיבור לשירות הפרטי קטן מ-‎ /24.
  • גודל טווח כתובות ה-IP שהוקצה לחיבור לשירות הפרטי קטן מדי למספר המכונות של Cloud SQL.
  • אם יוצרים מכונות בכמה אזורים, הדרישה לגבי הגודל של טווח כתובות ה-IP שמוקצה תהיה גדולה יותר. גודל הטווח שהוקצה

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

אם השתמשתם בדגל --allocated-ip-range-name בזמן שיצרתם את המכונה של Cloud SQL, תוכלו להרחיב רק את טווח כתובות ה-IP שצוין.

אם אתם מקצים טווח חדש, חשוב לוודא שההקצאה לא חופפת להקצאות קיימות.

אחרי שיוצרים טווח כתובות IP חדש, מעדכנים את קישור ה-VPC השכנות באמצעות הפקודה הבאה:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force

אם אתם מרחיבים הקצאה קיימת, הקפידו להגדיל רק את טווח ההקצאה ולא להקטין אותו. לדוגמה, אם ההקצאה המקורית הייתה ‎10.0.10.0/24, ההקצאה החדשה צריכה להיות לפחות ‎10.0.10.0/23.

באופן כללי, אם מתחילים מהקצאה של ‎ /24, כלל אצבע טוב הוא להפחית את ה-‎ /mask ב-1 לכל תנאי (קבוצה נוספת של סוגי מכונות, אזור נוסף). לדוגמה, אם מנסים ליצור את שתי קבוצות סוגי המכונות באותה הקצאה, מספיק לעבור מ-‎ /24 ל-‎ /23.

אחרי שמרחיבים טווח כתובות IP קיים, מעדכנים את הקישור בין רשתות ה-VPC באמצעות הפקודה הבאה:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID
הודעת שגיאה: Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID]. מנסים ליצור שוב את המכונה של Cloud SQL.
הודעת שגיאה: HTTPError 400: Invalid request: Incorrect Service Networking config for instance: PROJECT_ID:INSTANCE_NAME:SERVICE_NETWORKING_NOT_ENABLED.

מפעילים את Service Networking API באמצעות הפקודה הבאה ומנסים ליצור שוב את המכונה של Cloud SQL.

gcloud services enable servicenetworking.googleapis.com \
--project=PROJECT_ID
הודעת שגיאה: Failed to create subnetwork. Required 'compute.projects.get' permission for PROJECT_ID. כשיוצרים מכונה באמצעות כתובת IP פרטית, נוצר חשבון שירות בזמן אמת באמצעות Service Networking API. אם הפעלתם את Service Networking API רק לאחרונה, יכול להיות שחשבון השירות לא ייווצר ויצירת המכונה תיכשל. במקרה כזה, צריך להמתין עד שחשבון השירות יופץ במערכת, או להוסיף אותו ידנית עם ההרשאות הנדרשות.
הודעת שגיאה: More than 3 subject alternative names are not allowed. אתם מנסים להשתמש ב-SAN בהתאמה אישית כדי להוסיף יותר משלושה שמות DNS לאישור השרת של מכונה ב-Cloud SQL. אי אפשר להוסיף למכונה יותר משלושה שמות DNS.
הודעת שגיאה: Subject alternative names %s is too long. The maximum length is 253 characters. חשוב לוודא ששמות ה-DNS שרוצים להוסיף לאישור השרת של מכונה ב-Cloud SQL לא מכילים יותר מ-253 תווים.
הודעת שגיאה: Subject alternative name %s is invalid.

מוודאים ששמות ה-DNS שרוצים להוסיף לאישור השרת של מכונה ב-Cloud SQL עומדים בקריטריונים הבאים:

  • הם לא מכילים תווים כלליים לחיפוש.
  • אין בהן נקודות בסוף.
  • הם עומדים במפרטים של RFC 1034.

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

  1. יוצרים מסד נתונים של PostgreSQL במכונה.
  2. יוצרים משתמשי PostgreSQL במכונה.
  3. אבטחה ושליטה בגישה למכונה.
  4. מתחברים למכונה באמצעות לקוח PostgreSQL.
  5. ייבוא נתונים למסד הנתונים.
  6. מידע על הגדרות של מופעים