יצירה וניהול של טבלאות

טבלאות Bigtable מאפשרות לארגן ולאחסן נתונים בקנה מידה גדול לעומסי עבודה (workloads) של אפליקציות עם זמן אחזור קצר. אפשר ליצור ולנהל את הטבלאות האלה באמצעות מסוף Google Cloud , ה-CLI של Google Cloud, ה-CLI של cbt או באופן פרוגרמטי באמצעות ספריות הלקוח של Cloud Bigtable.

למידע נוסף על יצירה וניהול של תצוגות מורשות של טבלה, ראו תצוגות מורשות.

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

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

1. מתקינים את ה-CLI של gcloud.

2. אופציונלי: אם אתם מתכננים להשתמש ב-CLI של cbt, פעלו לפי ההוראות במאמר התקנת ה-CLI של cbt , כולל השלב ליצירת קובץ .cbtrc.

   ההוראות ל-CLI של cbt בדף הזה מבוססות על ההנחה שהגדרתם את מזהה הפרויקט ומזהה המכונה בקובץ .cbtrc. אפשר גם להשתמש בדגלים -project ו--instance כדי להגדיר את הערכים האלה בכל פעם שמריצים פקודה ב-CLI של cbt.

צור טבלה

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

המסוף

כדי ליצור טבלה במכונה:

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שבה רוצים ליצור את הטבלה.

3. בתפריט הניווט של Bigtable, לוחצים על Tables.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על Create table.

5. בחלונית Create a table, בשדה Table ID, מזינים מזהה קבוע לטבלה.

6. אופציונלי: הוספת קבוצות עמודות.

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

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

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

   1. בוחרים באפשרות Enable change stream.

   2. בשדה Retention time, מזינים מספר שלם מ-1 עד 7 כדי לציין את מספר הימים לשמירת הנתונים של סנכרון השינויים בזרמי נתונים.

9. אופציונלי: בקטע Configure automated backup, מגדירים גיבויים אוטומטיים לטבלה. כברירת מחדל, האפשרות Enable automated backup מסומנת, ו-Bigtable יוצר גיבוי רגיל יומי בכל האשכולות במכונה ושומר כל גיבוי למשך שבעה ימים. מידע נוסף זמין במאמר שימוש בגיבוי אוטומטי.

   • אם אתם לא רוצים ש-Bigtable ייצור גיבויים יומיים של הטבלה, בטלו את הבחירה באפשרות Enable automated backup.
   • במכונות SSD, כדי ליצור גיבויים חמים יומיים במקום גיבויים רגילים, בוחרים באפשרות Hot בקטע Backup type, ואז בשדה Set hot to standard מזינים מספר שלם מ-1 עד 10 כדי לציין את מספר הימים לפני שכל גיבוי עובר אוטומטית לגיבוי רגיל. ברירת המחדל היא 3 ימים, והערך לא יכול להיות גדול מתקופת השמירה. אי אפשר לבחור באפשרות Hot אם האחסון השכבתי מופעל. מידע נוסף זמין במאמר הגדרת גיבויים אוטומטיים חמים.
   • כדי להגדיר תקופת שמירה בהתאמה אישית, בקטע Backup configuration מזינים מספר שלם מ-3 עד 90 בשדה Retention period כדי לציין את מספר הימים לשמירת הגיבויים.
   • במהדורת Enterprise Plus, כדי לבחור אשכולות ספציפיים שבהם Bigtable יוצר גיבויים יומיים, בקטע Backup configuration בוחרים את האשכולות ברשימה Select clusters to back up ולוחצים על OK. מידע נוסף זמין במאמר הגדרת מיקומי אשכולות לגיבוי אוטומטי.

10. אופציונלי: בקטע Configure tiered storage, מפעילים את האפשרות לאחסון עם גישה לא תכופה לטבלה כחלק מאחסון מדורג (גרסת טרום-השקה (Preview)). אי אפשר להפעיל אחסון מדורג אם בחרתם באפשרות Hot לגיבויים אוטומטיים.

    1. מסמנים את התיבה Enable tiered storage.

    2. בשדה Age threshold, מזינים מספר שלם שגדול מ-30 או שווה לו, כדי לציין את מספר הימים שאחריהם Bigtable יעביר את הנתונים מאחסון SSD לאחסון בגישה לא תכופה.

11. אופציונלי: כדי להגדיר סכימה של מפתח שורה, בוחרים באפשרות Define row key schema, ואז מבצעים את הפעולות הבאות:

    1. ברשימה Encoding, בוחרים סוג קידוד לסכימה של מפתח השורה.

    2. אם בחרתם באפשרות DelimitedBytes, בשדה Delimiter מזינים תו מפריד שמפריד בין הפלחים במפתחות השורות הקיימים. ערך ברירת המחדל הוא סמל סולמית (#).

    3. בשדה Segment, מזינים שם לפלח, למשל device_type.

    4. ברשימה Type, בוחרים את סוג הנתונים של פלח מפתח השורה.

    5. בהתאם לסוג הנתונים שנבחר, ברשימה Byte encoding, משאירים את סוג הקידוד שמוגדר כברירת מחדל של פלח מפתח השורה או משנים אותו.

    6. אופציונלי: אם לפלח של מפתח השורה יש יותר מחלק אחד, לוחצים על Add row key segment כדי להוסיף עוד שדות.

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

gcloud

כדי ליצור טבלה, מריצים את הפקודה הבאה. רשימת האפשרויות המלאה מופיעה במאמר gcloud bigtable instances tables create.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN_FAMILIES

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

• ‫TABLE_ID: מזהה ייחודי לטבלה החדשה
• ‫INSTANCE_ID: מזהה המכונה
• ‫PROJECT_ID: הפרויקט שיכיל את הטבלה החדשה
• ‫COLUMN_FAMILIES: רשימה מופרדת בפסיקים של שמות של קבוצות עמודות. אפשר להוסיף עוד קבוצות של עמודות בהמשך.

אופציונלי:

• כדי להגן על הטבלה מפני מחיקה, מוסיפים לפקודה את --deletion-protection. אם לא תפעילו את ההגדרה הזו, יכול להיות שהטבלה תימחק. אפשר גם לאשר באופן מפורש מחיקת טבלאות על ידי הוספת --no-deletion-protection.

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

  --change-stream-retention-period=RETENTION_PERIOD
  

  מחליפים את הערך RETENTION_PERIOD במשך הזמן שבו Bigtable צריך לשמור את נתוני סנכרון שינויים בזרמי נתונים של הטבלה. משך הזמן צריך להיות בין יום אחד ל-7 ימים. היחידות הקבילות הן ימים (d), שעות (h), דקות (m) ושניות (s) – לדוגמה, 48h או 6d.

• כדי לאפשר ל-Bigtable ליצור גיבוי יומי של הטבלה ולשמור כל גיבוי למשך תקופת השמירה שמוגדרת כברירת מחדל (7 ימים), משתמשים בדגל --enable-automated-backup כשיוצרים את הטבלה.

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN_FAMILIES \
      --enable-automated-backup
  

  כדי להגדיר תקופת שמירה אחרת, משתמשים בדגל --automated-backup-retention-period במקום בדגל --enable-automated-backup ומציינים ערך של עד 90 יום. הערך חייב להיות מבוטא כמספר עם יחידה של m,‏ h או d (דקות, שעות או ימים), למשל 15d למשך 15 ימים.

  במכונות SSD, כדי להגדיר את Bigtable ליצור גיבויים אוטומטיים חמים שעוברים באופן אוטומטי לגיבויים רגילים, משתמשים בדגל --automated-backup-keep-hot-duration במקום בדגל --enable-automated-backup. צריך לציין משך זמן בין 24h (יום אחד) ל-10d (10 ימים), שלא חורג מתקופת השמירה. מציינים את הערך כמספר עם יחידה של s,‏ m,‏ h או d (שניות, דקות, שעות או ימים), כמו 24h או 2d. מידע נוסף זמין במאמר הגדרת גיבויים אוטומטיים חמים.

  מהדורת Enterprise Plus: כברירת מחדל, Bigtable יוצר גיבוי יומי בכל האשכולות במכונה של הטבלה. כדי להגדיר את מיקומי האשכולות שבהם Bigtable צריך ליצור גיבוי יומי של הטבלה, משתמשים בדגל --automated-backup-locations במקום בדגל --enable-automated-backup. צריך לספק רשימה מופרדת בפסיקים של מיקומי אשכולות שבהם צריך להפעיל את הגיבוי האוטומטי, לדוגמה us-central1-a,us-east1-b,europe-west1-c.

  זהירות: כשמשנים את הגדרת הגיבוי האוטומטי של טבלה בשלב מאוחר יותר, צריך לציין רק את הדגלים של הפרמטרים שרוצים לשנות. הפרמטרים שיושמטו ישמרו על הערכים הקיימים שלהם. עם זאת, העברת הדגל --enable-automated-backup מאפסת את כל הפרמטרים של מדיניות הגיבוי האוטומטי לערכי ברירת המחדל שלהם.

• כדי להפעיל גישה לא תכופה כחלק מאחסון מדורג (גרסת טרום-השקה (Preview)), משתמשים בדגל --tiered-storage-infrequent-access-older-than:

  gcloud beta bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD
  

  מחליפים את AGE_THRESHOLD בערך של 30 ימים לפחות. יחידות הזמן הקבילות הן ימים (d), שעות (h), דקות (m) ושניות (s) – לדוגמה, 32d או 32d12h.

• כדי להגדיר את רמת הפירוט של חותמות הזמן בטבלה, משתמשים בדגל --timestamp-granularity:

  gcloud bigtable instances tables create TABLE_ID \
      --instance=INSTANCE_ID \
      --project=PROJECT_ID \
      --column-families=COLUMN-FAMILIES \
      --timestamp-granularity=TIMESTAMP_GRANULARITY
  

  מחליפים את TIMESTAMP_GRANULARITY ברמת הדיוק. ברירת המחדל של הדיוק היא אלפית השנייה, והערך הוא MILLIS. אם רוצים שהטבלה תקבל חותמות זמן ברמת דיוק של מיקרו-שניות, מגדירים את הערך MICROS. חותמות זמן ברמת דיוק של מיקרו-שנייה זמינות רק למכונות במהדורת Enterprise Plus.

cbt

אי אפשר להשתמש ב-CLI של cbt כדי ליצור טבלה עם סנכרון שינויים בזרמי נתונים מופעל.

כדי ליצור טבלה, מריצים את הפקודה הבאה:

cbt createtable TABLE_ID

מחליפים את TABLE_ID במזהה ייחודי לטבלה החדשה.

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

cbt createtable TABLE_ID families=FAMILY_NAME:never:TYPE

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

• ‫TABLE_ID: מזהה ייחודי לטבלה החדשה
• ‫FAMILY_NAME: רשימה מופרדת בפסיקים של שמות של קבוצות עמודות. אפשר להוסיף עוד קבוצות עמודות מאוחר יותר.
• ‫TYPE: סוג הצבירה. הערך חייב להיות intsum, ‏intmin, ‏intmax או inthll.

לאפשרויות נוספות, ראו יצירת טבלה במאמרי העזרה של ה-CLI של cbt.

אם מחקתם טבלה בטעות, אל תנסו ליצור אותה באופן ידני. משתמשים בפקודה bigtable instances tables undelete של ה-CLI של gcloud כדי לשחזר את הטבלה.

אופציונלי: פיצול הטבלה לפי מפתח שורה

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

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

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

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

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

המסוף

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

gcloud

כדי לפצל טבלה לפי מפתח שורה, מריצים את הפקודה הבאה. רשימת האפשרויות המלאה מופיעה במאמר gcloud bigtable instances tables create.

gcloud bigtable instances tables create TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --column-families=COLUMN_FAMILIES \
    --splits=SPLITS

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

• ‫TABLE_ID: מזהה ייחודי לטבלה החדשה
• ‫INSTANCE_ID: מזהה המכונה
• ‫PROJECT_ID: הפרויקט שיכיל את הטבלה החדשה
• ‫COLUMN_FAMILIES: רשימה מופרדת בפסיקים של שמות של קבוצות עמודות. אפשר להוסיף עוד קבוצות של עמודות בהמשך.
• ‫SPLITS: מפתחות השורות שבהם הטבלה צריכה להתפצל בהתחלה, לדוגמה 10,20.

cbt

כדי לפצל מראש טבלה על סמך מפתח השורה, מריצים את הפקודה הבאה:

cbt createtable TABLE_ID splits=SPLITS

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

• ‫TABLE_ID: מזהה ייחודי לטבלה החדשה
• ‫SPLITS: רשימה מופרדת בפסיקים של קידומות של מפתחות שורות, שבהן צריך להשתמש לפיצולים מראש

לדוגמה, כדי לפצל מראש את הטבלה my-table במפתחות שורה שמתחילים ב-10 וב-20:

cbt createtable my-table splits=10,20

שינוי קבוצות עמודות בטבלה

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

הוספת קבוצות עמודות

המסוף

הוספת משפחות של עמודות לטבלה חדשה

1. בחלונית Create table, לכל קבוצת עמודות שרוצים להוסיף, לוחצים על Add a column family.

2. בשדה Column family name, מזינים מזהה ייחודי של קבוצת העמודות.

3. בוחרים את סוג קבוצת העמודות:

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

4. אם בחרתם באפשרות Aggregate, בשדה Aggregator בוחרים אחת מהאפשרויות הבאות:

   • סכום: צובר את הסכום של כל ערכי התאים.
   • מינימום: צובר את ערך התא המינימלי.
   • מקסימום: צובר את ערך התא המקסימלי.
   • ‫HyperLogLog: צובר את העוצמה המשוערת של ערכי התאים.

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

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

הוספת משפחות של עמודות לטבלה קיימת

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על Edit בטבלה שרוצים לשנות.

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

   1. לוחצים על הוספת קבוצת עמודות.
   2. בשדה Column family name, מזינים מזהה ייחודי של קבוצת העמודות.

   3. בוחרים את סוג קבוצת העמודות:

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

   4. אם בחרתם באפשרות Aggregate, בשדה Aggregator בוחרים באחת מהאפשרויות הבאות:

      • סכום: צובר את הסכום של כל ערכי התאים.
      • מינימום: צובר את ערך התא המינימלי.
      • מקסימום: צובר את ערך התא המקסימלי.
      • ‫HyperLogLog: צובר את העוצמה המשוערת של ערכי התאים.

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

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

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

gcloud

אי אפשר להשתמש ב-CLI של gcloud כדי להוסיף קבוצות עמודות לטבלה.

cbt

כדי להוסיף קבוצת עמודות לטבלה, מריצים את הפקודה הבאה:

cbt createfamily TABLE_ID FAMILY_NAME

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

• ‫TABLE_ID: מזהה הטבלה שבה רוצים להוסיף את קבוצת העמודות
• ‫FAMILY_NAME: השם של קבוצת העמודות שרוצים להוסיף

לדוגמה, כדי להוסיף את משפחות העמודות cf1 ו-cf2 לטבלה my-table:

cbt createfamily my-table cf1
cbt createfamily my-table cf2

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

cbt createfamily TABLE_ID FAMILY_NAME:never:TYPE

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

• ‫TABLE_ID: מזהה הטבלה
• ‫FAMILY_NAME: רשימה מופרדת בפסיקים של שמות של קבוצות עמודות. אפשר להוסיף עוד קבוצות עמודות מאוחר יותר.
• ‫TYPE: סוג הצבירה. הערך חייב להיות intsum, ‏intmin, ‏intmax או inthll.

מחיקת משפחות של עמודות

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

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

המסוף

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על Edit בטבלה שרוצים לשנות.

5. לכל קבוצת עמודות שרוצים למחוק, מבצעים את הפעולות הבאות:

   1. מעבירים את העכבר מעל השורה של קבוצת העמודות שרוצים למחוק.
   2. לחץ על .

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

7. כדי לאשר שאתם מבינים שמחיקת קבוצת עמודות היא פעולה סופית וכל הנתונים בקבוצת העמודות יימחקו, הקלידו "Delete column families" בשדה הטקסט.

8. לוחצים על אישור.

gcloud

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

cbt

כדי למחוק קבוצת עמודות מטבלה, מריצים את הפקודה הבאה:

cbt deletefamily TABLE_ID FAMILY_NAME

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

• ‫TABLE_ID: המזהה של הטבלה שממנה רוצים למחוק את קבוצת העמודות
• ‫FAMILY_NAME: השם של קבוצת העמודות שרוצים למחוק

לדוגמה, כדי למחוק את קבוצת העמודות cf2 מהטבלה my-table:

cbt deletefamily my-table cf2

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

המסוף

כדי לראות רשימה של טבלאות במכונה:

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

   • לוחצים על החץ לצד מזהה הטבלה כדי להרחיב את רשימת הרפליקות של הטבלה.
   • לוחצים על View Metrics לצד שם הטבלה כדי לראות את נתוני התובנות של המערכת לגבי הטבלה.

gcloud

כדי לראות רשימה של טבלאות, מריצים את הפקודה gcloud bigtable instances tables list:

gcloud bigtable instances tables list --instances=INSTANCE_IDS

מחליפים את INSTANCE_IDS ברשימה מופרדת בפסיקים של מזהי מכונות.

cbt

כדי להציג רשימה של טבלאות במכונה, מריצים את הפקודה הבאה:

cbt ls INSTANCE_ID

מחליפים את INSTANCE_ID במזהה הקבוע של המכונה.

C++‎

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

namespace cbt = ::google::cloud::bigtable;
namespace cbta = ::google::cloud::bigtable_admin;
using ::google::cloud::StreamRange;
[](cbta::BigtableTableAdminClient admin, std::string const& project_id,
   std::string const& instance_id) {
  std::string instance_name = cbt::InstanceName(project_id, instance_id);

  google::bigtable::admin::v2::ListTablesRequest r;
  r.set_parent(instance_name);
  r.set_view(google::bigtable::admin::v2::Table::NAME_ONLY);

  StreamRange<google::bigtable::admin::v2::Table> tables =
      admin.ListTables(std::move(r));
  for (auto& table : tables) {
    if (!table) throw std::move(table).status();
    std::cout << table->name() << "\n";
  }
}

C#‎

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

// Lists tables in intance.
// Initialize request argument(s).
ListTablesRequest request = new ListTablesRequest
{
    ParentAsInstanceName = s_instanceName
};
try
{
    // Make the request.
    PagedEnumerable<ListTablesResponse, Table> response = bigtableTableAdminClient.ListTables(request);

}
catch (Exception ex)
{
    Console.WriteLine($"Error listing tables {ex.Message}");
}

Java

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

// Lists tables in the current instance.
try {
  String parent = "projects/" + projectId + "/instances/" + instanceId;
  ListTablesRequest request = ListTablesRequest.newBuilder().setParent(parent).build();
  for (Table table : adminClient.listTables(request).iterateAll()) {
    System.out.println(table.getName());
  }
} catch (NotFoundException e) {
  System.err.println("Failed to list tables from a non-existent instance: " + e.getMessage());
}

Node.js

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

// List tables in current project
const [tables] = await adminClient.listTables({parent: instance.name});
tables.forEach(table => {
  console.log(table.name);
});

PHP

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

use Google\Cloud\Bigtable\Admin\V2\Client\BigtableInstanceAdminClient;
use Google\Cloud\Bigtable\Admin\V2\Client\BigtableTableAdminClient;
use Google\Cloud\Bigtable\Admin\V2\ListTablesRequest;

/**
 * List tables in an instance
 *
 * @param string $projectId The Google Cloud project ID
 * @param string $instanceId The ID of the Bigtable instance
 */
function list_tables(
    string $projectId,
    string $instanceId
): void {
    $instanceAdminClient = new BigtableInstanceAdminClient();
    $tableAdminClient = new BigtableTableAdminClient();

    $instanceName = $instanceAdminClient->instanceName($projectId, $instanceId);

    printf('Listing Tables:' . PHP_EOL);
    $listTablesRequest = (new ListTablesRequest())
        ->setParent($instanceName);
    $tables = $tableAdminClient->listTables($listTablesRequest)->iterateAllElements();
    $tables = iterator_to_array($tables);
    if (empty($tables)) {
        print('No table exists.' . PHP_EOL);
        return;
    }
    foreach ($tables as $table) {
        print($table->getName() . PHP_EOL);
    }
}

Python

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

tables = instance.list_tables()
print("Listing tables in current project...")
if tables != []:
    for tbl in tables:
        print(tbl.table_id)
else:
    print("No table exists in current project...")

Ruby

במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.

כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.

# instance_id = "my-instance"
bigtable.tables(instance_id).all.each do |t|
  puts "Table: #{t.name}"
end

הצגת מידע על טבלה

המסוף

כדי לראות מידע על טבלה:

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

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

4. כדי להציג את שמות קבוצות העמודות בטבלה, לוחצים על . כדי לסגור את החלונית Edit table, לוחצים על Cancel.

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

gcloud

כדי להציג מידע על טבלה, מריצים את הפקודה gcloud bigtable instances tables describe.

gcloud bigtable instances tables describe TABLE_ID \
    --instance=INSTANCE_ID

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

• ‫TABLE_ID: מזהה ייחודי של הטבלה
• ‫INSTANCE_ID: מזהה המכונה

cbt

אפשר להשתמש ב-cbt CLI כדי לקבל רשימה של קבוצות העמודות הקיימות בטבלה.

כדי להציג את משפחות העמודות בטבלה, מריצים את הפקודה הבאה:

cbt ls TABLE_ID

מחליפים את TABLE_ID במזהה הייחודי של הטבלה.

קביעת מדיניות איסוף אשפה

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

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

• אם יוצרים את קבוצת העמודות באמצעות לקוח Cloud Bigtable HBase ל-Java או מעטפת HBase, או כלי אחר שמשתמש בלקוח HBase ל-Java,‏ Bigtable שומר רק תא אחד לכל הצטלבות של שורה או עמודה בקבוצת העמודות. הגדרת ברירת המחדל הזו תואמת ל-HBase.

• אם יוצרים את קבוצת העמודות באמצעות מסוף Google Cloud , ספריית לקוח אחרת או ה-CLI של cbt , Bigtable שומר מספר אינסופי של תאים בכל עמודה.

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

גיבוי ושחזור של טבלה

במאמר ניהול גיבויים מוסבר איך לגבות טבלה ולשחזר אותה מגיבוי לטבלה חדשה.

אם מפעילים גיבוי אוטומטי כשיוצרים טבלה, אפשר לשנות אחר כך את הגדרת הגיבוי האוטומטי של הטבלה. אתם יכולים להפעיל או להשבית את הגיבוי האוטומטי, להגדיר גיבויים אוטומטיים חמים במכונות SSD, לשנות את תקופת השמירה ל-90 יום לכל היותר, או לבחור את האשכולות שבהם Bigtable שומר גיבויים במהדורת Enterprise Plus. מידע נוסף זמין במאמר שימוש בגיבוי אוטומטי.

הפעלה, השבתה או הגדרה של סנכרון שינויים בזרמי נתונים

במאמר הגדרת סנכרון שינויים בזרמי נתונים מוסבר איך לבצע את המשימות הבאות:

• הפעלת סנכרון שינויים בזרמי נתונים בטבלה קיימת
• השבתת סנכרון שינויים בזרמי נתונים
• עדכון תקופת השמירה של סנכרון שינויים בזרמי נתונים

מחיקת טבלה

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

אזהרה: כשמוחקים טבלה, מוחקים גם את הנתונים שמאוחסנים בה.

המסוף

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על בטבלה שרוצים למחוק.

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

6. כדי לאשר שאתם מודעים לכך שהפעולה הזו תמחק את הטבלה מכל האשכולות במכונה, ושיש לכם רק שבעה ימים לבטל את המחיקה של הטבלה, הקלידו את מזהה הטבלה בתיבה Delete table.

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

gcloud

1. כדי למחוק טבלאות, מריצים את הפקודה gcloud bigtable instances tables delete.

   gcloud bigtable instances tables delete TABLE_ID --instance=INSTANCE_ID
   

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

   • ‫TABLE_ID: המזהה הייחודי של הטבלה
   • ‫INSTANCE_ID: מזהה המכונה

2. בטרמינל, מזינים y כדי לאשר את מחיקת הטבלה.

cbt

כדי למחוק טבלה, מריצים את הפקודה הבאה:

cbt deletetable TABLE_ID

מחליפים את TABLE_ID במזהה הייחודי של הטבלה.

ביטול מחיקת טבלה

אם מחקתם טבלה בטעות, אתם יכולים להשתמש בפקודה bigtable instances tables undelete ב-CLI של gcloud כדי לבטל את המחיקה או לשחזר את הטבלה. אל תנסו ליצור מחדש באופן ידני את הטבלה שנמחקה.

כדי לבטל מחיקה של טבלה, מריצים את הפקודה הבאה במסוף:

gcloud bigtable instances tables undelete TABLE_ID --instance=INSTANCE_ID

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

• ‫TABLE_ID: המזהה הייחודי של הטבלה
• ‫INSTANCE_ID: מזהה המכונה

כשמבטלים מחיקה של טבלה, Bigtable מפעיל באופן אוטומטי את ההגנה מפני מחיקה של הטבלה.

המגבלות הבאות חלות:

• אפשר לבטל את המחיקה של טבלה במשך בערך שבעה ימים מרגע המחיקה.
• אי אפשר לבטל את המחיקה של טבלה באמצעות מסוף Google Cloud , ספריות הלקוח של Cloud Bigtable או ה-CLI של cbt.
• אי אפשר לבטל את המחיקה של טבלה מתוך מכונה שנמחקה.
• אי אפשר לבטל את המחיקה של טבלה שהופעל בה CMEK.
• אם משנמכים את המכונה למהדורת Enterprise, אי אפשר לבטל את המחיקה של טבלה עם פירוט חותמת זמן של מיקרו-שניות. כדי לבטל מחיקה של טבלה, המכונה צריכה להיות במהדורת Enterprise Plus.
• כשאתם מבטלים מחיקה של טבלה, Bigtable לא משחזר את קישורי המדיניות של IAM ברמת פירוט גבוהה לטבלה שנמחקה.

אפשר לבדוק את הסטטוס של הפעולה undelete ביומני הביקורת.

שינוי ההגנה מפני מחיקה

אתם יכולים להפעיל או להשבית את ההגנה מפני מחיקה של טבלה אם אתם חשבון משתמש בתפקיד שכולל את ההרשאה bigtable.tables.update, כמו roles/bigtable.admin. ההגנה מפני מחיקה מונעת את המחיקה של הטבלה, של כל קבוצות העמודות בטבלה ושל המכונה שמכילה את הטבלה.

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

המסוף

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על לצד מזהה הטבלה.

5. כדי להפעיל את ההגנה מפני מחיקה, לוחצים על מניעת מחיקה. כדי להשבית את ההגנה מפני מחיקה, לוחצים על Enable deletion. רק האפשרות התקינה מוצגת.

gcloud

כדי להפעיל הגנה מפני מחיקה בטבלה, מריצים את הפקודה gcloud bigtable instances tables update:

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --deletion-protection

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

• ‫TABLE_ID: המזהה הייחודי של הטבלה
• ‫INSTANCE_ID: מזהה המכונה

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

gcloud bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --no-deletion-protection

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

• ‫TABLE_ID: המזהה הייחודי של הטבלה
• ‫INSTANCE_ID: מזהה המכונה

cbt

אי אפשר להשתמש ב-CLI של cbt כדי להפעיל או להשבית את ההגנה מפני מחיקה.

שינוי סף הגיל של אחסון עם גישה לא תכופה

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

המסוף

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על Edit בטבלה שרוצים לשנות.

5. בשדה Age threshold, מזינים את מספר הימים החדש שאחריו Bigtable יעביר את הנתונים מאחסון SSD לאחסון עם גישה לא תכופה. המספר חייב להיות 30 או יותר.

gcloud

כדי לשנות את סף הגיל של אחסון בגישה לא תכופה, מריצים את הפקודה gcloud beta bigtable instances tables update עם הדגל --tiered-storage-infrequent-access-older-than:

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --tiered-storage-infrequent-access-older-than=AGE_THRESHOLD

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

• ‫TABLE_ID: המזהה של הטבלה שרוצים לעדכן
• ‫INSTANCE_ID: מזהה המכונה
• ‫PROJECT_ID: הפרויקט שמכיל את הטבלה שרוצים לעדכן
• ‫AGE_THRESHOLD: סף הגיל, שחייב להיות לפחות 30 ימים. יחידות הזמן הקבילות הן ימים (d), שעות (h), דקות (m) ושניות (s) – לדוגמה, מ-32d בעבר עד 33d.

השבתת אחסון עם גישה לא תכופה

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

המסוף

1. במסוף Google Cloud , פותחים את רשימת המכונות של Bigtable.

   פתיחת רשימת המכונות

2. לוחצים על המכונה שרוצים לראות את הטבלאות שלה.

3. לוחצים על Tables בחלונית הימנית.

   בדף Tables מוצגת רשימת הטבלאות במכונה.

4. לוחצים על Edit בטבלה שרוצים לשנות.

5. מבטלים את הסימון בתיבה Enable tiered storage.

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

gcloud

כדי להשבית את האחסון בגישה לא תכופה, מפעילים את הפקודה gcloud beta bigtable instances tables update עם הדגל --clear-tiered-storage-config:

gcloud beta bigtable instances tables update TABLE_ID \
    --instance=INSTANCE_ID \
    --project=PROJECT_ID \
    --clear-tiered-storage-config

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

• ‫TABLE_ID: המזהה של הטבלה שרוצים לעדכן
• ‫INSTANCE_ID: מזהה המכונה
• ‫PROJECT_ID: הפרויקט שמכיל את הטבלה שרוצים לעדכן

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

• איך מייבאים נתונים לטבלה ומייצאים נתונים ממנה