יצירת מכונה וכתיבת נתונים באמצעות ה-CLI של cbt

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

במדריך למתחילים הזה תבצעו את הפעולות הבאות:

  • מתחברים למכונה של Bigtable.
  • ביצוע משימות ניהול בסיסיות.
  • כתיבת נתונים בטבלה.
  • קריאת נתונים מטבלה.

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

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

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

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

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

    gcloud init

  4. יוצרים או בוחרים Cloud de Confiance פרויקט.

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

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

    • יוצרים Cloud de Confiance פרויקט:

      gcloud projects create PROJECT_ID

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

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

      gcloud config set project PROJECT_ID

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

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

  6. מפעילים את Cloud Bigtable API ואת Cloud Bigtable Admin API, אם הם עדיין לא מופעלים:

    תפקידים שנדרשים להפעלת ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים 

    gcloud services enable bigtable.googleapis.com bigtableadmin.googleapis.com

  7. מעניקים תפקידים לחשבון המשתמש. מריצים את הפקודה הבאה לכל אחד מהתפקידים הבאים ב-IAM: roles/bigtable.admin 

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

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

  8. מריצים את הפקודה הבאה כדי להתקין את cbt CLI : 
    gcloud components install cbt

יצירת מכונה של Bigtable

  1. פותחים את הדף Create instance במסוף Cloud de Confiance .

    יצירת מופע

  2. בשדה Instance name (שם המופע), מזינים Quickstart instance.

  3. בשדה Instance ID (מזהה מכונה), מזינים quickstart-instance.

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

  5. בקטע Storage type, בוחרים באפשרות SSD.

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

  7. בשדה מזהה האשכול, מזינים quickstart-instance-c1.

  8. בשדה Region, בוחרים אזור שקרוב אליכם.

  9. בשדה Zone (תחום), בוחרים באפשרות Any (כל תחום).

  10. בקטע Node scaling mode (מצב שינוי גודל הצומת), בוחרים באפשרות Manual allocation (הקצאה ידנית).

  11. בשדה כמות, בוחרים באפשרות 1.

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

התחברות למכונה

  1. מגדירים את cbt CLI כך שישתמש בפרויקט ובמופע שלכם על ידי יצירת קובץ .cbtrc והחלפת PROJECT_ID במזהה של הפרויקט שבו יצרתם את מופע Bigtable:

    echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc

  2. מוודאים שהגדרתם את קובץ .cbtrc בצורה נכונה:

    cat ~/.cbtrc

    במסוף מוצג התוכן של הקובץ .cbtrc, שנראה כך:

    project = PROJECT_ID
instance = quickstart-instance

    עכשיו אפשר להשתמש ב-cbt CLI עם המופע.

קריאה וכתיבה של נתונים

ב-Bigtable הנתונים מאוחסנים בטבלאות, שמכילות שורות. כל שורה מזוהה באמצעות מפתח שורה.

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

יכולים להיות כמה תאים עם חותמת זמן בנקודת החיתוך של שורה ועמודה.

  1. יוצרים טבלה בשם my-table.

    cbt createtable my-table

  2. הצגת רשימת הטבלאות:

    cbt ls

    הפלט של הפקודה אמור להיראות כך:

        my-table

  3. הוספת קבוצת עמודות אחת בשם cf1:

    cbt createfamily my-table cf1

  4. מציגים את רשימת קבוצות העמודות:

    cbt ls my-table

    הפלט של הפקודה אמור להיראות כך:

        Family Name     GC Policy
    -----------     ---------
    cf1             <never>

  5. כותבים את הערכים test-value1 ו-test-value2 בשורה r1, באמצעות קבוצת העמודות cf1 ומגדיר העמודה c1:

    cbt set my-table r1 cf1:c1=test-value1
  cbt set my-table r1 cf1:c1=test-value2

  6. משתמשים בפקודה cbt read כדי לקרוא את הנתונים שהוספתם לטבלה:

    cbt read my-table

    הפלט שמוצג במעטפת אמור להיראות כך:

        ----------------------------------------
    r1
      cf1:c1                                   @ 2023/03/22-06:56:11.323000
        "test-value1"
      cf1:c1                                   @ 2023/03/22-06:56:04.361000
        "test-value2"

    שני ערכים עם חותמת זמן מאוחסנים באותה עמודה בשורה r1.

הסרת המשאבים

כדי להימנע מחיובים בחשבון Cloud de Confiance על המשאבים שבהם השתמשתם במדריך למתחילים הזה, מוחקים את המופע. מחיקת הקובץ .cbtrc מאפשרת לכם לעבוד על פרויקט אחר.

  1. מחיקת הטבלה my-table:

    cbt deletetable my-table

  2. מוחקים את המכונה:

    cbt deleteinstance quickstart-instance

  3. מוחקים את הקובץ .cbtrc: 

    rm ~/.cbtrc

  4. אם רוצים, מבטלים את פרטי הכניסה של ה-CLI של gcloud:

    gcloud auth revoke

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