יצירה של מסד נתונים של AlloyDB והפעלת שאילתות בו באמצעות מסוף Google Cloud

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

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

  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. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

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

  5. Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

  7. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

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

  9. Enable the Compute Engine, AlloyDB, Cloud Resource Manager, and Service Networking APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  10. אם אתם מתכננים להגדיר קישוריות לרשת ב-AlloyDB באמצעות רשת VPC שנמצאת באותו פרויקט Google Cloud כמו AlloyDB, אתם צריכים להשתמש ב-Service Networking API.

    אם אתם מתכננים להגדיר קישוריות לרשת ל-AlloyDB באמצעות רשת VPC שנמצאת בפרויקט אחר Google Cloud , תצטרכו להשתמש ב-Compute Engine API וב-Cloud Resource Manager API.

  11. בחירת שיטת ההתחברות ל-AlloyDB.

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות ליצירה של מסד נתונים של AlloyDB ולחיבור אליו, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

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

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

ההרשאות הנדרשות

כדי ליצור מסד נתונים של AlloyDB ולהתחבר אליו, צריך את ההרשאות הבאות:

  • compute.networks.list
  • compute.networks.addPeering
  • compute.addresses.create
  • servicenetworking.services.addPeering
  • alloydb.clusters.create
  • alloydb.instances.create
  • alloydb.instances.login

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

יצירת אשכול ומכונת AlloyDB ראשית

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

    מעבר אל Clusters

  2. לוחצים על יצירת אשכול.

  3. בקטע Configure your cluster (הגדרת האשכול), פועלים לפי השלבים הבאים:

    1. בשדה Cluster ID (מזהה האשכול), מזינים my-cluster.

    2. מזינים סיסמה. חשוב לשים לב לסיסמה הזו כי תצטרכו להשתמש בה במדריך הזה.

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

    4. בתפריט הנפתח אזור שבקטע מיקום, בוחרים את האזור us-central1 (Iowa).

  4. בקטע Configure your primary instance (הגדרת המכונה הראשית), פועלים לפי השלבים הבאים:

    1. בשדה Instance ID (מזהה המופע), מזינים את הערך my-cluster-primary.

    2. בקטע זמינות אזורית, לוחצים על אזור יחיד.

    3. בתפריט הנפתח Machine type, בוחרים את סוג המכונה 2 vCPU, 16 GB.

    4. בתפריט הנפתח רשת של קישוריות, בוחרים את הרשת default.

      אם יש לכם חיבור גישה פרטית, ממשיכים לשלב של יצירת אשכול. אחרת, לוחצים על הגדרת חיבור ופועלים לפי השלבים הבאים:

      1. בקטע הקצאת טווח כתובות IP, לוחצים על שימוש בטווח כתובות IP שהוקצה באופן אוטומטי.

      2. לוחצים על המשך ואז על יצירת קישור.

    5. משאירים את הגדרות ברירת המחדל בקטע אבטחת רשת.

  5. לוחצים על יצירת אשכול. יכול להיות שיחלפו כמה דקות עד ש-AlloyDB ייצור את האשכול ויציג אותו בדף Overview של האשכול הראשי.

התחברות למופע ויצירת מסד נתונים ב-AlloyDB Studio

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

    מעבר אל Clusters

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

  3. בחלונית הניווט, לוחצים על AlloyDB Studio.

  4. בדף Sign in to AlloyDB Studio (כניסה ל-AlloyDB Studio), פועלים לפי השלבים הבאים:

    1. בוחרים שיטת אימות למסד הנתונים.

    2. בוחרים את מסד הנתונים postgres.

    3. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים postgres.

  5. כדי ליצור מסד נתונים, מזינים את ההצהרה הבאה בכרטיסייה Editor 1 ולוחצים על Run:

    CREATE DATABASE guestbook;
    

    אפשר לדעת שמסד הנתונים נוצר כשההודעה Statement executed successfully מוצגת בחלונית Results.

התחברות למסד הנתונים של guestbook

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

    מעבר אל Clusters

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

  3. בחלונית הניווט, לוחצים על AlloyDB Studio.

  4. בדף Sign in to AlloyDB Studio (כניסה ל-AlloyDB Studio), פועלים לפי השלבים הבאים:

    1. בוחרים את מסד הנתונים guestbook.

    2. בוחרים את המשתמש postgres.

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

    4. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים guestbook.

אימות החיבור למסד הנתונים

  1. פועלים לפי השלבים במאמר חיבור למסד הנתונים guestbook.

  2. כדי להוסיף נתונים לדוגמה למסד הנתונים guestbook, מזינים את הטקסט הבא בכרטיסייה Editor 1:

    CREATE TABLE entries (guestName VARCHAR(255),
                          content VARCHAR(255),
                          entryID SERIAL PRIMARY KEY);
    INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
    INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');
    
  3. לוחצים על Run. ההודעה Statement executed successfully בחלונית Results מציינת שהנתונים הוכנסו למסד הנתונים.

  4. כדי להסיר טקסט מהכרטיסייה Editor 1 כדי להריץ פקודה אחרת, לוחצים על Clear.

  5. כדי לבחור את כל הרשומות במסד הנתונים, מזינים את השאילתה הבאה בכרטיסייה Editor 1:

    SELECT * FROM entries;
    
  6. לוחצים על Run. פלט שדומה לזה שמופיע בהמשך מוצג בחלונית תוצאות:

        guestname     | content     | entryid
        --------------+-------------+---------
        Alex          | I got here! | 1
        Kai           | Me too!     | 2
    

הסרת המשאבים

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

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

    מעבר אל Clusters

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

  3. לוחצים על מחיקת האוסף.

  4. בקטע Delete cluster my-cluster, מזינים my-cluster כדי לאשר את מחיקת האשכול.

  5. לוחצים על Delete.

  6. אם יצרתם חיבור פרטי כשיצרתם אשכול, עוברים אל הדף 'רשת' במסוף Google Cloud ולוחצים על מחיקת רשת VPC.

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