הפעלת שאילתה בהתאמה אישית

בדף הזה מוסבר איך להריץ שאילתת SQL בהתאמה אישית. כדי להריץ שאילתה בהתאמה אישית, צריך להכיר את המושגים הבאים:

הפעולה Execute custom query (הפעלת שאילתה מותאמת אישית) מוצגת לכם כפעולה במשימת המחבר. פעולה היא פונקציה מסוג First class שזמינה לשילוב דרך ממשק המחבר. פעולות מאפשרות לבצע שינויים בישות אחת או בכמה ישויות, והן משתנות מחיבור לחיבור. עם זאת, יכול להיות שמחבר לא תומך באף פעולה, ובמקרה כזה הרשימה Actions תהיה ריקה.

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

יצירת שאילתה בהתאמה אישית

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

  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 לא תומכת במשתני מערך.