Dataverse

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

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

לפני שמשתמשים במחבר Dataverse, צריך לבצע את המשימות הבאות:

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • נותנים למשתמש שמגדיר את המחבר את תפקיד ה-IAM‏ roles/connectors.admin.
    • מקצים לחשבון השירות שרוצים להשתמש בו עבור המחבר את תפקידי ה-IAM הבאים:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

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

    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

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

    כניסה לדף Connections

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

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

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

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

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

      • מספר מינימלי של צמתים: מזינים את המספר המינימלי של צמתי חיבור.
      • מספר הצמתים המקסימלי: מזינים את מספר צמתי החיבור המקסימלי.

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

    8. דייר Azure: הדייר של Microsoft Online שמשמש לגישה לנתונים. אם לא תציינו דייר, המערכת תשתמש בדייר שמוגדר כברירת מחדל.
    9. כתובת ה-URL של הארגון: כתובת ה-URL לנתוני Microsoft Dataverse. לדוגמה, https://abc123.crm.dynamics.com/‎.
    10. דייר: הדייר של מיקרוסופט שמשמש לגישה לנתונים. אם לא מציינים דייר, המערכת משתמשת בדייר ברירת המחדל.
    11. אם רוצים, בשדה גרסת ה-API, מציינים את גרסת ה-API שבה רוצים להשתמש. אם תפורסם גרסה חדשה של ה-API, תוכלו לציין את הגרסה הזו בשדה הזה.
    12. אם רוצים שהספק יוכל להשתמש בשמות לתצוגה עבור פעולות, מסמנים את התיבה Use Display Names (שימוש בשמות לתצוגה).
    13. סכימה: בוחרים את הסכימה שרוצים להשתמש בה.
    14. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    15. בקטע SSL Configuration (הגדרת SSL), בוחרים מודל מהימן:
      • ציבורי: אישורים ציבוריים שנבחרו ממאגר ברירת המחדל של אישורים מהימנים.
      • פרטי: אישורים בחתימה עצמית או אישורים שהונפקו על ידי רשויות אישורים פרטיות
      • חיבור לא מאובטח: מתן אמון בכל האישורים. מומלץ להשתמש במודל אמון ציבורי או פרטי.
  5. בקטע אימות, מזינים את פרטי האימות. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

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

הגדרת אימות

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

  • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
  • היקף: רשימה מופרדת בפסיקים של ההיקפים הרצויים.
  • סוד לקוח: סוד הלקוח שמשמש לבקשת טוקנים של גישה.
  • כתובת URL לאישור: כתובת URL לאישור שנוצרת כשיוצרים לקוח.

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

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

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

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

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

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

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

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

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

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

פעולות

מחבר Dataverse מספק פעולות כמו ListAssociations ו-ListNavigationProperties. כדי להבין איך להגדיר את הפעולות, אפשר לעיין בדוגמאות לפעולות.

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

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

דוגמה – ListAssociations

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ListAssociations ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
     {
  FromId:"etywe325632io100",
  FromTable:"Customers",
  "NavigationProperty":"asyncoperations"
  }

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

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

בדוגמה הזו מפורטות כל הרשומות בטבלה User defined.

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

דוגמה – קבלת משתמש על סמך מזהה

בדוגמה הזו, המשתמש עם newTableId ‏568ea947-e03d-ef11-8409-7c1e5217e912 מתקבל מהישות Users.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Custom Table מהרשימה Entity.
  3. בוחרים את הפעולה GET ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 568ea947-e03d-ef11-8409-7c1e5217e912 בשדה Default Value (ערך ברירת מחדל).

    כאן, newTableId הוא ערך המפתח הראשי של הישות Custom Table.

  5. לוחצים על סיום.

יצירת חיבורים באמצעות Terraform

אפשר להשתמש במשאב של Terraform כדי ליצור חיבור חדש.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

כדי לראות תבנית לדוגמה של Terraform ליצירת חיבור, אפשר לעיין בתבנית לדוגמה.

כשיוצרים את החיבור הזה באמצעות Terraform, צריך להגדיר את המשתנים הבאים בקובץ ההגדרות של Terraform:

שם הפרמטר סוג נתונים חובה תיאור
מסד נתונים מחרוזת לא נכון השם של מסד הנתונים SAP HANA.
browsable_schemas מחרוזת לא נכון המאפיין הזה מגביל את הסכימות שמדווחות לקבוצת משנה של הסכימות הזמינות. לדוגמה, BrowsableSchemas=SchemaA,SchemaB,SchemaC.
include_system_objects בוליאני לא נכון מגדירים את IncludeSystemObjects ל-True כדי לאחזר את הסכימה והטבלאות של מערכת Hana.
include_table_types בוליאני לא נכון אם המדיניות מוגדרת כ-true, הספק ידווח על הסוגים של טבלאות ותצוגות נפרדות.
session_variables מחרוזת לא נכון רשימה מופרדת בפסיקים של משתני סשן להגדרה בחיבור הנוכחי.
enable_logging ENUM לא נכון הגדרה שמאפשרת להגדיר את רמת הפירוט של הרישום ביומן במהלך חיבור, על ידי בחירת רמה בין 1 (הכי פחות מפורט) ל-5 (הכי מפורט). התכונה הזו יכולה לעזור לפתור בעיות שקשורות להודעות שגיאה או להתנהגות לא צפויה אחרת. עם זאת, חשוב לדעת שהאפשרות הזו תתעד את כל פרטי התקשורת, כולל בקשות, תגובות ואישורי SSL, בין המחבר לבין העורף. לכן לא מומלץ להשתמש בפונקציה הזו בסביבת ייצור פעילה. הערכים הנתמכים הם: 1, ‏ 2, ‏ 3, ‏ 4, ‏ 5

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

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

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

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

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

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