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

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

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

gcloud

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

  2. הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.

    איך נכנסים ל-CLI של gcloud באמצעות הזהות המאוחדת?

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

    gcloud init

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

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

    • בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד 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 .

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

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

    gcloud auth application-default login

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

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

מסוף Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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