Source Connector για το Oracle¶

Αυτός ο οδηγός περιγράφει πώς να διαμορφώσετε το digna ώστε να συνδέεται στο Oracle Database μέσω ODBC, χρησιμοποιώντας ένα connection string χωρίς DSN (DSN-less).

Η πλευρά του digna στη ρύθμιση είναι ίδια για κάθε τεχνολογία — πού δημιουργούνται οι συνδέσεις, πώς κρυπτογραφούνται οι τιμές των ιδιοτήτων, πώς δοκιμάζεται μια σύνδεση και τι σημαίνουν τα profiling modes. Περιγράφεται στην Επισκόπηση Συνδέσεων Βάσεων Δεδομένων. Αυτή η σελίδα καλύπτει ό,τι είναι ειδικό για το Oracle.

1. Εγκατάσταση του ODBC Driver¶

Ο Oracle ODBC driver είναι μέρος του Oracle Client (αρκεί το πακέτο "ODBC" του Instant Client). Εγκαταστήστε τον στο μηχάνημα που εκτελεί το backend του digna, ακολουθώντας τον επίσημο οδηγό εγκατάστασης του κατασκευαστή.

Ο driver καταχωρίζεται ως Oracle in <OracleHomeName> — για παράδειγμα Oracle in OraDB21Home1 ή Oracle in instantclient_21_13. Το όνομα του home διαφέρει ανά εγκατάσταση, οπότε διαβάστε το ακριβές όνομα στον host σας, όπως περιγράφεται στην ενότητα Εγκατάσταση του ODBC Driver στον Host του digna.

2. Ιδιότητες ODBC¶

Προσθέστε τις παρακάτω ιδιότητες στην οθόνη Add DB Connection:

Το connection string που προκύπτει μοιάζει ως εξής:

Driver=Oracle in OraDB21Home1;DBQ=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=digna_source_db)));UID=DIGNA_SOURCE_USER;PWD=<password>

Η τιμή DBQ¶

Το DBQ δέχεται τρεις μορφές. Είναι ισοδύναμες για το digna· διαφέρουν ως προς το τι πρέπει να διαμορφωθεί στον host του digna:

Σημειώστε ότι οι παρενθέσεις ενός descriptor δεν προκαλούν πρόβλημα μέσα σε ένα connection string, αλλά αν ο κωδικός σας περιέχει ;, βάλτε τον σε άγκιστρα: PWD={p@ss;word}.

3. Διαμόρφωση του digna¶

Στην οθόνη Add DB Connection, δώστε τα εξής:

Name:               Name of the connection. This is used for referencing the connection in other screens.
Technology:         Oracle
Profiling Mode:     Standard, Permanent or Session
Work Schema:        Schema for the work tables of "Permanent" profiling, e.g. "DIGNA_WORK"

4. Σημειώσεις για το Oracle¶

• Τα schemas είναι χρήστες. Το digna παραθέτει τους χρήστες του Oracle ως schemas, οπότε το schema πηγής είναι ο ιδιοκτήτης των πινάκων — DIGNA_SOURCE_USER στο παραπάνω παράδειγμα. Ο χρήστης της σύνδεσης χρειάζεται SELECT σε αυτούς τους πίνακες, είτε απευθείας είτε μέσω ρόλου.
• Μία σύνδεση βλέπει μία βάση δεδομένων. Ο catalog που προσφέρει το digna είναι η βάση δεδομένων στην οποία είναι συνδεδεμένη η σύνδεση, οπότε το DBQ καθορίζει ποιο service, και επομένως ποια βάση δεδομένων, υποβάλλεται σε profiling.
• Τα αναγνωριστικά γίνονται case-sensitive όταν μπαίνουν σε εισαγωγικά. Το digna βάζει σε εισαγωγικά τα ονόματα που διαβάζει από το data dictionary, δηλαδή ό,τι αποθηκεύει το Oracle — κεφαλαία για αντικείμενα χωρίς εισαγωγικά.
• Profiling modes. Το Permanent δημιουργεί τους πίνακες εργασίας στο Work Schema, οπότε ο χρήστης χρειάζεται CREATE TABLE εκεί και quota στο tablespace. Το Session χρησιμοποιεί έναν private temporary table (ORA$PTT_…, Oracle 18c και νεότερο) και δεν αγγίζει το Work Schema. Το Standard χρειάζεται μόνο πρόσβαση ανάγνωσης.

5. Επαλήθευση του Driver (προαιρετικό)¶

Η διαμόρφωση μιας πηγής δεδομένων ODBC δεν απαιτείται για σύνδεση χωρίς DSN, αλλά το παράθυρο διαλόγου του ίδιου του driver είναι ένας βολικός τρόπος να επιβεβαιώσετε ότι ο Oracle Client, το service name και τα διαπιστευτήριά σας λειτουργούν, πριν τα εισαγάγετε στο digna.

Βήμα 1¶

Το TNS Service Name που προσφέρεται εδώ προέρχεται από το tnsnames.ora της εγκατάστασης του Oracle Client σας — εκεί ορίζεται το alias, και μαζί του ο host, το port και το service name. Στο digna μπορείτε να χρησιμοποιήσετε το alias ως DBQ ή, εναλλακτικά, τον πλήρη descriptor.

Βήμα 2 – Δοκιμή της σύνδεσης¶

Κάντε κλικ στο κουμπί Test Connection.

Δώστε τον κωδικό πρόσβασης και κάντε κλικ στο κουμπί OK.

Ένα μήνυμα επιτυχίας επιβεβαιώνει ότι ο driver και τα διαπιστευτήρια λειτουργούν.