התחברות ל-Cloud SQL ל-PostgreSQL מ-Cloud Shell

התחברות ל-Cloud SQL ל-PostgreSQL מ-Cloud Shell

‫MySQL   |  PostgreSQL   |  SQL Server

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

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

הערה: השם של הפרויקט צריך להיות באורך שבין 4 ל-30 תווים. בזמן שכותבים את השם, בטופס מוצע מזהה פרויקט – אפשר לערוך אותו. מזהה הפרויקט צריך להיות באורך שבין 6 ל-30 תווים. התו הראשון צריך להיות אות קטנה באנגלית. בשאר התווים אפשר להשתמש במקפים, באותיות קטנות או בספרות, אבל התו האחרון לא יכול להיות מקף.

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

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. מפעילים את ממשקי Google Cloud API הנדרשים.

   המסוף

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

   לדף APIs

   מפעילים את Cloud SQL Admin API.

   gcloud

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

   פתיחת Cloud Shell

   מריצים את הפקודה gcloud services enable באמצעות Cloud Shell כדי להפעיל את ממשקי ה-API שנדרשים במדריך למתחילים הזה:

   gcloud services enable sqladmin.googleapis.com

   הפקודה הזו מפעילה את ממשקי ה-API הבאים:

   • Cloud SQL Admin API

2. צריך לוודא שיש לכם בפרויקט את התפקיד או התפקידים הבאים: אדמין Cloud SQL‏ (roles/cloudsql.admin)

   בדיקת התפקידים

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

      כניסה לדף IAM
   2. בוחרים את הפרויקט.

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

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

   מתן התפקידים

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

      כניסה לדף IAM
   2. בוחרים את הפרויקט.
   3. לוחצים על Grant access.

   4. בשדה New principals, מזינים את מזהה המשתמש. ‫ בדרך כלל מזהה המשתמש הוא כתובת האימייל של חשבון Google.

      ‫
   5. לוחצים על Select a role ומחפשים את התפקיד.
   6. כדי לתת עוד תפקידים, לוחצים על Add another role ומוסיפים אותם.
   7. לוחצים על Save.

יצירת מכונה של Cloud SQL

במדריך למתחילים הזה נשתמש במסוף Google Cloud . כדי להשתמש ב-CLI של gcloud, ב-curl או ב-PowerShell, אפשר לעיין במאמר בנושא יצירת מכונות.

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

   כניסה לדף Cloud SQL Instances

2. לוחצים על Create instance.
3. בתפריט יצירת מופע, בוחרים באפשרות מופע חדש.
4. לוחצים על Choose PostgreSQL (בחירת PostgreSQL).
5. בשדה Instance ID (מזהה המופע), מזינים את הערך myinstance.
6. בשדה סיסמה, מזינים סיסמה למשתמש postgres.

7. לוחצים על Create instance.

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

   הערה: בדוגמה הזו, המכונה נוצרת באמצעות הגדרות ברירת מחדל, כולל כתובת IP ציבורית.

התחברות למכונה

במדריך למתחילים הזה נשתמש בלקוח psql ב-Cloud Shell כדי להתחבר למופע. ‫Cloud Shell היא סביבה מרוחקת עם ארגז חול.

הערה: אי אפשר להשתמש ב-Cloud Shell עם כתובת IP פרטית. ההוראות האלה רלוונטיות רק למכונה עם כתובת IP ציבורית.

1. אופציונלי: אם אתם מריצים מופע מקומי של PostgreSQL, עצרו אותו לפני שמתחברים למופע Cloud SQL. אחרת, יכול להיות שתיתקלו בשגיאות כמו address already in use.

2. במסוףGoogle Cloud , לוחצים על סמל Cloud Shell ‏() בפינה הימנית העליונה.

   בסיום האתחול של Cloud Shell, תופיע הודעה כמו זו שבהמשך:

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. אופציונלי: אם לא אישרתם ל-ה-CLI של gcloud לגשת ל Google Cloud פלטפורמה באמצעות פרטי הכניסה שלכם כמשתמשים ב-Google, צריך להשתמש בפקודה gcloud auth login.

4. בשורת הפקודה של Cloud Shell, מתחברים למכונה של Cloud SQL. משתמשים בפקודה gcloud sql connect באופן הבא. מחליפים את שם המכונה אם הוא שונה.

   gcloud sql connect myinstance --user=postgres

5. בתיבת הדו-שיח, לוחצים על Authorize כדי לאשר ל-Cloud Shell לבצע קריאות ל-API.

   מופיעה ההודעה הבאה:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

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

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

   מופיעה ההנחיה psql.

יצירת מסד נתונים והעלאת נתונים

1. יוצרים מסד נתונים SQL במכונה של Cloud SQL:

   CREATE DATABASE guestbook;

2. מתחברים למסד הנתונים על ידי הזנת הפקודה הבאה וציון הסיסמה.

   \connect guestbook;

3. מכניסים נתונים לדוגמה למסד הנתונים:

   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                           entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
   INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');

4. אחזור הנתונים:

   SELECT * FROM entries;

   התוצאה:

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>
   

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, פועלים לפי השלבים הבאים:

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

   כניסה לדף Cloud SQL Instances

2. בוחרים את מופע myinstance כדי לפתוח את הדף פרטי המופע.
3. בסרגל הסמלים בחלק העליון של הדף, לוחצים על מחיקה.
4. בחלון Delete instance (מחיקת מכונה), מקלידים את שם המכונה ולוחצים על Delete (מחיקה).

שלבי ניקוי אופציונליים

אם אתם לא משתמשים בממשקי ה-API שהופעלו במסגרת ההפעלה המהירה הזו, אתם יכולים להשבית אותם.

• ממשקי ה-API שהופעלו במדריך הזה למתחילים:
  • Cloud SQL Admin API

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

   לדף APIs

2. בוחרים את Cloud SQL Admin API ולוחצים על הלחצן השבתת ה-API.

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

• מידע על יצירת מכונות Cloud SQL

• במאמרים הבאים מוסבר איך ליצור משתמשי PostgreSQL ומסדי נתונים עבור מכונת Cloud SQL.

• מידע על מחירים זמין במחירון של Cloud SQL.

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

• מידע על התחברות למופע Cloud SQL מאפליקציות אחרות של Google Cloud:

  • מתוך אפליקציה שפועלת בסביבה הרגילה של App Engine
  • מתוך אפליקציה שפועלת ב-Compute Engine
  • מאפליקציה שפועלת ב-GKE
  • מ-Cloud Run