Δημιουργήστε συνδέσεις και προελεύσεις δεδομένων για γενικά προγράμματα οδήγησης JDBC

Χρησιμοποιήστε αυτήν τη ροή εργασιών για να επιτρέψετε στο Essbase να συνδέεται με οποιαδήποτε προέλευση δεδομένων JDBC, χρησιμοποιώντας προγράμματα οδήγησης που ανεβάζετε στον server Essbase.

Εάν είστε ο διαχειριστής ανάπτυξης του Essbase, μπορείτε να ρυθμίσετε το Essbase ώστε να χρησιμοποιεί τα προτιμώμενα προγράμματα οδήγησης που ανεβάζετε στο μηχάνημα server Essbase. Η Oracle έχει δοκιμάσει τη συνδεσιμότητα του Essbase JDBC χρησιμοποιώντας προγράμματα οδήγησης Oracle. Για να χρησιμοποιήσετε προγράμματα οδήγησης JDBC από άλλους προμηθευτές, ελέγξτε την τεκμηρίωση του προγράμματος οδήγησης για απαιτήσεις σχετικά με τον καθορισμό της διεύθυνσης τοποθεσίας και των διαπιστευτηρίων της προέλευσης δεδομένων JDBC. Για τυχόν βήματα που σχετίζονται με την απόδοση, ανατρέξτε στην τεκμηρίωση του JDBC για προμηθευτές.

Σημείωση:

Βεβαιωθείτε ότι το πρόγραμμα οδήγησης JDBC που χρησιμοποιείτε με το Essbase εφαρμόζει τη μέθοδο setFetchSize για τον έλεγχο της μνήμης που χρησιμοποιείται κατά την επεξεργασία του συνόλου αποτελεσμάτων. Για τη βέλτιστη απόδοση των διαδικασιών φόρτωσης δεδομένων και δημιουργίας διαστάσεων, το Essbase ανακτά 1000 εγγραφές ανά κλήση δικτύου.

Για να ρυθμίσετε το Essbase ώστε να χρησιμοποιεί γενικά προγράμματα οδήγησης JDBC,

Συνδεθείτε στο μηχάνημα server Essbase χρησιμοποιώντας SSH.
Δημιουργήστε μη αυτόματα έναν κατάλογο προγράμματα οδήγησης στο <Αρχική σελίδα προϊόντων Essbase> στο στιγμιότυπο server.

Βεβαιωθείτε ότι τα προγράμματα οδήγησης χρησιμοποιούν μόνο πεζά, καθώς η διαδρομή κάνει διάκριση πεζών-κεφαλαίων.
Από την τοποθεσία του προμηθευτή σας, πραγματοποιήστε λήψη των JAR προγραμμάτων οδήγησης JDBC που θέλετε να χρησιμοποιήσετε.

Το πρόγραμμα οδήγησης Oracle Database JDBC που υποστηρίζεται από το Essbase είναι ojdbc8.jar.

Εάν χρησιμοποιείτε την Αυτόνομη αποθήκη δεδομένων, πρέπει να κάνετε λήψη του πλήρους αρχείου (ojdbc8-full.tar.gz) που περιέχει το πρόγραμμα οδήγησης Oracle JDBC Thin και τα συνοδευτικά JAR.
Ανεβάστε τα jar του προγράμματος οδήγησης JDBC στον κατάλογο προγράμματα οδήγησης στο στιγμιότυπο του Essbase.

Ανεβάστε μόνο μία έκδοση κάθε προγράμματος οδήγησης βάσης δεδομένων στον κατάλογο προγράμματα οδήγησης . Για παράδειγμα, μην ανεβάσετε και το sqljdbc41.jar και το sqljdbc42.jar, διαφορετικά το Essbase θα χρησιμοποιήσει το παλαιότερο (αφού εμφανίζεται πρώτο στο CLASSPATH).

Εάν χρησιμοποιείτε Αυτόνομη αποθήκη δεδομένων, εξαγάγετε το αρχείο (ojdbc8-full.tar.gz) και μετακινήστε όλα τα περιεχόμενα απευθείας στον κατάλογο προγράμματα οδήγησης (όχι σε υποφάκελο).
Δημιουργήστε συνδέσεις προς τα προγράμματα οδήγησης JDBC.
1. Στο περιβάλλον εργασίας web του Essbase, κάντε κλικ στην επιλογή Προελεύσεις και έπειτα Συνδέσεις.
  
  Εναλλακτικά, για να ορίσετε τη σύνδεση και την προέλευση δεδομένων σε επίπεδο εφαρμογής αντί για καθολικά, κάντε έναρξη από τη σελίδα "Εφαρμογές" αντί από τη σελίδα "Προελεύσεις", κάντε κλικ σε ένα όνομα εφαρμογής και κατόπιν επιλέξτε Προελεύσεις.
2. Κάντε κλικ στην επιλογή Δημιουργία σύνδεσης και επιλέξτε JDBC.
  
  Για να βρει το πρόγραμμα οδήγησης JDBC, το Essbase κάνει αναζήτηση στον φάκελο προγράμματα οδήγησης . Εάν δεν βρεθούν αρχεία jar , το Essbase επιστρέφει ένα σφάλμα "Η κλάση δεν βρέθηκε" (ή αποτυχία φόρτωσης του προγράμματος οδήγησης), όταν ελέγχετε τη σύνδεση.
3. Στην οθόνη Δημιουργία σύνδεσης,
  1. Εισαγάγετε ένα όνομα για τη σύνδεση JDBC. Για παράδειγμα, Oracle JDBC.
  2. Στο πεδίο URL, καταχωρήστε τη συμβολοσειρά σύνδεσης JDBC. Για παράδειγμα, jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. Ανακτήστε τη συμβολοσειρά σύνδεσης JDBC από τον πάροχο JDBC.
    
    Η παραπάνω μορφή σύνταξης ισχύει μόνο για το Oracle Database. Δείτε την ενότητα Περισσότερα παραδείγματα συνδέσεων για γενικά προγράμματα οδήγησης JDBC αν εργάζεστε με άλλους παρόχους.
  3. Για τα πεδία "Χρήστης" και "Κωδικός πρόσβασης", εισαγάγετε τα διαπιστευτήρια για έναν χρήστη που έχει εξουσιοδότηση πρόσβασης στη βάση δεδομένων.
  4. Στο πεδίο "Πρόγραμμα οδήγησης", καταχωρήστε το πλήρως προσδιορισμένο όνομα κλάσης του προγράμματος οδήγησης JDBC. Για παράδειγμα, oracle.jdbc.driver.OracleDriver.
  Για προγράμματα οδήγησης Oracle, καθορίστε τη διεύθυνση τοποθεσίας χρησιμοποιώντας τις ακόλουθες οδηγίες σύνταξης:
  - Αν η βάση δεδομένων Oracle Database έχει εγγραφεί με διεργασία ακρόασης, μπορείτε να χρησιμοποιήσετε το όνομα υπηρεσίας στη διεύθυνση τοποθεσίας αντί για το 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
```
  - Εάν χρησιμοποιείτε την Αυτόνομη αποθήκη δεδομένων, στη σύνταξη της διεύθυνσης τοποθεσίας, πρέπει να συμπεριλάβετε τη μεταβλητή περιβάλλοντος TNS_ADMIN καθορίζοντας τη διαδρομή προς το πορτοφόλι. Το πορτοφόλι μπορεί να βρίσκεται οπουδήποτε στο μηχάνημα server 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 Database. Δείτε την ενότητα Περισσότερα παραδείγματα συνδέσεων για γενικά προγράμματα οδήγησης JDBC αν εργάζεστε με άλλους παρόχους.
4. Κάντε κλικ στην επιλογή "Δοκιμή" για να επικυρώσετε τη σύνδεση, και αν είναι επιτυχής, πατήστε "Δημιουργία".
5. Επαληθεύστε ότι η σύνδεση δημιουργήθηκε επιτυχώς και εμφανίζεται στη λίστα με τις συνδέσεις.
Δημιουργήστε προελεύσεις δεδομένων μέσω των γενικών συνδέσεων προγραμμάτων οδήγησης JDBC.
1. Κάντε κλικ στην επιλογή "Προελεύσεις δεδομένων"και επιλέξτε "Δημιουργία προέλευσης δεδομένων".
2. Από το αναπτυσσόμενο πλαίσιο Σύνδεση, επιλέξτε το όνομα της σύνδεσης που μόλις δημιουργήσατε, για παράδειγμα, Oracle JDBC. Οι συνδέσεις σε επίπεδο εφαρμογής έχουν πρόθεμα με το όνομα της εφαρμογής, με τη μορφή appName.connectionName.
3. Δώστε ένα όνομα για την προέλευση δεδομένων, για παράδειγμα, OracleDB_Datasource.
4. Προαιρετικά, καταχωρήστε μια περιγραφή της προέλευσης δεδομένων, για παράδειγμα, SAMPLE_BASIC_TABLE στο Oracle Database.
5. Στο πεδίο "Ερώτημα", παρέχετε το κατάλληλο ερώτημα SQL που επιλέγει τα δεδομένα που θέλετε να καταστήσετε διαθέσιμα σε αυτήν την προέλευση δεδομένων.
6. Κάντε κλικ στην επιλογή "Επόμενο". Αν η δήλωση SQL ήταν σωστή για την υποβολή ερωτήματος σε πίνακα, οι στήλες ερωτήματος συμπληρώνονται.
7. Αλλάξτε τυχόν αριθμητικές στήλες σε "Διπλός" και πατήστε "Επόμενο".
8. Αλλάξτε τυχόν πρόσθετες παραμέτρους για συγκεκριμένες προελεύσεις, αν υπάρχουν, και πατήστε "Επόμενο". Για πληροφορίες σχετικά με τη χρήση παραμέτρων, ανατρέξτε στην ενότητα Υλοποίηση παραμέτρων για προελεύσεις δεδομένων.
9. Εξετάστε το πλαίσιο προεπισκόπησης. Θα πρέπει να δείτε τα αποτελέσματα του ερωτήματος που ανακτά στήλες δεδομένων από την εξωτερική προέλευση.
10. Αν η προεπισκόπηση φαίνεται σωστή, κάντε κλικ στην επιλογή "Δημιουργία" για να ολοκληρώσετε τη δημιουργία της προέλευσης δεδομένων.