HappyBase API hello world
הדוגמה הזו היא אפליקציית hello world פשוטה מאוד, שנכתבה ב-Python, שממחישה איך:
- מגדירים אימות
- מתחברים למכונה של Bigtable.
- ליצור טבלה חדשה.
- כתיבת נתונים בטבלה.
- קוראים את הנתונים בחזרה.
- מוחקים את הטבלה.
מגדירים אימות
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Python שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.
-
יוצרים פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם מוחזרת שגיאת אימות, צריך לוודא ש נכנסתם ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
הרצת הדוגמה
בדוגמה הזו משתמשים בחבילת HappyBase של ספריית הלקוח של Google Cloud ל-Python, הטמעה של ממשקי ה-API של HappyBase, כדי לתקשר עם Bigtable. אם אתם צריכים להעביר עומס עבודה קיים של HBase אל Bigtable, אתם יכולים להשתמש בחבילת HappyBase. לגבי אפליקציות חדשות, אפשר לעיין בדוגמה 'hello world' שמשתמשת בחבילת Bigtable.
כדי להריץ את תוכנית הדוגמה הזו, פועלים לפי ההוראות לדוגמה ב-GitHub.
שימוש בממשקי ה-API של HappyBase עם Bigtable
האפליקציה לדוגמה מתחברת ל-Bigtable ומדגימה כמה פעולות פשוטות.
התקנה וייבוא של ספריית הלקוח
אפשר להתקין את חבילות Python הנדרשות באמצעות PIP בסביבת virtualenv. הדוגמה כוללת קובץ דרישות שמגדיר את החבילות הנדרשות.
אחר כך אפשר לייבא את המודולים.
התחברות ל-Bigtable
מתחברים ל-Bigtable על ידי העברת bigtable.Client אל happybase.Connection.
יצירת טבלה
משתמשים ב-Connection.create_table() כדי ליצור טבלה ומשפחות עמודות.
כתיבת שורות בטבלה
קבלת מינוי קיים ל-Table עם Connection.table(). משתמשים ב-Table.put() כדי לכתוב שורה בטבלה.
קריאת שורה לפי המפתח שלה
אפשר לאחזר שורה ישירות באמצעות המפתח שלה עם Table.row().
סריקת כל השורות בטבלה
משתמשים ב-Table.scan() כדי לקבל טווח של שורות.
מחיקת טבלה
מחיקת טבלה באמצעות Connection.delete_table().
איך הכל משתלב יחד
זוהי הדוגמה המלאה ללא הערות.