שלום עולם ב-C#
דוגמת הקוד הזו היא אפליקציית Hello World שכתובה ב-C#. בדוגמה הזו מוסבר איך לבצע את הפעולות הבאות:
- מגדירים אימות
- התחברות למכונה של Bigtable
- ליצור טבלה חדשה.
- כתיבת נתונים בטבלה.
- קוראים את הנתונים בחזרה.
- מוחקים את הטבלה.
מגדירים אימות
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של .NET שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.
-
התקינו את ה-CLI של Google Cloud.
-
הגדירו שה-CLI של gcloud ישתמש בזהות המאוחדת שלכם.
-
יוצרים פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
gcloud auth application-default login
אם מוחזרת שגיאת אימות, צריך לוודא ש נכנסתם ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית.
הרצת הדוגמה
הקוד הזה מתקשר עם Bigtable באמצעות הספריות C# Admin API ו-C# Data API בספריות הלקוח של Google Cloud ל- .NET.
כדי להריץ את התוכנית לדוגמה הזו, פועלים לפי ההוראות של .NET Bigtable Samples ב-GitHub.
כדי ליצור משאבים שאפשר להשתמש בהם באפליקציית Hello World, צריך להשלים את השלבים במאמרים Build and Run וQuick Start. חשוב לערוך את הקובץ HelloWorld.cs כדי להוסיף את שמות המשאבים שאתם יוצרים.
שימוש בספריות הלקוח של Cloud עם Bigtable
אפליקציית הדוגמה מתחברת ל-Bigtable ומדגימה כמה פעולות פשוטות.
התחברות ל-Bigtable
כדי להתחיל, יוצרים שני אובייקטים של לקוח שאפשר להשתמש בהם כדי להתחבר ל-Bigtable. ממשקי ה-Admin API ב-C# BigtableTableAdminClient עוזרים ליצור ולמחוק מכונות וטבלאות. ממשקי ה-API של C#
Data BigtableClient עוזרים לקרוא ולכתוב נתונים בטבלה.
יצירת טבלה
קוראים לשיטה CreateTable() במחלקה BigtableTableAdminClient כדי ליצור אובייקט Table שמאחסן את הברכות hello world. בטבלה יש קבוצת עמודות אחת ששומרת גרסה אחת של כל ערך.
כתיבת שורות בטבלה
משתמשים במערך המחרוזות s_greetings[], שמכיל שלוש ברכות פשוטות, כמקור נתונים לכתיבה לטבלה. קודם כל, כותבים שורה אחת בטבלה באמצעות MutateRow(). אחר כך עוברים בלולאה על שאר המערך כדי ליצור אובייקט MutateRowsRequest שמכיל רשומה לכל ברכה. מבקשים מ-MutateRows() לכתוב את כל הרשומות בבת אחת. לאחר מכן, חוזרים על התהליך עבור התשובה שהתקבלה כדי לבדוק את קוד הסטטוס של כל רשומה ולוודא שהיא נכתבה בהצלחה.
יצירת מסנן
לפני שקוראים את הנתונים שכתבתם, צריך ליצור מסנן כדי להגביל את הנתונים שמוחזרים מ-Bigtable. המסנן הזה מורה ל-Bigtable להחזיר רק את הגרסה האחרונה של כל ערך, גם אם הטבלה מכילה תאים ישנים יותר שמתאימים לאיסוף אבל עדיין לא נמחקו.
קריאת שורה לפי מפתח השורה
משתמשים ב-method ReadRow() ומעבירים את המסנן שיצרתם כדי לקבל גרסה אחת של כל ערך בשורה הזו.
סריקת כל השורות בטבלה
מבצעים קריאה ל-method ReadRows() ומעבירים את המסנן כדי לקבל את כל השורות בטבלה. בגלל שהעברתם את המסנן, Bigtable מחזיר רק גרסה אחת של כל ערך.
מחיקת טבלה
מוחקים את הטבלה באמצעות השיטה DeleteTable().
איך הכל משתלב יחד
הנה דוגמת הקוד המלאה בלי הערות.