Elasticsearch

מחבר Elasticsearch מאפשר לכם להתחבר למנוע חיפוש Elasticsearch ולבצע את הפעולות הנתמכות במנוע החיפוש.

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

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

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

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

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

  • מידע על התקנת Elasticsearch ב-Linux זמין במאמר Install Elasticsearch.
  • מידע על הגדרת SSL כדי לאבטח את Elasticsearch זמין במאמר הגדרת SSL.

הגדרת המחבר

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

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

    כניסה לדף Connections

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

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

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

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

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

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

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

    8. הערכה בצד הלקוח: מגדירים את הערך של ClientSideEvaluation כ-true כדי לבצע הערכה בצד הלקוח באובייקטים מקוננים.
    9. מודל נתונים: מציין את מודל הנתונים שבו יש להשתמש כשמנתחים מסמכי Elasticsearch ומפיקים את המטא-נתונים של מסד הנתונים.
    10. מספר התוצאות המקסימלי: המספר המקסימלי של התוצאות הכוללות שיוחזרו מ-Elasticsearch כשמשתמשים ב-Search API שמוגדר כברירת מחדל.
    11. (אופציונלי) בקטע הגדרות מתקדמות, מסמנים את התיבה שימוש ב-proxy כדי להגדיר שרת proxy לחיבור, ומגדירים את הערכים הבאים:
      • סכימת אימות של שרת proxy: בוחרים את סוג האימות לאימות מול שרת ה-proxy. אלה סוגי האימות שנתמכים:
        • בסיסי: אימות HTTP בסיסי.
        • ‫Digest: אימות HTTP מסוג Digest.
      • משתמש proxy: שם משתמש שישמש לאימות בשרת ה-proxy.
      • סיסמת ה-Proxy: הסוד במנהל הסודות של סיסמת המשתמש.
      • סוג ה-SSL של ה-Proxy: סוג ה-SSL שבו יש להשתמש כשמתחברים לשרת ה-Proxy. אלה סוגי האימות שנתמכים:
        • אוטומטי: הגדרת ברירת המחדל. אם כתובת ה-URL היא כתובת HTTPS, נעשה שימוש באפשרות Tunnel. אם כתובת ה-URL היא כתובת HTTP, נעשה שימוש באפשרות NEVER.
        • תמיד: החיבור תמיד מופעל באמצעות SSL.
        • לעולם לא: החיבור לא מופעל באמצעות SSL.
        • מנהור: החיבור הוא דרך שרת proxy למנהור. שרת ה-proxy פותח חיבור למארח המרוחק, והתנועה זורמת הלוך ושוב דרך ה-proxy.
      • בקטע שרת Proxy, מזינים את פרטי שרת ה-Proxy.
        1. לוחצים על + הוספת יעד.
        2. בוחרים סוג יעד.
          • כתובת המארח: מציינים את שם המארח או את כתובת ה-IP של היעד.

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

    12. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    13. לוחצים על הבא.
  5. בקטע יעדים, מזינים את הפרטים של המארח המרוחק (מערכת העורף) שאליו רוצים להתחבר.
    1. סוג היעד: בוחרים סוג יעד.
      • כדי לציין את שם המארח או את כתובת ה-IP של היעד, בוחרים באפשרות כתובת המארח ומזינים את הכתובת בשדה מארח 1.
      • כדי ליצור חיבור פרטי, בוחרים באפשרות Endpoint attachment (צירוף נקודת קצה). ברשימה Endpoint Attachment, בוחרים את קובץ ה-Endpoint Attachment שנוצר עבור מערכת ה-Backend.

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

      כדי להזין יעדים נוספים, לוחצים על +הוספת יעד.

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

      החיבור ל-Elasticsearch תומך בסוגי האימות הבאים:

      • אנונימי
      • שם משתמש וסיסמה

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

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

הגדרת אימות

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

  • אנונימי

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

  • שם משתמש וסיסמה
    • שם משתמש: שם המשתמש של המחבר
    • סיסמה: סוד ב-Secret Manager שמכיל את הסיסמה שמשויכת למחבר.

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

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

סוג החיבור SSL

שם השדה פרטים
מיקום us-central1
מחבר Elasticsearch
גרסת המחבר 1
שם החיבור elastic-search-service-conn
הפעלת Cloud Logging כן
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מודל נתונים יחסי
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
הפעל SSL כן
מאגר אישורים חיבור לא מאובטח כן
מאגר מפתחות כן
אישור לקוח CLIENT_CERTIFICATE
גרסה של סוד 1
מפתח פרטי של לקוח CLIENT_PRIVATE_KEY
גרסה של סוד 1
סוג היעד(שרת) כתובת המארח
כתובת המארח https://192.0.2.0
יציאה 9200
אימות כן
סיסמת משתמש כן
שם משתמש שם משתמש
סיסמה PASSWORD
גרסה של סוד 4

סוג החיבור של PSC

שם השדה פרטים
מיקום us-central1
מחבר Elasticsearch
גרסת המחבר 1
שם החיבור elasticsearch-psc-conn
הפעלת Cloud Logging כן
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
מודל נתונים יחסי
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 50
סוג היעד(שרת) כתובת המארח
כתובת המארח ‫192.0.2.0
יציאה PORT
אימות כן
סיסמת משתמש כן
שם משתמש USERNAME/td>
סיסמה PASSWORD
גרסה של סוד 1

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

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

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

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

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

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

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

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

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

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

פעולות

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

הפעולה CreateIndex

הפעולה הזו יוצרת אינדקס.

פרמטרים של קלט בפעולה CreateIndex

שם הפרמטר סוג הנתונים חובה תיאור
AliasFilter String לא אובייקט Query DSL שמשמש להגבלת המסמכים שהכינוי יכול לגשת אליהם.
NumberOfShards String לא מספר הרסיסים הראשיים שהאינדקס שנוצר צריך לכלול.
AliasIsWriteIndex בוליאני לא קובע אם אפשר לכתוב לאינדקס של הכינוי.
כינוי String לא כינוי לאינדקס.
AliasIndexRouting String לא הערך שמשמש לכינוי כדי להפנות פעולות של יצירת אינדקס לשבר ספציפי. אם מציינים ערך, הוא מחליף את ערך הניתוב לפעולות של יצירת אינדקס.
אינדקס String כן שם האינדקס.
NumberOfRoutingShards String לא מספר שמשמש את Elasticsearch באופן פנימי עם הערך מ-NumberOfShards כדי לנתב מסמכים לשבר ראשי.
OtherSettings String לא אובייקט JSON של הגדרות. אי אפשר להשתמש בהגדרה הזו בשילוב עם NumberOfRoutingShards או NumberOfShards.
מיפויים String לא אובייקט JSON שמציין את המיפוי של האינדקס.
AliasIsHidden בוליאני לא מציין אם הכינוי מוסתר. כל האינדקסים של הכינוי צריכים להיות עם אותו ערך is_hidden.
AliasRouting String לא הערך שמשמש לכינוי כדי לנתב פעולות של יצירת אינדקס וחיפוש לרסיס ספציפי. יכול להיות שיוחלף על ידי AliasIndexRouting או AliasSearchRouting בפעולות מסוימות.

פרמטרים של פלט של הפעולה CreateIndex

הפעולה הזו מחזירה את הסטטוס 200 (OK) אם היא בוצעה בהצלחה.

במאמר דוגמאות לפעולות מוסבר איך להגדיר את הפעולה CreateIndex.

פעולת ModifyIndexAliases

הפעולה הזו משנה כינוי של אינדקס.

פרמטרים של קלט לפעולה ModifyIndexAliases

שם הפרמטר סוג הנתונים חובה תיאור
כינוי String לא שם הכינוי. כמה כינויים מופרדים באמצעות נקודה-פסיק.
מסנן String לא מסנן לשימוש כשיוצרים את הכינוי. הפעולה הזו לוקחת את המסנן בפורמט JSON גולמי באמצעות Query DSL. כמה מסננים מופרדים באמצעות נקודה-פסיק.
ניתוב String לא ערך הניתוב לשיוך לכינוי. כמה ערכי ניתוב מופרדים באמצעות נקודה ופסיק.
SearchRouting String לא ערך הניתוב שמשויך לכינוי לפעולות חיפוש. כמה ערכים של ניתוב חיפוש מופרדים באמצעות נקודה-פסיק.
IndexRouting String לא ערך הניתוב שמשויך לכינוי לפעולות אינדוקס. כמה ערכים של ניתוב למדד מופרדים באמצעות נקודה-פסיק.
פעולה String כן הפעולה לביצוע, כמו add, remove או remove_index. כמה פעולות מופרדות באמצעות נקודה-פסיק.
אינדקס String כן שם האינדקס. כמה אינדקסים מופרדים באמצעות נקודה-פסיק.

פרמטרים של פלט של הפעולה ModifyIndexAliases

הפעולה הזו מחזירה את הסטטוס 200 (OK) אם היא בוצעה בהצלחה.

במאמר דוגמאות לפעולות מוסבר איך להגדיר את הפעולה ModifyIndexAliases.

פעולת ExecuteCustomQuery

הפעולה הזו מאפשרת להריץ שאילתה בהתאמה אישית.

כדי ליצור שאילתה בהתאמה אישית, פועלים לפי השלבים הבאים:

  1. פועלים לפי ההוראות המפורטות ל הוספת משימה של מחברים.
  2. כשמגדירים את משימת המחבר, בוחרים באפשרות פעולות בסוג הפעולה שרוצים לבצע.
  3. ברשימה Action, בוחרים באפשרות Execute custom query ולוחצים על Done.

    תמונה שמציגה את הפעולה execute-custom-query-action תמונה שמציגה את הפעולה execute-custom-query-action

  4. מרחיבים את הקטע Task input (קלט למשימה) ומבצעים את הפעולות הבאות:
    1. בשדה Timeout after, מזינים את מספר השניות להמתנה עד להפעלת השאילתה.

      ערך ברירת המחדל: 180 שניות.

    2. בשדה Maximum number of rows (מספר השורות המקסימלי), מזינים את מספר השורות המקסימלי שיוחזר ממסד הנתונים.

      ערך ברירת המחדל: 25.

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

      תמונה שבה מוצגת שאילתת SQL בהתאמה אישית תמונה שבה מוצגת שאילתת SQL בהתאמה אישית

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

      אפשר להשתמש בסימן שאלה (?) בהצהרת SQL כדי לייצג פרמטר יחיד שצריך לציין ברשימת פרמטרים של שאילתה. לדוגמה, שאילתת ה-SQL הבאה בוחרת את כל השורות מהטבלה Employees שתואמות לערכים שצוינו בעמודה LastName: 

      SELECT * FROM Employees where LastName=?

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

      תמונה שמראה את האפשרות add-query-param תמונה שמראה את האפשרות add-query-param

      כדי להוסיף פרמטרים של שאילתה:

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

      6. הפעולה Execute custom query לא תומכת במשתני מערך.

אם הפעולה בוצעה ללא שגיאות, היא מחזירה את הסטטוס 200 (OK) עם גוף תגובה שכולל את תוצאות השאילתה.

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

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

דוגמה – יצירת אינדקס

בדוגמה הזו נוצר אינדקס.

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

    4. אם הפעולה מצליחה, לפרמטר התגובה CreateIndex של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{
"CompletedBeforeTimeout": "true",
"ShardsAcknowledged": "true",
"IndexName": "new_index_1"
}]

דוגמה – שינוי של כינוי אינדקס

בדוגמה הזו מוסבר איך לשנות כינוי של אינדקס.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Actions.
  2. בוחרים את הפעולה ModifyIndexAliases ולוחצים על סיום.
  3. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ומזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"Action": "remove_index",
"Index": "postmanindex"
}

    4. אם הפעולה מצליחה, לפרמטר התגובה ModifyIndexAliases של המשימה connectorOutputPayload יהיה ערך שדומה לזה:

    [{
}]

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

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

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

בדוגמה הזו מוצגת רשימה של כל הרשומות בישות Demoindex.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Demoindex מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. אופציונלי: בקטע Task Input (קלט משימה) במשימה Connectors (מחברים), אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause (סעיף סינון). תמיד מציינים את הערך של סעיף המסנן בתוך גרשיים בודדים (').

דוגמה – אחזור רשומה מישות

בדוגמה הזו מאחזרים רשומה עם המזהה שצוין מהישות Demoindex.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Demoindex מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על EntityId (מזהה ישות) ואז מזינים 23 בשדה Default Value (ערך ברירת מחדל).

    כאן, 23 הוא מזהה רשומה ייחודי בישות Demoindex.

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

בדוגמה הזו נוצרת רשומה בישות Demoindex.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Demoindex מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"message": "GET /search HTTP/1.1 200 1070000",
"@timestamp": "2099-11-15 13:12:00.0"
}

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

    [{
"_id": "23"
}]

דוגמה – עדכון רשומה

בדוגמה הזו מעדכנים את הרשומה עם המזהה שצוין בישות Demoindex.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Demoindex מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך דומה לערך הבא בשדה Default Value: 
    {
"message": "GET /search HTTP/1.1 200 1070000",
"@timestamp": "2099-11-15 13:12:00.0",
"name": "GoogleCloud_Update_docs",
"price": 10.0}
  5. לוחצים על entityId ואז מזינים 23 בשדה ערך ברירת מחדל.

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

    [{
"_id": "23"
}]

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

בדוגמה הזו נמחק הרשומה עם המזהה שצוין בישות Demoindex.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Demoindex מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים pcqT4wB4uQNUCuamh4N בשדה Default Value (ערך ברירת מחדל).

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

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

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

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

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

שם הפרמטר סוג נתונים חובה תיאור
client_side_evaluation בוליאני לא נכון מגדירים את ClientSideEvaluation לערך true כדי לבצע הערכה בצד הלקוח באובייקטים מוטמעים.
data_model ENUM לא נכון מציין את מודל הנתונים שבו יש להשתמש כשמנתחים מסמכי Elasticsearch ויוצרים את המטא-נתונים של מסד הנתונים. הערכים הנתמכים הם: Document, ‏ FlattenedDocuments, ‏ Relational
max_results מחרוזת לא נכון המספר המקסימלי של התוצאות הכוללות שיוחזרו מ-Elasticsearch כשמשתמשים ב-Search API שמוגדר כברירת מחדל.
דרגת מלל מחרוזת לא נכון רמת המלל של החיבור, משתנה מ-1 עד 5. רמת הפירוט הגבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
proxy_enabled בוליאני לא נכון מסמנים את תיבת הסימון הזו כדי להגדיר שרת Proxy לחיבור.
proxy_auth_scheme ENUM לא נכון סוג האימות שבו יש להשתמש כדי לבצע אימות לשרת ה-proxy‏ ProxyServer. הערכים הנתמכים הם: BASIC, ‏ DIGEST, ‏ NONE
proxy_user מחרוזת לא נכון שם משתמש שישמש לאימות בשרת ה-proxy ‏ProxyServer.
proxy_password SECRET לא נכון סיסמה שתשמש לאימות בשרת ה-proxy‏ ProxyServer.
proxy_ssltype ENUM לא נכון סוג ה-SSL שבו צריך להשתמש כשמתחברים לשרת ה-proxy של ProxyServer. הערכים הנתמכים הם: AUTO, ‏ ALWAYS, ‏ NEVER, ‏ TUNNEL

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

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

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

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

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

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