C++ hello world
בדוגמה הזו מוצגת אפליקציית hello world פשוטה, שנכתבה ב-C++, שממחישה איך לבצע את הפעולות הבאות:
- מגדירים אימות
- מתחברים למכונה של Bigtable.
- ליצור טבלה חדשה.
- כתיבת נתונים בטבלה.
- קוראים את הנתונים בחזרה.
- מוחקים את הטבלה.
מגדירים אימות
כדי להשתמש בדוגמאות של C++ שבדף הזה בסביבת פיתוח מקומית, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.
-
יוצרים פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם מוחזרת שגיאת אימות, צריך לוודא ש נכנסתם ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
למידע נוסף, ראו הגדרת אימות לסביבת פיתוח מקומית.
הרצת הדוגמה
בדוגמה הזו משתמשים בחבילת Cloud Bigtable של ספריית הלקוח שלCloud de Confiance by S3NS ל-C++ כדי לתקשר עם Bigtable.
כדי להריץ את תוכנית הדוגמה הזו, פועלים לפי ההוראות ב-GitHub.
שימוש ב Cloud de Confiance ספריית הלקוח עם Bigtable
אפליקציית הדוגמה מתחברת ל-Bigtable ומדגימה כמה פעולות פשוטות.
התקנה וייבוא של ספריית הלקוח
מורידים או משכפלים את ספריית הלקוח של Bigtable ב-C++ מ-GitHub, ואז מקמפלים אותה. פועלים לפי ההוראות של הקומפיילר בקובץ README ברמה העליונה.
כוללים את הכותרות הנדרשות.
התחברות ל-Bigtable
תשתמש ב-MakeBigtableTableAdminConnection() כדי ליצור BigtableTableAdminClient, שבו תשתמש כדי ליצור טבלה.
יצירת טבלה
מגדירים סכימה לטבלה עם קבוצת עמודות אחת. הגדר כלל איסוף אשפה עבור משפחת העמודות כדי לשמור גרסה אחת לכל היותר של כל ערך. משתמשים בסכימה הזו כדי ליצור אובייקט טבלה באמצעות BigtableTableAdminClient::CreateTable(). לאחר מכן יוצרים לקוח נתונים שאפשר להשתמש בו כדי להכניס נתונים לטבלה ולהוציא נתונים מהטבלה.
כתיבת שורות בטבלה
מבצעים לולאה ברשימה של מחרוזות ברכה כדי ליצור כמה שורות חדשות לטבלה.
בכל איטרציה, משתמשים ב-SingleRowMutation כדי להגדיר שורה ולהקצות לה מפתח וערך. לאחר מכן מתקשרים אל Table::Apply() כדי להחיל את המוטציה על השורה.
יצירת מסנן
לפני שקוראים את הנתונים שכתבתם, צריך ליצור מסנן באמצעות Filter::ColumnRangeClosed() כדי להגביל את הנתונים שמוחזרים מ-Bigtable. המסנן הזה אומר ל-Bigtable להחזיר רק את הגרסה האחרונה של כל ערך, גם אם הטבלה מכילה תאים ישנים שתוקף השימוש בהם פג אבל הם עדיין לא הוסרו על ידי איסוף האשפה.
קריאת שורה לפי המפתח שלה
קוראים לפונקציה Table::ReadRow(), מעבירים את מפתח השורה ואת המסנן,
כדי לקבל גרסה אחת של כל ערך בשורה הזו.
סריקת כל השורות בטבלה
כדי לקרוא טווח של שורות מהטבלה, משתמשים ב-Table::ReadRows().
מחיקת טבלה
מחיקת הטבלה באמצעות BigtableTableAdminClient::DeleteTable().
איך הכל משתלב יחד
זוהי הדוגמה המלאה ללא הערות.