Bigtable

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

גרסאות נתמכות

המחבר הזה תומך בגרסה 2 של Google Bigtable.

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

לפני שמשתמשים במחבר Bigtable, צריך לבצע את הפעולות הבאות בפרויקט Google Cloud :

• מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
• נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
• מקצים את התפקידים roles/secretmanager.viewer ו-roles/secretmanager.secretAccessor ב-IAM לחשבון השירות שבו רוצים להשתמש עבור המחבר.
• מפעילים את השירותים הבאים:
  • ‫secretmanager.googleapis.com (Secret Manager API)
  • ‫connectors.googleapis.com (Connectors API)

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

הגדרת המחבר

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

1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

   כניסה לדף Connections

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

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

   2. לוחצים על הבא.
4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
   1. מחבר: בוחרים באפשרות Bigtable מהרשימה הנפתחת של המחברים הזמינים.
   2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
   3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

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

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
   4. אופציונלי: מזינים תיאור למופע החיבור.
   5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
   6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
   7. ‫Project ID: מזהה הפרויקט שמכיל את מופע Bigtable.
   8. ‫Instance ID: מזהה מכונת Bigtable.
   9. גודל מאגר החיבורים: גודל מאגר החיבורים של Bigtable.
   10. אופציונלי: מגדירים את ההגדרות של צומת החיבור:
       • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
       • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

   הערה: אפשר להתאים אישית את הערכים של צומת החיבור רק אם אתם לקוחות עם תשלום לפי שימוש.
   11. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
   12. לוחצים על הבא.
5. בקטע אימות, מזינים את פרטי האימות.
   1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      סוגי האימות הבאים נתמכים בחיבור ל-Bigtable:

      • אימות באמצעות חשבון שירות
      • ‫OAuth 2.0 – קוד הרשאה

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

   2. לוחצים על הבא.
6. בדיקה: בודקים את פרטי החיבור והאימות.
7. לוחצים על יצירה.

הגדרת אימות

מזינים את הפרטים בהתאם לאימות שבו רוצים להשתמש.

• אימות חשבון שירות: מוודאים שלחשבון השירות יש את התפקידים הנדרשים.

• OAuth 2.0 - קוד הרשאה
  • Client ID: מזהה הלקוח שסופק על ידי האפליקציה.
  • היקפים: רשימה של היקפים רצויים
  • סוד לקוח: סוד ב-Secret Manager שמכיל את סוד הלקוח של האפליקציה.
  • גרסת סוד: גרסת הסוד שנבחרה למעלה.

דוגמאות להגדרת חיבור

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

סוג החיבור לאימות של חשבון שירות

שם השדה	פרטים
מיקום	asia-east1
גרסה	1
מחבר	Bigtable
גרסת המחבר	1
שם החיבור	googlecloud-bigtable-service-authontication
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מזהה הפרויקט	PROJECT_ID
מזהה מופע	gcloud-bigtable-instance
גודל מאגר החיבורים	1
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
סוד לקוח	bigtable-client-secret
Secret Version	1

‫OAuth 2.0 – סוג החיבור של קוד הרשאה

שם השדה	פרטים
מיקום	asia-east1
גרסה	1
מחבר	Bigtable
גרסת המחבר	1
שם החיבור	bigtable-oauth
חשבון השירות	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מזהה הפרויקט	PROJECT_ID
מזהה מופע	googlecloud-bigtable-instance
גודל מאגר החיבורים	1
מספר הצמתים המינימלי	2
מספר הצמתים המקסימלי	50
סוד לקוח	bigtable-client-secret
Secret Version	1

מגבלות המערכת

מחבר Bigtable יכול לעבד עד 16 עסקאות בשנייה, לכל צומת, ומגביל את כל העסקאות שחורגות מהמגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

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

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

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

שימוש בחיבור Bigtable בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

• כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
• מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

ישויות, פעולות ופעולות

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

הערה: אפשר לראות את הישויות, הפעולות והפעולות של מחבר במשימת המחברים.

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

  עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

• פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:
  • רשימה
  • הרשמה
  • יצירה
  • עדכון
  • מחיקה

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

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

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

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – שליפת רשומה מטבלה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Table מהרשימה Entity.
3. בוחרים את הפעולה Get ולוחצים על סיום.
4. מגדירים את מזהה הישות ל-Get Operation. כדי להגדיר את מזהה הישות, בקטע מיפוי נתונים של מיפוי הנתונים, לוחצים על פתיחת הכלי לעריכת מיפוי נתונים ואז מזינים row99 בשדה ערך קלט ובוחרים באפשרות EntityId כמשתנה מקומי.

דוגמה – הצגת כל הרשומות מטבלה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
2. בוחרים באפשרות Table מהרשימה Entity.
3. בוחרים את הפעולה List ולוחצים על סיום.

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

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities and select Table2.
2. בוחרים את הפעולה Create ולוחצים על סיום.
3. מגדירים את RowKey לפעולת יצירה. כדי להגדיר את RowKey, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים בשדה Input Value (ערך קלט) ומספקים את RowKey ואת Payload עבור קבוצת עמודות כמשתנה מקומי.

דוגמה – עדכון רשומה בטבלה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities and select Table.
2. בוחרים את הפעולה Update ולוחצים על סיום.
3. מגדירים את מזהה הישות לפעולת עדכון. כדי להגדיר את מזהה הישות, בקטע Data Mapper (מיפוי נתונים) של Data Mapping (מיפוי נתונים), לוחצים על Open Data Mapping Editor (פתיחת כלי מיפוי הנתונים), מזינים בשדה Input Value (ערך קלט) ומספקים את RowKey (מפתח שורה) ואת מטען הייעודי (payload) של קבוצת העמודות כמשתנה מקומי.

דוגמה – מחיקת רשומה מטבלה

1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities and select Table2.
2. בוחרים את הפעולה Delete ולוחצים על סיום.
3. מגדירים את מזהה הישות לפעולת מחיקה. כדי להגדיר את מזהה הישות, בקטע Data Mapper של Data Mapping, לוחצים על Open Data Mapping Editor, מזינים row99 בשדה Input Value ובוחרים באפשרות EntityId בתור Local variable.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

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

• איך משעים ומחדשים חיבור
• איך עוקבים אחרי השימוש בכלי לחיבור נתונים
• איך צופים ביומני המחברים