הגדרת מאגר נתונים של Microsoft SharePoint

בדף הזה מוסבר איך ליצור מאגר נתונים ולקשר את Microsoft SharePoint ל-Gemini Enterprise.

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

לפני שמגדירים חיבור מאוחד ל-Microsoft SharePoint, צריך לוודא את הדברים הבאים:

  1. נותנים את תפקיד העורך של Discovery Engine ‏ (roles/discoveryengine.editor). התפקיד הזה נדרש כדי שהמשתמש יוכל ליצור את מאגר הנתונים. כדי להעניק את התפקיד הזה:

    1. נכנסים לדף IAM במסוף Google Cloud .

      כניסה לדף IAM

    2. מאתרים את חשבון המשתמש ולוחצים על עריכה עריכה.
    3. מקצים למשתמש את התפקיד Discovery Engine Editor. למידע נוסף, ראו תפקידים והרשאות ב-IAM.

  2. רושמים את Gemini Enterprise כאפליקציית OAuth 2.0 ב-Microsoft Entra ID ומקבלים את פרטי הכניסה הבאים:

    • מזהה לקוח

    • סוד לקוח

    • מזהה דייר (tenant)

    • URI של מופע

  3. מגדירים את הרשאות ה-API של מיקרוסופט בהסכמת אדמין של מיקרוסופט שארפוינט.

יצירת מאגר נתונים של Microsoft SharePoint

כדי ליצור מאגר נתונים של Microsoft SharePoint:

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    ‫Gemini Enterprise

  2. בוחרים פרויקט קיים או יוצרים פרויקט חדש ב- Google Cloud .

  3. בתפריט הניווט, לוחצים על מאגרי נתונים.

  4. לוחצים על יצירת מאגר נתונים.

  5. בקטע מקור, מחפשים את Microsoft SharePoint ולוחצים על בחירה.

  6. בקטע נתונים:

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

    2. לוחצים על Continue.

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

      1. מספקים את פרטי האימות הבאים לפי הצורך:
        • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה במזהה Microsoft Entra של הארגון.
        • סוד הלקוח: המפתח הסודי שנוצר במהלך תהליך רישום האפליקציה ב-OAuth 2.0 ב-Microsoft Entra ID.
        • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra.
        • URI של המופע: כתובת ה-URL הבסיסית של מופע Microsoft SharePoint (לדוגמה, https://{your-domain}.sharepoint.com).
        • סוג הסביבה של Microsoft SharePoint: בוחרים את הסביבה שמארחת את הדייר של Microsoft 365:
          • בוחרים באפשרות רגילה (ברירת המחדל) אם מתחברים ל-Microsoft 365 מסחרי רגיל או ל-Government Community Cloud‏ (GCC).
          • בוחרים באפשרות US Government (ממשלת ארה"ב) אם מתחברים לענן ריבוני של Microsoft 365 US Government (GCC High או DoD).

        מידע נוסף זמין במאמר בנושא קבלת פרטי כניסה של לקוח.

      • אם בחרתם באפשרות Data ingestion עם שיטת האימות Federated credentials, מעתיקים את Subject identifier ומשתמשים בו כדי להוסיף federated credential להעברת נתונים.

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

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

    4. לוחצים על Continue.

    5. אם בחרתם באפשרות חיפוש מאוחד, יופיע הקטע יעדים. מזינים את כתובת ה-URL הבסיסית של האתר.

    6. לוחצים על Continue.

    7. בקטע Advanced options, בוחרים את Microsoft 365 Cloud Environment:

      • אם אתם מתחברים למופע של Microsoft 365 US Government, בוחרים באפשרות שמתאימה לו: GCC,‏ GCC High או DoD.
      • אחרת, משאירים את ברירת המחדל Global.

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

      אפשר להוסיף מסננים למאגר הנתונים באמצעות Google Cloud המסוף או ה-API:

      המסוף

      הערה: כשמזינים כמה אתרים, צריך להפריד בין כתובות ה-URL באמצעות פסיק. אפשר גם להעתיק ולהדביק רשימה של כתובות URL ישירות מקובץ CSV.

      1. בקטע Site filter (מסנן אתרים):
        • בוחרים את סוג המסנן: הכללה בחיפוש או החרגה מהחיפוש.
        • בשדה מסנן כתובות URL של אתרים, מזינים את כתובות ה-URL המדויקות של אתרי Microsoft SharePoint לסינון, בפורמט https://{your-tenant}.sharepoint.com/sites/{your-site-name}.

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

      2. בקטע Path filter (מסנן נתיבים):
        • בוחרים את סוג המסנן: הכללה בחיפוש או החרגה מהחיפוש.
        • בשדה Path filter, מזינים את הנתיבים המלאים של SharePoint.

          הערה: השדה הזה תומך בנתיבי משנה, בתיקיות ובספריות מסמכים, בפורמט https://{your-tenant}.sharepoint.com/sites/{your-site-name}/{your-folder-name}/. כל תוכן שנמצא בנתיב שצוין יסונן.

      REST

      כדי להוסיף מסננים כשיוצרים מאגר נתונים, צריך להפעיל את השיטה setUpDataConnector.

      curl -X POST \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        -H "X-Goog-User-Project: PROJECT_ID" \
        "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
        -d '{
        "collectionId": "COLLECTION_ID",
        "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
        "dataConnector": {
            "dataSource": "sharepoint_federated_search",
            "params": {
            "client_id": "CLIENT_ID",
            "client_secret": "CLIENT_SECRET",
            "instance_uri": "INSTANCE_URI",
            "tenant_id": "TENANT_ID",
            "FILTER_TYPE": {
                "FILTER_KEY": [
                "FILTER_VALUE1",
                "FILTER_VALUE2"
                ]
            }
            },
            "entities": [
            {
                "entityName": "file"
            }
            ],
            "refreshInterval": "7200s",
            "connectorType": "THIRD_PARTY_FEDERATED",
            "connectorModes": [
            "FEDERATED"
            ]
        }
        }'

      מחליפים את מה שכתוב בשדות הבאים:

      • ‫PROJECT_ID: מזהה הפרויקט.
      • ‫ENDPOINT_LOCATION: האזור הרב-אזורי של בקשת ה-API. מציינים אחד מהערכים הבאים:
        • ‫us לאזור עם מספר אזורים בארה"ב
        • ‫eu לאזור עם מספר אזורים באיחוד האירופי
        • global למיקום הגלובלי
        מידע נוסף זמין במאמר בנושא הגדרת אזור גיאוגרפי מרובה למאגר הנתונים.
      • ‫LOCATION: האזור המרובה של מאגר הנתונים: global,‏ us או eu
      • ‫COLLECTION_ID: המזהה הייחודי של מאגר הנתונים.
      • ‫COLLECTION_DISPLAY_NAME: השם המוצג של מאגר הנתונים.
      • ‫CLIENT_ID: מזהה הלקוח לאימות ב-SharePoint.
      • ‫CLIENT_SECRET: סוד הלקוח לאימות ב-SharePoint.
      • ‫INSTANCE_URI: ה-URI של המופע של SharePoint.
      • ‫TENANT_ID: מזהה הדייר של SharePoint.
      • ‫FILTER_TYPE: סוג המסנן שנוסף למאגרי הנתונים של Microsoft SharePoint. מידע נוסף זמין במאמר בנושא סוגי מסננים.
      • ‫FILTER_KEY: המפתח של המסנן, שמתאים לשדה בנתונים. מידע נוסף זמין במאמר בנושא מפתחות סינון.
      • ‫FILTER_VALUES: הערך או הערכים שלפיהם רוצים לסנן את FILTER_KEY שצוין.

    לפרטים נוספים על סוגי מסננים ועל הוספת מסננים, אפשר לעיין במאמר הוספת מסננים למאגר נתונים של Microsoft SharePoint.

  7. לוחצים על Continue.

    1. בקטע Entities to search (אם בחרתם באפשרות Federated search) או Entities to sync (אם בחרתם באפשרות הטמעת נתונים):
      1. בוחרים את כל הישויות הנדרשות.
      2. אם בחרתם באפשרות חיפוש מאוחד, ממשיכים לשלב הבא.
      3. אם בחרתם באפשרות העברת נתונים, ממשיכים לשלבים הבאים:
        1. אופציונלי: כדי לסנכרן פרויקטים ספציפיים, מבצעים את הפעולות הבאות:
          1. לוחצים על סינון.
          2. כדי לסנן ישויות מהאינדקס, מסמנים את התיבה החרגה מהאינדקס. כדי לוודא שהן נכללות באינדקס, מסמנים את התיבה הכללה באינדקס.
          3. מזינים את המפתחות. מקישים על Enter אחרי כל מקש.
          4. לוחצים על Save.
        2. כדי להגדיר את תזמון הסנכרון:
          1. ברשימה תדירות הסנכרון, בוחרים את תדירות הסנכרון.
            • כדי לתזמן סנכרון מלא נפרד של נתוני ישויות וזהויות, מרחיבים את התפריט בקטע סנכרון מלא ובוחרים באפשרות אפשרויות בהתאמה אישית.
          2. ברשימה Incremental sync frequency (תדירות הסנכרון המצטבר), בוחרים את תדירות הסנכרון המצטבר. מידע נוסף זמין במאמר בנושא תזמון סנכרון.

  8. לוחצים על Continue.

  9. בקטע פעולות:

    1. אם בחרתם באפשרות חיפוש מאוחד:
      1. בקטע Select Microsoft SharePoint actions to enable (בחירת פעולות של Microsoft SharePoint להפעלה), בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן עבור המחבר.

    2. אם בחרתם באפשרות העברת נתונים:

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

        1. מספקים את פרטי האימות הבאים לפי הצורך:

          • מזהה לקוח: המזהה הייחודי של האפליקציה שרשומה במזהה Microsoft Entra של הארגון.
          • סוד הלקוח: המפתח הסודי שנוצר במהלך תהליך רישום האפליקציה ב-OAuth 2.0 ב-Microsoft Entra ID.
          • מזהה הדייר: המזהה הייחודי של הארגון שלכם במרכז הניהול של Microsoft Entra.
          • URI של המופע: כתובת ה-URL הבסיסית של מופע Microsoft SharePoint (לדוגמה, https://{your-domain}.sharepoint.com).

          מידע נוסף זמין במאמר בנושא קבלת פרטי כניסה של לקוח.

      2. לוחצים על Continue.

      3. בקטע יעדים, מזינים את כתובת ה-URL הבסיסית של האתר.

      4. לוחצים על Continue.

      5. בקטע Select Microsoft SharePoint actions to enable (בחירת פעולות של Microsoft SharePoint להפעלה), בוחרים את הפעולות מהקטגוריה כדי להפעיל אותן עבור המחבר.

  10. לוחצים על Continue.

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

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

  12. בקטע Configuration (הגדרה):

    1. ברשימה Multi-region, בוחרים את המיקום של מחבר הנתונים.
    2. בשדה Your data connector name (השם של מחבר הנתונים), מזינים שם למחבר.
    3. אם בחרתם במיקום us או eu, צריך להגדיר את הגדרות ההצפנה:
      • אופציונלי: אם לא הגדרתם מפתחות של אזור יחיד, לוחצים על מעבר לדף ההגדרות כדי לעשות זאת. מידע נוסף זמין במאמר בנושא רישום מפתח של אזור יחיד למחברים של צד שלישי.
      • בוחרים באפשרות מפתח הצפנה בניהולGoogle או מפתח Cloud KMS.
      • אם בחרתם באפשרות מפתח Cloud KMS:
        • ברשימה Key management type (סוג ניהול המפתחות), בוחרים את הסוג המתאים.
        • ברשימה Cloud KMS key בוחרים את המפתח.
      מידע נוסף זמין במאמר בנושא מפתחות הצפנה בניהול הלקוח.

  13. לוחצים על Continue.

  14. בקטע Billing, בוחרים באפשרות General pricing או Configurable pricing. מידע נוסף זמין במאמרים אימות סטטוס החיוב של הפרויקטים ורישיונות.

  15. לוחצים על יצירה. ‫Gemini Enterprise יוצר את מאגר הנתונים ומציג את מאגרי הנתונים בדף מאגרי נתונים.

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

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

אחרי שיוצרים את מאגר הנתונים, יוצרים אפליקציה, מקשרים אותה למאגר הנתונים של Microsoft SharePoint ונותנים הרשאה ל-Gemini Enterprise לגשת ל-Microsoft SharePoint לפני שמריצים שאילתות.

הפעלת סנכרון בזמן אמת להעברת נתונים

סנכרון בזמן אמת מסנכרן רק ישויות מסמכים ולא מסנכרן נתונים שקשורים לישויות זהות. בטבלה הבאה מוצגים אירועים במסמך שנתמכים בסנכרון בזמן אמת.

ישויות של Microsoft SharePoint יצירה עדכון מחיקה שינויים בהרשאות
קבצים מצורפים
תגובות
אירועים
קבצים
Pages

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

  1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

    ‫Gemini Enterprise

  2. בתפריט הניווט, לוחצים על מאגרי נתונים.

  3. לוחצים על השם של מאגר הנתונים של Microsoft SharePoint שרוצים להפעיל בו סנכרון בזמן אמת.

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

  5. בשדה סנכרון בזמן אמת, לוחצים על הצגה/עריכה.

  6. כדי להפעיל סנכרון בזמן אמת, לוחצים על המתג הפעלת סנכרון בזמן אמת.

  7. בשדה Client secret (סוד לקוח), מזינים ערך. הערך הזה משמש לאימות אירועי webhook של Microsoft SharePoint. מומלץ להשתמש במחרוזת של 20 תווים.

  8. לוחצים על Save.

    מחכים שהשדה סנכרון בזמן אמת ישתנה לפועל.

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

בקטע הזה מוסבר איך Gemini Enterprise מנהל את השאילתה שלכם ומהן ההשלכות על הפרטיות של השימוש במאגר הנתונים המאוחד.

ביצוע שאילתה

אחרי שמאשרים את Microsoft SharePoint ושולחים שאילתת חיפוש ל-Gemini Enterprise:

  • ‫Gemini Enterprise שולח את שאילתת החיפוש שלכם ישירות ל-API של מיקרוסופט.
  • ‫Gemini Enterprise משלב את התוצאות עם תוצאות ממקורות נתונים מקושרים אחרים ומציג תוצאת חיפוש מקיפה.

טיפול בנתונים

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

  • מחרוזת השאילתה נשלחת למערכת הבק-אנד של צד שלישי לחיפוש (Microsoft API).
  • הצדדים השלישיים האלה עשויים לשייך את השאילתות לזהות שלכם.
  • אם מופעלים כמה מקורות נתונים של חיפוש מאוחד, יכול להיות שהשאילתה תישלח לכולם.
  • אחרי שהנתונים מגיעים למערכת של הצד השלישי, הם כפופים לתנאים ולהגבלות ולמדיניות הפרטיות של המערכת הזו.

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