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

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

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

  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. 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

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

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

    המסוף

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

    מעבר אל ממשקי ה-API

    מפעילים את 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

  7. צריך לוודא שיש לכם בפרויקט את התפקיד או התפקידים הבאים: אדמין ב-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. בתפריט Create instance, בוחרים באפשרות New instance.
  4. לוחצים על Choose PostgreSQL.
  5. בשדה Instance ID, מזינים את הערך myinstance.
  6. בשדה Password, מזינים סיסמה למשתמש postgres.

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

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

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

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

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

  2. בGoogle Cloud מסוף, לוחצים על הסמל של Cloud Shell (הסמל של 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 כדי לפתוח את הדף Instance details.
  3. בסרגל הסמלים שבחלק העליון של הדף, לוחצים על מחיקה.
  4. בחלון Delete instance, מקלידים את שם המכונה ולוחצים על Delete.

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

אם אתם לא משתמשים בממשקי ה-API שהופעלו כחלק מהמדריך למתחילים, אתם יכולים להשבית אותם.

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

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

    מעבר אל ממשקי ה-API

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

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