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

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

מתחילים עם מופע של תקופת ניסיון בחינם

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

אפשר ליצור מכונה לניסיון חינם באמצעות מסוף Google Cloud או Google Cloud CLI.

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

מסוף Google Cloud

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

    כניסה ל-Spanner

  2. בוחרים או יוצרים Google Cloud פרויקט אם עוד לא עשיתם את זה.

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

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

    א. לוחצים על מעבר לחיוב.

    ב. לאחר מכן לוחצים על קישור חשבון לחיוב.

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

    ד. אחרי שמפעילים את החיוב ב-Cloud בפרויקט, עוברים לדף Spanner.

    כניסה ל-Spanner

    ה. לוחצים על Create free instance וממשיכים אל Create free trial instance בקטע הבא.

  4. אופציונלי: אם כבר יצרתם מופע Spanner בפרויקט, יוצג לכם הדף Spanner Instances (מופעי Spanner).

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

gcloud

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

  2. התקינו את ה-CLI של Google Cloud.

  3. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  4. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  5. יוצרים או בוחרים Google Cloud פרויקט.

    תפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

    • יוצרים Google Cloud פרויקט:

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

    • בוחרים את הפרויקט שיצרתם: Google Cloud 

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  6. מוודאים שהחיוב מופעל בפרויקט Google Cloud .

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

    gcloud auth application-default login

    אם אתם משתמשים ב-Cloud Shell, אין צורך לבצע את הפעולה הזו.

    אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  8. התקינו את ה-CLI של Google Cloud.

  9. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  10. כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה: 

    gcloud init

  11. יוצרים או בוחרים Google Cloud פרויקט.

    תפקידים שנדרשים כדי לבחור או ליצור פרויקט

    • Select a project: כדי לבחור פרויקט לא צריך תפקיד IAM ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד Project Creator (יצירת פרויקטים) (roles/resourcemanager.projectCreator), שכולל את ההרשאה resourcemanager.projects.create. איך מקצים תפקידים

    • יוצרים Google Cloud פרויקט:

      gcloud projects create PROJECT_ID

      מחליפים את PROJECT_ID בשם של פרויקט Google Cloud שיוצרים.

    • בוחרים את הפרויקט שיצרתם: Google Cloud 

      gcloud config set project PROJECT_ID

      מחליפים את PROJECT_ID בשם הפרויקט ב- Google Cloud .

  12. מוודאים שהחיוב מופעל בפרויקט Google Cloud .

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

    gcloud auth application-default login

    אם אתם משתמשים ב-Cloud Shell, אין צורך לבצע את הפעולה הזו.

    אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

יצירת מכונה לתקופת ניסיון בחינם

מסוף Google Cloud

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

בדף Create your free trial instance, מבצעים את הפעולות הבאות:

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

  3. בתפריט הנפתח אזור, בוחרים מיקום להגדרה.

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

  4. לוחצים על Create free instance.

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

gcloud

כדי ליצור מכונה עם תקופת ניסיון בחינם, משתמשים בפקודה gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

מחליפים את מה שכתוב בשדות הבאים:

  • ‫INSTANCE_ID: מזהה קבוע שייחודי בתוך Google Cloud הפרויקט. אי אפשר לשנות את מזהה המופע בשלב מאוחר יותר.

  • ‫INSTANCE_CONFIG: מזהה קבוע של הגדרות המכונה, שמגדיר את המיקום הגיאוגרפי של המכונה. אתם יכולים ליצור מכונה לתקופת ניסיון בחינם בכל אחת מההגדרות של מכונות אזוריות ב-Spanner:

  • ‫INSTANCE_DESCRIPTION: השם שיוצג למכונה בGoogle Cloud מסוף. השם של המופע חייב להיות ייחודי בתוךGoogle Cloud הפרויקט.

לדוגמה, כדי ליצור מכונה לתקופת ניסיון בחינם בשם trial-instance עם השם המוצג Trial Instance באמצעות הגדרת המכונה האזורית regional-us-east5, מריצים את הפקודה הבאה:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
  --instance-type=free-instance --description="Trial Instance"

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

איך מתחילים לעבוד עם מסד נתונים לדוגמה

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

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

מסוף Google Cloud

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

    כניסה לדף Instances

  2. לוחצים על השם של המכונה לתקופת הניסיון בחינם.

  3. לוחצים על השם של מסד הנתונים לדוגמה.

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

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

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

אפשר לגשת לאפליקציה לדוגמה באמצעות Google Cloud CLI.

gcloud

  1. מבצעים את השלבים שמתוארים במאמר הגדרת gcloud, שכוללים יצירה והגדרה של פרויקט ברירת מחדל Google Cloud , הפעלה של Cloud Spanner API והגדרה של OAuth 2.0 כדי לקבל פרטי אימות לשימוש ב-Cloud Spanner API.

    מריצים את הפקודה gcloud auth application-default login כדי להגדיר את פרטי הכניסה לאימות בסביבת הפיתוח המקומית.

  2. מריצים את הפקודה gcloud spanner samples run כדי להוריד את האפליקציה לדוגמה ולהפעיל את שירות ה-gRPC של ה-backend ואת מחולל עומסי העבודה עבור האפליקציה לדוגמה שצוינה:

    gcloud spanner samples run APPNAME --instance-id INSTANCE_ID

  3. מידע נוסף ורשימה של פקודות אחרות שזמינות לאפליקציית הדוגמה מופיעים במסמכי התיעוד של ה-CLI של gcloud.

ייבאו נתונים משלכם

אפשר לייבא נתונים משלכם למסד נתונים של Spanner באמצעות קובץ CSV, קובץ dump של MySQL או קובץ dump של PostgreSQL. אתם יכולים להעלות קובץ מקומי באמצעות Cloud Storage או ישירות מקטגוריה של Cloud Storage. יכול להיות שיהיו חיובים על העלאה של קובץ מקומי באמצעות Cloud Storage.

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

מסוף Google Cloud

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

    כניסה לדף Spanner instances

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

  3. לוחצים על ייבוא הנתונים שלי.

  4. מזינים את הערכים הבאים:

    • בוחרים את סוג הקובץ.

    • מעלים את הקובץ מהמחשב או בוחרים נתיב לקובץ בקטגוריה של Cloud Storage.

    • (אופציונלי) אם בוחרים להשתמש בקובץ CSV, צריך גם להעלות קובץ JSON נפרד שמכיל את סכימת מסד הנתונים. קובץ ה-JSON צריך להיות מובנה בפורמט הבא כדי להגדיר את הסכימה:

      {
  "name": "COLUMN_NAME",
  "type": "TYPE",
  "notNull": NOT_NULL_VALUE,
  "primaryKeyOrder": PRIMARY_KEY_ORDER
}

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫COLUMN_NAME: שם העמודה בטבלה.

      • ‫TYPE: סוג הנתונים בעמודה.

      • (אופציונלי) NOT_NULL_VALUE: האם אפשר לאחסן בעמודה ערכי null. הערכים הקבילים הם true או false. ברירת המחדל היא false.

      • (אופציונלי): PRIMARY_KEY_ORDER: קובע את סדר המפתח הראשי. הערך מוגדר כ-0 בעמודה שהיא לא עמודת מפתח ראשית. מגדירים את הערך כמספר שלם, לדוגמה, 1 לעמודה של מפתח ראשי. עמודות עם מספרים נמוכים יותר מופיעות מוקדם יותר במפתח ראשי מורכב.

      כברירת מחדל, קובץ ה-CSV מצפה לפסיק כמפריד השדות ולשורה חדשה כמפריד השורות. מידע נוסף על השימוש בתווים מותאמים אישית להפרדה מופיע במאמר בנושא gcloud alpha spanner databases import.

    • בוחרים מסד נתונים חדש או קיים כיעד.

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

  6. מערכת Spanner פותחת את Cloud Shell ומאכלסת פקודה שמתקינה את כלי ההעברה של Spanner ומריצה את הפקודה gcloud alpha spanner databases import. לוחצים על המקש ENTER כדי לייבא נתונים למסד הנתונים.

שדרוג מופע של תקופת ניסיון בחינם

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

מסוף Google Cloud

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

    כניסה לדף Instances

  2. לוחצים על השם של המכונה לתקופת הניסיון בחינם.

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

  4. בשדה Update instance name, מזינים שם מתאים יותר למופע בתשלום, אם רלוונטי.

  5. בוחרים את אפשרות השדרוג. אפשר לבחור באחת מהאפשרויות הבאות:

    • אני רוצה לשדרג
    • אני רוצה לשדרג אוטומטית לגרסה המלאה של מהדורת Enterprise אחרי שתקופת הניסיון שלי תסתיים
    • תזכירו לי אחר כך

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

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

gcloud

כדי לשדרג את מכונת תקופת הניסיון בחינם למכונת Enterprise Edition בתשלום עם אותן הגדרות, מריצים את הפקודה הבאה:gcloud spanner instances update

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

מחיקת המכונה

מסוף Google Cloud

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

    כניסה לדף Instances

  2. לוחצים על שם המופע שרוצים למחוק.

  3. בדף Instance Overview (סקירה כללית של המכונה), לוחצים על Delete instance (מחיקת המכונה).

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

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

gcloud

כדי למחוק את המכונה שלכם בתקופת הניסיון בחינם, משתמשים בפקודה הבאה: gcloud spanner instances delete

gcloud spanner instances delete INSTANCE_ID

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