Cloud Search

המחבר של Cloud Search מאפשר לכם לבצע את הפעולות הנתמכות ב-Cloud Search.

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

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

  • בפרויקט שלכם ב-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)

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

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

  • אם אתם משתמשים באימות של חשבון שירות במקום באימות OAuth 2.0, ודאו שניתנו לחשבון השירות ההרשאות המתאימות. למידע נוסף, ראו תפקידים והרשאות ב-IAM.

הגדרת המחבר

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

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

    כניסה לדף Connections

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

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

    2. לוחצים על הבא.
  • בקטע פרטי החיבור, מגדירים את השדות הבאים:
    1. מחבר: בוחרים באפשרות Cloud Search מתוך הרשימה הנפתחת של המחברים הזמינים.
    2. גרסת המחבר: בוחרים את גרסת המחבר מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name, מזינים שם למופע החיבור.

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

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

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

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

    8. אופציונלי: לוחצים על ‎+ Add label כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    9. לוחצים על הבא.
    10. בקטע אימות, מזינים את פרטי האימות.
      1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

        אתם יכולים לבחור כל אחד מסוגי האימות הבאים:

        • ‫OAuth 2.0 – קוד הרשאה

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

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

    הגדרת אימות

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

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

    פעולות

    המחבר הזה מספק שכבת הפשטה לאובייקטים של שירות הקצה העורפי המקושר. אפשר לגשת לאובייקטים של ה-backend רק דרך האבסטרקציה הזו. ההפשטה מוצגת לכם כפעולות. Action היא פונקציה מסוג First Class שזמינה לשילוב דרך ממשק המחבר. פעולה מאפשרת לבצע שינויים בישות אחת או בכמה ישויות, והיא משתנה ממתחם למתחם. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

    שימוש בחיבור ל-Cloud Search בשילוב

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

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

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

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

    •