ישם פרמטרים למקורות נתונים

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

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

בכל פעם שאתה מתכנן להשתמש במשתנים במקורות נתונים של Essbase, תחילה עליך

  1. כלול תחביר של משתנה בשאילתת מקור הנתונים. לדוגמה, שאילתת מקור הנתונים חייבת לכלול ? בתחביר שלה, כאשר ? הוא שומר מקום למשתנה כלשהו שיוגדר בזמן ריצה.

  2. בצע אחת מהפעולות הבאות:

    • הגדר ערך פרמטר ברירת מחדל קבוע במקור הנתונים ל-Essbase לשימוש כ-fallback במקרה שלמשתנה יש הקשר לא תקף בזמן ריצה, או

    • הגדר משתנה החלפה לשימוש על-ידי מקור הנתונים
    • העבר פונקציית מוגדרת משתמש חיצונית (או פרוצדורה מאוחסנת) כפרמטר

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

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

לדוגמה, הנח את תרחישי השימוש הבאים.

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

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

הגדר פרמטר ברירת מחדל במקור נתונים

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

כדי להגדיר את פרמטר ברירת המחדל.

  1. השג או צור חיבור למקור הנתונים החיצוני (לדוגמה, צור חיבור למסד נתונים של Oracle).

    אתה יכול להשתמש בחיבור גלובלי, אם כבר קיים חיבור גלובלי בדף ה'מקורות' של ממשק האינטרנט של Essbase, או, אתה יכול ליצור חיבור ברמת היישום.

  2. צור מקור נתונים לחיבור שבו תשתמש כדי לגשת למסד הנתונים של Oracle.

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

    1. כדי ליצור מקור נתונים גלובלי, עליך להיות מנהלן שירות. לחץ על מקורות, לחץ על הכרטיסייה מקורות נתונים תחת שם המשתמש שלך, ולחץ על צור מקור נתונים.

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

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

    3. לשם, תן שם למקור התונים.

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

      select * from SB_DT where DIMENSION_YEAR=?

      לדוגמה, הנח שלמסד הנתונים הרלציוני שלך יש את הטבלה הבאה, בשם SB_DT. לטבלה יש עמודה DIMENSION_YEAR עם חודשים כערכים:
      תמונה של טבלת מסד נתונים רלציוני עם העמודה DIMENSION_YEAR נבחרת. כל הערכים שלה הם חודשים: Jul, Aug, Aug, Sep, Sep, Oct וכו'

      כדי להשתמש במשתנה לבחירת ערכי חודש מעמודה DIMENSION_YEAR, החל את תחביר המסנן הבא בשאילתא: where DIMENSION_YEAR=?
      תמונה של הכרטיסייה 'כללי' באשף 'צור מקור נתונים'. חיבור: SAMPLE.oracledb_conn, שם: oracledb_ds, תיאור מקור נתונים למסד נתונים של Oracle, שאילתא: בחר * מ-SB_DT שבו dimension_year=?

    5. לחץ על הבא.

    6. בשלב עמודות, החל את סוג הנתונים המתאים שעל Essbase לשייך לכל עמודה מנתוני המקור הרלציונים שלך.

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


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

    7. לחץ על הבא.

    8. בשלב ה'פרמטרים', Param1 נוצר – פרמטר זה קיים מכיוון שהשתמשת ב-? בשאילתא בשלב 'כללי'.

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

      אתה יכול גם לשנות את שם Param1 לשם בעל משמעות עבור תרחיש השימוש שלך. לדוגמה, אתה יכול לשנות אותו ל-param_G_month כדי לציין שהפרמטר משתמש במשתנה גלובלי עבור החודש הנוכחי, או שאתה יכול לשנות את שמו ל-param_<appName>_month כדי לציין שהפרמטר משתמש במשתנה ברמת יישום עבור החודש הנוכחי. התאמה אישית של שמות פרמטר יכולה להיות שימושית בזמן ניפוי באגים לפרמטרים באמצעות קובצי יומן של שרת Essbase.


      תמונה של הכרטיסייה 'פרמטרים' באשף 'צור מקור נתונים'. התיבה 'השתמש במשתנים' לא מסומנת, והערך שהוזן הוא Jan.

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

    9. לחץ על הבא.

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


      תמונה של הכרטיסייה 'תצוגה מקדימה' באשף 'צור מקור נתונים', המציגה רק רשומות בהן DIMENSION_YEAR = Jan.

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

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

השתמש במשתני החלפה במקור נתונים

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

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

  1. צור משתנה החלפה ברמת יישום או ברמה גלובלית.


    תמונה של משתנה החלפה שנוצר ברמת היישום. שם: CurrMonth, ערך: Aug

  2. השג או צור חיבור למקור הנתונים החיצוני (לדוגמה, צור חיבור למסד נתונים של Oracle).

    אתה יכול להשתמש בחיבור גלובלי, אם כבר קיים חיבור גלובלי בדף ה'מקורות' של ממשק האינטרנט של Essbase, או, אתה יכול ליצור חיבור ברמת היישום.

  3. צור מקור נתונים לחיבור שבו תשתמש כדי לגשת למסד הנתונים של Oracle.

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

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

    2. לשם, תן שם למקור התונים.

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

      select * from SB_DT where DIMENSION_YEAR=?

      לדוגמה, הנח שלמסד הנתונים הרלציוני שלך יש את הטבלה הבאה, בשם SB_DT. לטבלה יש עמודה DIMENSION_YEAR עם חודשים כערכים:
      תמונה של טבלת מסד נתונים רלציוני עם העמודה DIMENSION_YEAR נבחרת. כל הערכים שלה הם חודשים: Jul, Aug, Aug, Sep, Sep, Oct וכו'

      כדי להשתמש במשתנה לבחירת ערכי חודש מעמודה DIMENSION_YEAR, החל את תחביר המסנן הבא בשאילתא: where DIMENSION_YEAR=?
      תמונה של הכרטיסייה 'כללי' באשף 'צור מקור נתונים'. חיבור: SAMPLE.oracledb_conn, שם: oracledb_ds, תיאור מקור נתונים למסד נתונים של Oracle, שאילתא: בחר * מ-SB_DT שבו dimension_year=?

    4. לחץ על הבא.

    5. בשלב עמודות, החל את סוג הנתונים המתאים שעל Essbase לשייך לכל עמודה מנתוני המקור הרלציונים שלך.

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


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

    6. לחץ על הבא.

    7. בשלב ה'פרמטרים', Param1 נוצר – פרמטר זה קיים מכיוון שהשתמשת ב-? בשאילתא בשלב 'כללי'. כדי להתאים אישית Param1 כך שיפנה למשתנה החלפה, לחץ על השתמש במשתנים ובחר משתנה החלפה מהרשימה הנפתחת ערך.

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

      אתה יכול לשנות את שם Param1 לשם בעל משמעות עבור תרחיש השימוש שלך. לדוגמה, אתה יכול לשנות אותו ל-param_G_month כדי לציין שהפרמטר משתמש במשתנה גלובלי עבור החודש הנוכחי, או שאתה יכול לשנות את שמו ל-param_<appName>_month כדי לציין שהפרמטר משתמש במשתנה ברמת יישום עבור החודש הנוכחי. התאמה אישית של שמות פרמטר יכולה להיות שימושית בזמן ניפוי באגים לפרמטרים באמצעות קובצי יומן של שרת Essbase.


      תמונה של הכרטיסייה 'פרמטרים' באשף 'צור מקור נתונים'. השתמש במשתנים מסומן, והערך הוא Sample.CurrMonth.

    8. לחץ על הבא.

    9. בתצוגה המקדימה, שים לב שמשתנה ההחלפה מוחל על השאילתא שלך. כתוצאה מכך, התצוגה המקדימה מאוכלסת רק עם רשומות מקור חיצוניות שבהן הערך של העמודה DIMENSION_YEAR הוא Aug.


      תמונה של הכרטיסייה 'תצוגה מקדימה' באשף 'צור מקור נתונים', המציגה רק רשומות בהן DIMENSION_YEAR = Aug.

    10. לחץ על צור כדי ליצור מקור נתונים בהתבסס על שאילתא זו של נתוני המקור החיצוני שלך.