יצירת מכונה של 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.

    לוחצים על 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 ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (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 ספציפי – אפשר לבחור כל פרויקט שקיבלתם בו תפקיד.
    • יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (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. בדף Instance Overview, לוחצים על Edit instance או על Edit to upgrade.

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

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

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

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

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

gcloud

כדי לשדרג את מכונת הניסיון בחינם למכונת Enterprise בתשלום עם אותה הגדרת מכונה, מריצים את הפקודה הבאה: 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

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