צור חיבורים ומקורות נתונים למנהלי התקן JDBC כלליים

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

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

הערה :

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

כדי להגדיר את Essbase להשתמש במנהלי התקן JDBC כלליים.

  1. התחבר אל מחשב השרת של Essbase באמצעות SSH.

  2. צור ספריית drivers באופן ידני ב-<דף הבית של מוצר Essbase> במופע השרת.

    ודא ש-drivers מופיע באותיות קטנות, מכיוון שהנתיב רגיש לרישיות.

  3. מאתר הספק שלך, הורד את JARs של מנהל התקן JDBC בהם אתה רוצה להשתמש.

    מנהל התקן JDBC במסד נתונים של Oracle הנתמך על-ידי Essbase הוא ojdbc8.jar.

    אם אתה משתמש ב-Autonomous Data Warehouse, עליך להוריד את הארכיב המלא (ojdbc8-full.tar.gz) המכיל מנהל התקן רזה JDBC של Oracle ו-JARs נלווים.

  4. העלה את קובצי jar של מנהל התקן JDBC לספרייה drivers במופע Essbase.

    העלה רק גרסה אחת של כל מנהל התקן של מסד נתונים לספרייה drivers. לדוגמה, אל תעלה את sqljdbc41.jar ואת sqljdbc42.jar, אחרת Essbase ישתמש באחד הישן (כפי הוא מופיע לראשונה ב-CLASSPATH).

    אם אתה משתמש ב-Autonomous Data Warehouse, שלוף את נתוני הארכיב (ojdbc8-full.tar.gz) והעבר את כל התוכן ישירות אל הספרייה drivers (לא תיקיית משנה).

  5. צור חיבורים למנהלי התקן של JDBC.

    1. בממשק האינטרנט של Essbase, לחץ על מקורות ולאחר מכן על חיבורים.

      או, כדי להגדיר חיבור ומקור נתונים ברמת היישום, במקום ברמה גלובלית, התחל בדף 'יישומים' במקום בדף 'מקורות', לחץ על שם יישום ולאחר מכן לחץ על מקורות.

    2. לחץ על צור חיבור ובחר את JDBC.

      כדי למצוא את שרת ה-JDBC, Essbase מחפש בתיקייה drivers. אם לא נמצאו קובצי jar, Essbase מחזיר שגיאת 'מחלקה לא נמצאה' (או טעינת מנהל התקן נכשלה) כאשר אתה בודק את החיבור.

    3. במסך צור חיבורים,

      1. ספק שם לחיבור ה-JDBC. לדוגמה, Oracle JDBC.

      2. בשדה כתובת ה-URL, ספק את מחרוזת ההתחברות של JDBC. לדוגמה, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. השג את מחרוזת ההתחברות של JDBC מספק ה-JDBC.

        פורמט התחביר לעיל חל רק על מסד נתונים של Oracle. ראה דוגמאות נוספות לחיבור למנהלי התקן כלליים של JDBC אם אתה עובד עם ספקים אחרים.

      3. לשדות 'משתמש' ו'סיסמה', הזן את פרטי האימות למשתמש שמורשה לגשת למסד הנתונים.

      4. בשדה 'מנהל התקן', ספק את שם המחלקה המוגדר במלואו של מנהלן התקן JDBC. לדוגמה, oracle.jdbc.driver.OracleDriver.


      תיבת דו-שיח 'צור חיבור' לסוג חיבור 'מנהל התקן JDBC'. שם: Oracle JDBC, URL: jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com, משתמש: essbase, סיסמה: (מוסתרת), מנהל התקן: oracle.jdbc.driver.OracleDriver, תיאור: חיבור Oracle JDBC 8

      למנהלי התקן של Oracle, ציין את כתובת ה-URL באמצעות הנחיות התחביר הבאות:

      • אם מסד נתונים של Oracle רשום ב-Listener, אתה יכול להשתמש ב'שם שירות' בכתובת ה-URL במקום ה-SID, באמצעות תחביר קצר jdbc:oracle:thin:@<host>:<port>/<servicename>. דוגמה:

        jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com

      • הדוגמה הבאה משתמש בשם שירות עם תחביר ארוך.

        jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))

      • כדי להשתמש במזהה מערכת של Oracle (SID) המזהה את מסד הנתונים, השתמש בתחביר jdbc:oracle:thin:@<host>:<port>:<SID>. לדוגמה,

        jdbc:oracle:thin:@myhost:1521:orcl

      • אם אתה משתמש ב-Autonomous Data Warehouse, בתחביר כתובת ה-URL, עליך לכלול את המשתנה הסביבתי TNS_ADMIN המציין את הנתיב ל-wallet. ה-wallet יכול להיות בכל מקום במחשב השרת של Essbase אך עליך לספק את הנתיב המלא, באמצעות תחביר כגון jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath.

        דוגמה ב-Linux

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn

        דוגמה ב-Windows

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"

        דוגמה בפריסת OCI

        jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn

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

    4. לחץ על בדוק כדי לאמת את החיבור, ואם הבדיקה תעבור בהצלחה, לחץ על יצירה.

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

  6. צור מקורות נתונים מעל חיבורי מנהל התקן JDBC הכלליים.

    1. לחץ על מקורות נתונים, ולחץ על יצירת מקור נתונים.

    2. מהתיבה הנפתחת חיבור, בחר את שם החיבור שזה עתה יצרת; לדוגמה, Oracle JDBC. חיבורים ברמת יישום מקבלים קידומת עם שם היישום, בפורמט appName.connectionName.

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

    4. אם תרצה, הזן תיאור של מקור הנתונים, למשל, במסד נתונים של Oracle.

    5. בשדה 'שאילתא', ציין את שאילתת ה-SQL המתאימה, שבוחרת את הנתונים שברצונך להפוך לזמינים במקור נתונים זה.

    6. לחץ על הבא. אם משפט ה-SQL היה נכון לביצוע שאילתא על טבלה, עמודות שעליהן בוצעה שאילתא יהיו מאוכלסות.

    7. שנה את העמודות המספריות ל'כפול' ולחץ על הבא.

    8. שנה את הפרמטרים הנוספים הספציפיים למקור, אם רלוונטי, ולחץ על הבא. למידע נוסף על שימוש בפרמטר, ראה ישם פרמטרים למקורות נתונים.

    9. סקור את לוח התצוגה המקדימה. תראה את התוצאות של השאילתא השולפת עמודות נתונים מהמקור החיצוני.

    10. אם התצוגה המקדימה נראית נכונה, לחץ על יצירה כדי לסיים את יצירת מקור הנתונים.