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

במדריך למתחילים הזה נסביר איך משתמשים במסוף Google Cloud כדי ליצור מסד נתונים ב-Spanner, להוסיף נתונים ולהריץ שאילתת SQL.

במדריך למתחילים תלמדו:

  • יוצרים מכונה של Spanner.
  • יוצרים מסד נתונים.
  • יוצרים סכימה.
  • להוסיף ולשנות נתונים.
  • מריצים שאילתה.

למידע על עלות השימוש ב-Spanner, ראו תמחור.

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

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

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

  3. אופציונלי: Cloud Spanner API מופעל באופן אוטומטי כשיוצרים מכונה של Spanner. אם היא לא מופעלת, מפעילים אותה ידנית:

    הפעלת Cloud Spanner API
  4. כדי לקבל את ההרשאות שנדרשות ליצירת מכונות ומסדי נתונים, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין ב-Cloud Spanner‏ (roles/spanner.admin) ב-IAM בפרויקט.

יצירת מכונה באמצעות מסוף Google Cloud

בפעם הראשונה שמשתמשים ב-Spanner, צריך ליצור מכונה – הקצאת משאבים שמסדי הנתונים של Spanner משתמשים בהם במכונה הזו.

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

    כניסה ל-Spanner

  2. בדף Spanner, לוחצים על Create a provisioned instance.

    אם כבר השתמשתם ב-Spanner, יופיע הדף Instances של Spanner במקום דף המוצר. לוחצים על Create instance.

  3. בקטע Select an edition, בוחרים באפשרות Standard ולוחצים על Continue.

  4. בקטע Name your instance, מזינים Instance name, לדוגמה Test Instance.

    ‫Spanner מאכלס את Instance ID על סמך שם המכונה, לדוגמה test-instance. משנים את מזהה המכונה לפי הצורך ולוחצים על המשך.

  5. בקטע Configure your instance, באפשרות Choose a configuration, משאירים את אפשרות ברירת המחדל Regional ובוחרים מיקום להגדרה מהתפריט הנפתח.

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

  6. לוחצים על Continue.

  7. בקטע Configure compute capacity, בשדה Select unit בוחרים באפשרות Processing units (PUs). בשדה Choose a scaling mode, משאירים את האפשרות Manual allocation ואת ערך ברירת המחדל של Quantity, שהוא 1000 יחידות עיבוד.

  8. אופציונלי: בקטע Backups, מבטלים את הסימון של התיבה Enable default backup schedules אם לא רוצים ליצור לוחות זמנים לגיבוי כברירת מחדל למכונה לבדיקה.

  9. לוחצים על יצירה.

    במסוף Google Cloud מוצג הדף Overview של המכונה שיצרתם.

יצירת מסד נתונים

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

    כניסה לדף Spanner instances

  2. לוחצים על המכונה שיצרתם, לדוגמה Test Instance.

  3. בדף Overview של המכונה שנפתח, לוחצים על Create database.

  4. בשם של מסד הנתונים, מזינים שם, למשל example-db.

  5. בוחרים ניב של מסד נתונים.

    למידע על התמיכה ב-PostgreSQL ולהנחיות לבחירת דיאלקט, קראו את המאמר ממשק PostgreSQL. משאירים את הקטע Define your schema (optional) (הגדרת הסכימה (אופציונלי)) ריק. בקטע הבא במדריך למתחילים תגדירו את הסכימה ב-Spanner Studio.

  6. לוחצים על יצירה.

    במסוף Google Cloud יוצג הדף Overview של מסד הנתונים שיצרתם.

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

  1. בתפריט הניווט, לוחצים על Spanner Studio.

  2. בדף Spanner Studio, לוחצים על New tab או משתמשים בכרטיסייה Untitled query, ואז מזינים את אחת מהשאילתות הבאות, בהתאם לניב של מסד הנתונים:

    GoogleSQL

    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      BirthDate  DATE
    ) PRIMARY KEY(SingerId);
    

    PostgreSQL

    CREATE TABLE Singers (
      SingerId   BIGINT PRIMARY KEY,
      FirstName  VARCHAR(1024),
      LastName   VARCHAR(1024),
      BirthDate  TIMESTAMPTZ
    );
    
  3. לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום, בכרטיסייה Results מוצגת ההודעה Update completed.

הוספה ושינוי של נתונים

מסוף Google Cloud מספק ממשק להוספה, לעריכה ולמחיקה של נתונים.

הוספת נתונים

  1. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Insert data.

    ‫Spanner פותח כרטיסיית שאילתה חדשה ב-Spanner Studio שמכילה תבנית של הצהרת INSERT.

  2. עורכים את הסעיף VALUES של ההצהרה INSERT בתבנית כדי להוסיף שורה בטבלה Singers, וצופים בתוצאה של ההוספה:

    GoogleSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (1, -- type: INT64
        'Marc', -- type: STRING(1024)
        'Richards', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    PostgreSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      singers (singerid,
        firstname,
        lastname,
        birthdate)
    VALUES
      (1, -- type: bigint
        'Marc', -- type: character varying
        'Richards', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    

    שימו לב ש-PostgreSQL ממיר את שמות העמודות לאותיות קטנות.

  3. לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום, בכרטיסייה Results מוצג הכיתוב ‎1 row inserted והנתונים של השורה שנוספה.

  4. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Insert data.

  5. עורכים את הסעיף VALUES של ההצהרה INSERT:

    GoogleSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (2, -- type: INT64
        'Catalina', -- type: STRING(1024)
        'Smith', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    PostgreSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      singers (singerid,
        firstname,
        lastname,
        birthdate)
    VALUES
      (2, -- type: bigint
        'Catalina', -- type: character varying
        'Smith', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  6. לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום ההרצה, בכרטיסייה Results מוצגות ההודעה ‎1 row inserted והנתונים של השורה שנוספה.

  7. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Preview data.

  8. ‫ לוחצים על Run.

    בכרטיסייה Results מוצגות שתי השורות בטבלה Singers.

אפשר גם להוסיף מחרוזות ריקות לעמודות של מחרוזות.

  1. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Insert data.

    ב-Spanner נפתחת כרטיסיית שאילתה חדשה ב-Spanner Studio, שמכילה את הצהרת INSERT של התבנית.

  2. עורכים את הסעיף VALUES בהצהרה INSERT של התבנית:

    GoogleSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      Singers (SingerId,
        FirstName,
        LastName,
        BirthDate)
    VALUES
      (3, -- type: INT64
        'Kena', -- type: STRING(1024)
        '', -- type: STRING(1024)
        NULL -- type: DATE
        )
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    PostgreSQL

      -- Add new values in the VALUES clause in order of the column list.
      -- Each value must be type compatible with its associated column.
    INSERT INTO
      singers (singerid,
        firstname,
        lastname,
        birthdate)
    VALUES
      (3, -- type: bigint
        'Kena', -- type: character varying
        '', -- type: character varying
        NULL -- type: timestamp with time zone
        )
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  3. לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום ההרצה, בכרטיסייה Results מוצגת ההודעה ‎1 row inserted והנתונים של השורה שנוספה.

    שימו לב שהערך שצוין בעמודה LastName הוא מחרוזת ריקה, '', ולא ערך NULL.

  4. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Preview data.

  5. ‫ לוחצים על Run.

    בכרטיסייה Results מוצגות שלוש השורות בטבלה Singers. השורה עם ערך המפתח הראשי 3 מכילה מחרוזת ריקה בעמודה LastName.

עריכת הנתונים

  1. כדי לעדכן את תאריך הלידה בשורה עם ערך המפתח הראשי 3, לוחצים על New tab ומזינים את הצהרת ה-UPDATE הבאה:

    GoogleSQL

    UPDATE
      Singers
    SET
      BirthDate='1961-04-01'
    WHERE
      SingerId=3
    THEN RETURN
      SingerId,
      FirstName,
      LastName,
      BirthDate;
    

    PostgreSQL

    UPDATE
      singers
    SET
      birthdate='1961-04-01 00:00:00 -8:00'
    WHERE
      singerid=3
    RETURNING
      singerid,
      firstname,
      lastname,
      birthdate;
    
  2. ‫ לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום ההרצה, בכרטיסייה Results מוצגת ההודעה ‎1 row updated והנתונים של השורה שעודכנה.

  3. בחלונית Explorer, לוחצים על View actions בטבלה Singers ואז על Preview data.

  4. ‫ לוחצים על Run.

    בכרטיסייה Results מוצגות השורות בטבלה Singers, עם תאריך הלידה המעודכן של הזמר 3.

מחיקת נתונים

  1. כדי למחוק את השורה עם ערך המפתח הראשי 2, לוחצים על New tab ומזינים את הצהרת ה-DELETE הבאה:

    GoogleSQL

    DELETE FROM Singers
    WHERE SingerId = 2;
    

    PostgreSQL

    DELETE FROM singers
    WHERE singerid = 2;
    
  2. ‫ לוחצים על Run.

    ‫Spanner מריץ את ההצהרה. בסיום ההרצה, בכרטיסייה Results מופיע הכיתוב ‎1 row deleted. הטבלה Singers מכילה שתי שורות.

הרצת שאילתה במסוף Google Cloud

  1. לוחצים על New tab כדי לפתוח כרטיסיית שאילתה חדשה, ואז מזינים את השאילתה הבאה בעורך השאילתות:

    GoogleSQL

    SELECT * FROM Singers;
    

    PostgreSQL

    SELECT * FROM singers;
    
  2. לוחצים על Run.

    ‫Spanner מריץ את השאילתה. בסיום, התוצאה של השאילתה מוצגת בכרטיסייה Results.

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

הסרת המשאבים

כדי להימנע מצבירת חיובים נוספים בחשבון Google Cloud, מחקו את מסד הנתונים ואת המכונה. השבתת Cloud Billing API לא מפסיקה את החיובים. כשמוחקים מכונה, Spanner מוחק את כל מסדי הנתונים שבה.

מחיקת מסד הנתונים

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

    כניסה לדף Spanner instances

  2. לוחצים על שם המכונה שבה נמצא מסד הנתונים שרוצים למחוק, לדוגמה Test Instance.

  3. לוחצים על השם של מסד הנתונים שרוצים למחוק, לדוגמה example-db.

  4. בדף Overview של מסד הנתונים, לוחצים על Delete database.

  5. מזינים את שם מסד הנתונים ולוחצים על Delete כדי לאשר את המחיקה.

מחיקת המכונה

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

    כניסה לדף Spanner instances

  2. לוחצים על שם המכונה שרוצים למחוק, לדוגמה Test Instance.

  3. לוחצים על Delete instance.

  4. כדי לאשר את מחיקת המכונה, מזינים את שם המכונה ולוחצים על Delete.

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