Python hello world
הדוגמה הזו היא אפליקציית "hello world" שכתובה ב-Python, וממחישה איך:
- מגדירים אימות.
- מתחברים למכונה של Bigtable.
- ליצור טבלה חדשה.
- כתיבת נתונים בטבלה.
- קוראים את הנתונים בחזרה.
- מוחקים את הטבלה.
ספריית הלקוח של Python ל-Bigtable מציעה שני ממשקי API, asyncio וממשק API סינכרוני. אם האפליקציה שלכם אסינכרונית, אתם צריכים להשתמש ב-asyncio.
מגדירים אימות
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Python שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
-
אם אתם משתמשים במעטפת מקומית, צרו פרטי כניסה לאימות מקומי בחשבון המשתמש:
gcloud auth application-default login
אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.
אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
מריצים את הדוגמה
בדוגמה הזו משתמשים בחבילת Bigtable של ספריות הלקוח של Cloud ל-Python כדי לתקשר עם Bigtable. חבילת Bigtable היא הבחירה הטובה ביותר לאפליקציות חדשות. אם אתם צריכים להעביר עומס עבודה קיים של HBase אל Bigtable, תוכלו לעיין בדוגמה 'hello world' שמשתמשת בחבילת HappyBase.
כדי להריץ את תוכנית הדוגמה הזו, פועלים לפי ההוראות לדוגמה ב-GitHub.
שימוש בספריות הלקוח של Cloud עם Bigtable
אפליקציית הדוגמה מתחברת ל-Bigtable ומדגימה כמה פעולות.
התקנה וייבוא של ספריית הלקוח
משתמשים ב-PIP כדי להתקין את חבילות Python הנדרשות בסביבת virtualenv. הדוגמה כוללת קובץ דרישות שמגדיר את החבילות הנדרשות.
מייבאים את המודולים.
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
התחברות ל-Bigtable
מתחברים ל-Bigtable באמצעות bigtable.Client.
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
צור טבלה
יוצרים מופע של אובייקט טבלה באמצעות Instance.table(). יוצרים קבוצת עמודות ומגדירים את מדיניות איסוף האשפה שלה, ואז מעבירים את קבוצת העמודות אל Table.create() כדי ליצור את הטבלה.
כתיבת שורות בטבלה
מבצעים לולאה ברשימה של מחרוזות ברכה כדי ליצור כמה שורות חדשות לטבלה.
בכל איטרציה, משתמשים ב-Table.row() כדי להגדיר שורה ולהקצות לה מפתח שורה, קוראים ל-Row.set_cell() כדי להגדיר ערך לתא הנוכחי ומצרפים את השורה החדשה למערך של שורות.
לבסוף, קוראים לפונקציה Table.mutate_rows() כדי להוסיף את השורות לטבלה.
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
יצירת מסנן
לפני שקוראים את הנתונים שכתבתם, צריך ליצור מסנן באמצעות row_filters.CellsColumnLimitFilter() כדי להגביל את הנתונים שמוחזרים מ-Bigtable. המסנן הזה אומר ל-Bigtable להחזיר רק את התא האחרון בכל עמודה, גם אם הטבלה מכילה תאים ישנים יותר שעדיין לא הוסרו במהלך איסוף האשפה.
Asyncio
במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
במאמר ספריות הלקוח של Bigtable מוסבר איך להתקין את ספריית הלקוח ולהשתמש בה ב-Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
קריאת שורה לפי מפתח השורה
קוראים לשיטה Table.read_row() של הטבלה כדי לקבל הפניה לשורה עם מפתח שורה ספציפי, מעבירים את המפתח ואת המסנן כדי לקבל גרסה אחת של כל ערך בשורה הזו.
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סריקת כל השורות בטבלה
כדי לקרוא טווח של שורות מטבלה, משתמשים ב-Table.read_rows().
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
מחיקת טבלה
מחיקת טבלה באמצעות Table.delete().
סיכום של כל המידע
זוהי הדוגמה המלאה ללא הערות.
Asyncio
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.
סנכרון
מידע על התקנת ספריית הלקוח של Bigtable ושימוש בה מופיע במאמר ספריות הלקוח של Bigtable.
כדי לבצע אימות ב-Bigtable, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.