Διαχείριση συνδέσεων σε προελεύσεις δεδομένων

Μπορείτε να δημιουργείτε, να ενημερώνετε, να μοιράζεστε και να αφαιρείτε συνδέσεις με πηγές δεδομένων. Ως χρήστης του Oracle Analytics με δικαίωμα πρόσβασης Συντάκτη περιεχομένου DV, μπορείτε να εκτελείτε αυτές τις ενέργειες.

Θέματα:

Δημιουργία σύνδεσης σε μια προέλευση δεδομένων

Μπορείτε να δημιουργήσετε μια σύνδεση που θα σας επιτρέψει να αναλύετε δεδομένα στη συγκεκριμένη προέλευση δεδομένων.

  1. Στην Αρχική σελίδα, κάντε κλικ στην επιλογή Δημιουργία και έπειτα επιλέξτε Σύνδεση.
  2. Στο πλαίσιο διαλόγου Επιλογή τύπου σύνδεσης, κάντε κλικ στο εικονίδιο για τον τύπο σύνδεσης που θέλετε. Για παράδειγμα, Oracle Database.
  3. Εισαγάγετε τις απαιτούμενες πληροφορίες σύνδεσης, όπως κεντρικός υπολογιστής, θύρα, όνομα χρήστη, κωδικός πρόσβασης και όνομα υπηρεσίας.
  4. Προαιρετικά: Κάντε μια επιλογή για την Πιστοποίηση της σύνδεσής σας.
    • Να χρησιμοποιούνται πάντα αυτά τα διαπιστευτήρια - Το Oracle Analytics χρησιμοποιεί πάντα το όνομα χρήστη και τον κωδικό πρόσβασης που ορίζετε για τη σύνδεση. Δεν ζητείται από τους χρήστες να συνδεθούν.
    • Να απαιτείται από τους χρήστες η εισαγωγή των δικών τους διαπιστευτηρίων - Το Oracle Analytics ζητά από τους χρήστες να εισαγάγουν το δικό τους όνομα χρήστη και τον κωδικό πρόσβασής τους για την προέλευση δεδομένων. Οι χρήστες έχουν πρόσβαση μόνο στα δεδομένα για τα οποία έχουν κατάλληλα δικαιώματα, προνόμια και ρόλους.
    • (Εμφανίζεται εφόσον το Oracle Analytics υποστηρίζει τη δυνατότητα μίμησης για αυτόν τον τύπο βάσης δεδομένων.) Χρήση διαπιστευτηρίων ενεργού χρήστη - Το Oracle Analytics δεν ζητά από τους χρήστες να συνδεθούν για να αποκτήσουν πρόσβαση στα δεδομένα. Τα ίδια διαπιστευτήρια με τα οποία γίνεται η σύνδεση στο Oracle Analytics χρησιμοποιούνται και για την πρόσβαση σε αυτήν την προέλευση δεδομένων.
  5. Εάν συνδέεστε σε μια απομακρυσμένη βάση δεδομένων, κάντε κλικ στην επιλογή Χρήση απομακρυσμένης συνδεσιμότητας δεδομένων.
    Ελέγξτε με τον διαχειριστή σας ότι έχετε δυνατότητα πρόσβασης στην απομακρυσμένη βάση δεδομένων.
  6. Αν θέλετε να χρησιμοποιήσετε αυτές τις λεπτομέρειες σύνδεσης στο Semantic Modeler ή το Model Administration Tool, κάντε κλικ στην επιλογή Σύνδεση συστήματος. Ανατρέξτε στην ενότητα Επιλογές σύνδεσης βάσης δεδομένων.
  7. Κάντε κλικ στην επιλογή "Αποθήκευση".
    Μπορείτε πλέον να ξεκινήσετε να δημιουργείτε βιβλία εργασίας ή σύνολα δεδομένων χρησιμοποιώντας αυτήν τη σύνδεση. Για παράδειγμα, στην Αρχική σελίδα, κάντε κλικ στην επιλογή Δημιουργία, κάντε κλικ στην επιλογή Σύνολο δεδομένων και κατόπιν επιλέξτε τη σύνδεση που μόλις δημιουργήσατε.

Επεξεργασία μιας σύνδεσης προέλευσης δεδομένων

Μπορείτε να ενημερώσετε τις λεπτομέρειες σύνδεσης μιας προέλευσης δεδομένων.

Αν επεξεργάζεστε μια σύνδεση SSL σε μια Oracle Database και πρέπει να χρησιμοποιήσετε ένα νέο αρχείο cwallet.sso , στο πεδίο "Πορτοφόλι client" , πατήστε "Επιλογή" για να αναζητήσετε το αρχείο cwallet.sso . Ρωτήστε τον διαχειριστή σας για τη θέση του αρχείου cwallet.sso .

  1. Στην Αρχική σελίδα, κάντε κλικ στην Πλοήγηση, επιλέξτε Δεδομένα και έπειτα Συνδέσεις.
  2. Μετακινήστε τον δείκτη του ποντικιού πάνω από τη σύνδεση που θέλετε να τροποποιήσετε. Δεξιά από την επισημασμένη σύνδεση, κάντε κλικ στην επιλογή Ενέργειες και έπειτα επιλέξτε Επιθεώρηση.
  3. Στο παράθυρο διαλόγου "Επιθεώρηση", επεξεργαστείτε τις λεπτομέρειες σύνδεσης.
    Δεν μπορείτε να δείτε τον τρέχοντα κωδικό πρόσβασης ή τη λογική SQL για τις συνδέσεις. Αν πρέπει να αλλάξετε αυτά τα στοιχεία, δημιουργήστε μια νέα σύνδεση.
  4. Κάντε κλικ στην επιλογή "Αποθήκευση".

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

Μπορείτε να καταργήσετε μια σύνδεση προέλευσης δεδομένων από το Oracle Analytics Cloud. Για παράδειγμα, πρέπει να διαγράψετε μια σύνδεση βάσης δεδομένων και να δημιουργήσετε μια νέα σύνδεση όταν έχει αλλάξει ο κωδικός πρόσβασης της βάσης δεδομένων.

Αν η σύνδεση περιέχει σύνολα δεδομένων, τότε θα πρέπει να διαγράψετε τα σύνολα δεδομένων για να διαγράψετε τη σύνδεση.

  1. Μεταβείτε στη σελίδα "Δεδομένα»και επιλέξτε "Συνδέσεις".
  2. Μετακινήστε τον δείκτη του ποντικιού πάνω από τη σύνδεση που θέλετε να διαγράψετε. Δεξιά από την επισημασμένη σύνδεση, κάντε κλικ στην επιλογή Ενέργειες και έπειτα επιλέξτε Διαγραφή.
  3. Επιλέξτε "Ναι".

Κοινή χρήση μιας σύνδεσης προέλευσης δεδομένων

Μπορείτε να εκχωρήσετε δικαιώματα στις συνδέσεις προέλευσης δεδομένων που δημιουργείτε ή διαχειρίζεστε.

  1. Στην Αρχική σελίδα κάντε κλικ στην Πλοήγηση. Επιλέξτε Δεδομένα και έπειτα Συνδέσεις.
  2. Τοποθετήστε τον δείκτη του ποντικιού πάνω από τη σύνδεση που θέλετε να κοινοποιήσετε, κάντε κλικ την επιλογή Ενέργειες και έπειτα επιλέξτε Επιθεώρηση.
  3. Κάντε κλικ στην επιλογή Πρόσβαση και χρησιμοποιήστε τις καρτέλες για να εκχωρήσετε πρόσβαση:

    • Όλοι - Κοινοποιήστε τη σύνδεση σε μεμονωμένους χρήστες ή ρόλους.

    • Χρήστες - Κοινοποιήστε τη σύνδεση σε μεμονωμένους χρήστες.

    • Ρόλοι - Κοινοποιήστε τη σύνδεση σε ρόλους εφαρμογής (για παράδειγμα, BI Consumer), έτσι ώστε όλοι οι χρήστες με αυτούς τους ρόλους να μπορούν να χρησιμοποιήσουν τη σύνδεση.

  4. Χρησιμοποιήστε το πλαίσιο Προσθήκη για να αναζητήσετε και να επιλέξετε έναν χρήστη ή έναν ρόλο.
    Ο χρήστης ή ο ρόλος εμφανίζεται στη λίστα παρακάτω με τα προεπιλεγμένα δικαιώματα Μόνο για ανάγνωση.
  5. Για να αλλάξετε τα προεπιλεγμένα δικαιώματα, επιλέξτε ένα από τα εξής:
    • Πλήρης έλεγχος - Ο χρήστης ή ο ρόλος μπορεί να χρησιμοποιεί τη σύνδεση για να δημιουργεί σύνολα δεδομένων και να τροποποιεί, να μετονομάζει ή να διαγράψει τη σύνδεση. Επίσης, μπορεί να αλλάζει τα δικαιώματα για τη σύνδεση.
    • Ανάγνωση-Εγγραφή - Ο χρήστης ή ο ρόλος μπορεί να χρησιμοποιεί τη σύνδεση για να δημιουργεί σύνολα δεδομένων και να τροποποιεί ή να μετονομάζει τη σύνδεση (αλλά όχι για να τη διαγράψει).
    • Μόνο για ανάγνωση - Ο χρήστης ή ο ρόλος μπορεί να χρησιμοποιεί τη σύνδεση για να δημιουργεί σύνολα δεδομένων αλλά όχι για να αλλάζει τις λεπτομέρειες της σύνδεσης.
  6. Κάντε κλικ στην επιλογή "Αποθήκευση".
Την επόμενη φορά που θα συνδεθούν οι χρήστες, θα μπορέσουν να χρησιμοποιήσουν τις συνδέσεις που έχετε κοινοποιήσει για να απεικονίσουν δεδομένα από αυτή τη βάση δεδομένων.

Επιλογές σύνδεσης βάσης δεδομένων

Όταν καθορίζετε λεπτομέρειες σύνδεσης χρησιμοποιώντας το παράθυρο διαλόγου "Δημιουργία σύνδεσης" ή το παράθυρο διαλόγου "Επιθεώρηση", ορισμένοι τύποι βάσης δεδομένων έχουν επιπλέον επιλογές διαμόρφωσης.

Γενικές επιλογές

  • Όταν δημιουργείτε συνδέσεις στο Oracle Databases, μπορείτε να κάνετε σύνδεση με δύο τρόπους χρησιμοποιώντας την επιλογή Τύπος σύνδεσης:
    • Βασική - Προσδιορίστε Κεντρικό υπολογιστή, Θύρα και Όνομα υπηρεσίας της βάσης δεδομένων.
    • Σύνθετη - Στο πεδίο Συμβολοσειρά σύνδεσης προσδιορίστε το αναγνωριστικό Single Client Access Name (SCAN) των βάσεων δεδομένων που εκτελούνται σε ένα σύμπλεγμα RAC. Για παράδειγμα:

      sales.example.com =(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.111)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.222)(PORT=1521)) (ADDRESS=(PROTOCOL=tcp)(HOST=123.45.67.333)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME= salesservice.example.com)))

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

Επιλογές ελέγχου ταυτότητας

  • Να χρησιμοποιούνται πάντα αυτά τα διαπιστευτήρια - Το Oracle Analytics χρησιμοποιεί πάντα το όνομα χρήστη και τον κωδικό πρόσβασης που ορίζετε για τη σύνδεση. Δεν ζητείται από τους χρήστες να συνδεθούν.
  • Να απαιτείται από τους χρήστες η εισαγωγή των δικών τους διαπιστευτηρίων - Το Oracle Analytics ζητά από τους χρήστες να εισαγάγουν το δικό τους όνομα χρήστη και τον κωδικό πρόσβασής τους για την προέλευση δεδομένων. Οι χρήστες έχουν πρόσβαση μόνο στα δεδομένα για τα οποία έχουν κατάλληλα δικαιώματα, προνόμια και ρόλους.
  • (Εμφανίζεται εφόσον το Oracle Analytics υποστηρίζει τη δυνατότητα μίμησης για αυτόν τον τύπο βάσης δεδομένων.) Χρήση διαπιστευτηρίων ενεργού χρήστη - Το Oracle Analytics δεν ζητά από τους χρήστες να συνδεθούν για να αποκτήσουν πρόσβαση στα δεδομένα. Τα ίδια διαπιστευτήρια με τα οποία γίνεται η σύνδεση στο Oracle Analytics χρησιμοποιούνται και για την πρόσβαση σε αυτήν την προέλευση δεδομένων.

Σύνδεση συστήματος

Πατήστε Αντιγραφή για να αντιγράψετε το Αναγνωριστικό αντικειμένου της σύνδεσης. Οι δημιουργοί μοντέλων της επιχείρησης μπορούν να επικολλήσουν στο Αναγνωριστικό αντικειμένου για να προσδιορίσουν και να χρησιμοποιήσουν μια σύνδεση δεδομένων στο Εργαλείο διαχείρισης μοντέλων (πλαίσιο διαλόγου "Χώρος συγκέντρωσης συνδέσεων").

Σημείωση: Εάν δεν επιλέξετε Σύνδεση συστήματος όταν δημιουργείτε αρχικά τη σύνδεση, και αργότερα θέλετε οι δημιουργοί μοντέλων δεδομένων να χρησιμοποιούν τις λεπτομέρειες της σύνδεσης, θα πρέπει να δημιουργήσετε μια νέα σύνδεση και να επιλέξετε Σύνδεση συστήματος. Με άλλα λόγια, δεν μπορείτε να επεξεργαστείτε αργότερα τη σύνδεση και να κάνετε αυτήν την επιλογή.

Όρια σύνδεσης βάσης δεδομένων

Κατανοήστε τις απαιτήσεις της σύνδεσης βάσης δεδομένων σας προτού δημιουργήσετε τη σύνδεση βάσης δεδομένων.

Ο μέγιστος αριθμός πινάκων βάσεων δεδομένων που εμφανίζονται στο Oracle Analytics είναι 10.000. Αν χρειάζεστε περισσότερους πίνακες, η Oracle συνιστά να ζητήσετε από τον διαχειριστή της βάσης δεδομένων σας να δημιουργήσει έναν χρήστη βάσης δεδομένων με πρόσβαση στα συγκεκριμένα αντικείμενα που θέλετε να αναλύσετε και να καθορίσετε τα διαπιστευτήρια του συγκεκριμένου χρήση κατά τη δημιουργία της σύνδεσης βάσης δεδομένων.

Σύνδεση σε δεδομένα με κεφαλαίους, πεζούς ή μεικτούς χαρακτήρες

Αν συνδέεστε σε μια βάση δεδομένων Oracle, στο Oracle Autonomous Data Warehouse, στο Oracle Transaction Processing, στο Snowflake, στο SQL Server ή στο My SQL, μπορείτε να αλλάξετε το προεπιλεγμένο αναγνωριστικό χρήσης εισαγωγικών, ώστε να μπορείτε να διαβάζετε τα δεδομένα με κεφαλαία γράμματα, πεζά γράμματα ή μεικτούς χαρακτήρες στα ονόματα πινάκων ή στηλών.

Για παράδειγμα, μπορείτε να επιλέξετε τα διπλά εισαγωγικά ως αναγνωριστικό χρήσης εισαγωγικών. Στη συνέχεια, το Oracle Analytics προσθέτει διπλά εισαγωγικά στην υποκείμενη δήλωση SQL select "EfG_Field" from "AbCd"; αντί να εκδώσει τη δήλωση select EfG_Field from AbCd; (το οποίο θα αποτύγχανε).
  1. Στην Αρχική σελίδα, κάντε κλικ στην επιλογή Δημιουργία και έπειτα επιλέξτε Σύνδεση.
  2. Κάντε κλικ σε έναν από τους τύπος βάσης δεδομένων που υποστηρίζει σύνθετες ιδιότητες.
    Οι υποστηριζόμενες βάσεις δεδομένων είναι Oracle, Oracle Autonomous Data Warehouse, Snowflake και My SQL.
  3. Καθορίστε τις λεπτομέρειες της σύνδεσης και αποθηκεύστε την.
  4. Στην αρχική σελίδα, κάντε κλικ στο Εργαλείο πλοήγησης, επιλέξτε Δεδομένα και έπειτα Συνδέσεις.
  5. Τοποθετήστε τον δείκτη του ποντικιού πάνω στη σύνδεση που αποθηκεύσατε στο Βήμα 2, επιλέξτε Ενέργειες και έπειτα Επιθεώρηση.
  6. Κάντε κλικ στις Σύνθετες επιλογές και έπειτα χρησιμοποιήστε την επιλογή "Αναγνωριστικά χρήσης εισαγωγικών" για να επιλέξετε τα αναγνωριστικά χρήσης εισαγωγικών που χρησιμοποιούνται στη βάση δεδομένων.
    Ακολουθεί η περιγραφή για GUID-5CC9BEE2-0AED-4863-AE6C-EAD513188FEA-default.png
    .png''

    Για παράδειγμα, μπορείτε να επιλέξετε Διπλά εισαγωγικά (" "). Το Oracle Analytics προσθέτει διπλά εισαγωγικά στην υποκείμενη δήλωση SQL select "EfG_Field" from "AbCd"; αντί να εκδώσει τη δήλωση select EfG_Field from AbCd;.

    Σημείωση:

    Οι Σύνθετες επιλογές δεν θα εμφανίζονται αν η σύνδεση έχει δημιουργηθεί με επιλεγμένη τη Σύνδεση συστήματος. Οι Σύνθετες επιλογές δεν υποστηρίζονται για τις συνδέσεις συστήματος.
  7. Κάντε κλικ στην επιλογή "Αποθήκευση".

Διαχείριση συνδέσεων με χρήση REST API

Μπορείτε να χρησιμοποιήσετε Oracle Analytics Cloud REST API για την προγραμματιστική διαχείριση συνδέσεων σε ένα εύρος προελεύσεων δεδομένων. Για παράδειγμα, μπορεί να θέλετε να δημιουργήσετε μια δέσμη ενεργειών η οποία δημιουργεί (ή τροποποιεί) το ίδιο σύνολο συνδέσεων στα περιβάλλοντα δοκιμών και παραγωγής του Oracle Analytics Cloud.

Πληροφορίες σχετικά με τα REST API συνδέσεων

Μπορείτε να δημιουργήσετε, να ενημερώσετε και να διαγράψετε συνδέσεις για ένα εύρος προελεύσεων δεδομένων, χρησιμοποιώντας REST API. Στο θέμα αυτό παρατίθενται οι τύποι των συνδέσεων προέλευσης δεδομένων που μπορείτε να διαχειρίζεστε με REST API.

Σημείωση:

Το REST API για το Oracle Analytics Cloud παρέχει αναλυτικές πληροφορίες για το κάθε REST API. Ανατρέξτε στην ενότητα Τελικά σημεία REST σύνδεσης.

Υποστηριζόμενες προελεύσεις δεδομένων

  • Oracle Database
  • Oracle Autonomous Data Warehouse
  • Oracle Essbase
  • MySQL
  • PostgreSQL
  • Snowflake
  • SQL Server
  • Vertica

Παράμετροι σύνδεσης

Οι παράμετροι σύνδεσης που απαιτούνται για κάθε προέλευση δεδομένων διαφέρουν. Εάν θέλετε να χρησιμοποιήσετε το REST API για να δημιουργήσετε ή να ενημερώσετε μια σύνδεση, πρέπει να γνωρίζετε τη μορφή φορτίου JSON που απαιτείται για την προέλευση δεδομένων σας. Ανατρέξτε στην ενότητα Δείγμα φορτίων JSON για πηγές δεδομένων.

Τυπική ροή εργασιών για διαχείριση συνδέσεων με χρήση REST API

Αυτές είναι οι κοινές εργασίες για να ξεκινήσετε να χρησιμοποιείτε τα Oracle Analytics Cloud REST API για την προγραμματιστική διαχείριση συνδέσεων. Εάν χρησιμοποιείτε τα REST API για πρώτη φορά, ακολουθήστε αυτές τις εργασίες ως οδηγό.

Εργασία Περιγραφή Τεκμηρίωση REST API
Κατανόηση προαπαιτούμενων

Κατανοήστε και ολοκληρώστε αρκετές προαπαιτούμενες εργασίες.

Πρέπει να έχετε δικαιώματα δημιουργίας βιβλίων εργασίας και σύνδεσης σε δεδομένα στο Oracle Analytics Cloud για τη διαχείριση συνδέσεων δεδομένων με τη χρήση REST API (Συντάκτης περιεχομένου οπτικοποίησης δεδομένων).

 Αναγκαίες προϋποθέσεις
Κατανόηση της πιστοποίησης συμβόλων OAuth 2.0 Η πιστοποίηση και η εξουσιοδότηση στο Oracle Analytics Cloud είναι υπό διαχείριση από την υπηρεσία Oracle Identity Cloud Service. Για την πρόσβαση στα Oracle Analytics Cloud REST API, χρειάζεστε ένα σύμβολο πρόσβασης OAuth 2.0 για να το χρησιμοποιήσετε για εξουσιοδότηση. Πιστοποίηση συμβόλων OAuth 2.0
Κατανόηση των υποστηριζόμενων προελεύσεων δεδομένων Διαβάστε το θέμα που περιγράφει τους τύπους των συνδέσεων δεδομένων που μπορείτε να διαχειρίζεστε με REST API. Υποστηριζόμενες προελεύσεις δεδομένων
Προσδιορισμός μορφών φορτίου JSON Διαβάστε το θέμα όπου περιγράφεται η μορφή φορτίου JSON για την προέλευση δεδομένων σας και λάβετε τις απαραίτητες παραμέτρους σύνδεσης. Δείγμα φορτίων JSON για πηγές δεδομένων
Δημιουργία μιας σύνδεσης Δημιουργήστε μια σύνδεση δεδομένων για χρήση σε βιβλία εργασίας, αναφορές και dashboard. Δημιουργία μιας σύνδεσης (Προεπισκόπηση)
Ενημέρωση μιας σύνδεσης Ενημερώστε μία ή περισσότερες ιδιότητες μιας υπάρχουσας σύνδεσης δεδομένων. Ενημέρωση μιας σύνδεσης (Προεπισκόπηση)
Διαγραφή μιας σύνδεσης Διαγράψτε μια σύνδεση δεδομένων. Διαγραφή μιας σύνδεσης (Προεπισκόπηση)

Τρόπος χρήσης των REST API για τη διαχείριση συνδέσεων πηγών δεδομένων

Χρησιμοποιήστε αυτά τα δείγματα και τα παραδείγματα, για να σας βοηθήσουν να διαχειριστείτε συνδέσεις προελεύσεων δεδομένων με αιτήσεις REST API χρησιμοποιώντας cURL.

Δείγμα μορφής cURL

Χρησιμοποιήστε την ακόλουθη μορφή εντολής cURL για να δημιουργήσετε ή να ενημερώσετε συνδέσεις προέλευσης δεδομένων με τη χρήση REST API:
  • Απλό JSON 
    curl 
--header "Authorization: Bearer <token>" 
--header "Content-Type: application/json" 
--request POST|PUT https://<hostname>/api/20210901/catalog/connections
--data "<data source connection payload>"
  • Πολλαπλών μερών/Δεδομένα φόρμας 
    curl 
--header "Authorization: Bearer <token>" 
--request POST|PUT https://<hostname>/api/20210901/catalog/connections
--form "cert=<security wallet file>"
--form "connectionParams=<data source connection payload>"
Όπου:

  • <token> - Το διακριτικό φορέα OAuth 2.0 απαιτείται για τον έλεγχο ταυτότητας κλήσεων προς τα Oracle Analytics Cloud REST API. Ανατρέξτε στην ενότητα Πιστοποίηση συμβόλων OAuth 2.0.

  • <hostname> - Κεντρικός υπολογιστής όπου εκτελείται το Oracle Analytics Cloud.

  • <data source connection payload> - Πληροφορίες σύνδεσης συγκεκριμένης προέλευσης δεδομένων. Ανατρέξτε στην ενότητα Δείγμα φορτίων JSON για πηγές δεδομένων.

  • <security wallet file> - Αποθηκεύει πληροφορίες που σχετίζονται με το SSL, όπως διαπιστευτήρια ελέγχου ταυτότητας και εισόδου, ιδιωτικά κλειδιά, πιστοποιητικά και αξιόπιστα πιστοποιητικά. Απαιτείται για ορισμένους τύπους σύνδεσης, όπως Oracle Database με SSL και Oracle Autonomous Data Warehouse (αμοιβαίο TLS).

Παραδείγματα

Τα ακόλουθα παραδείγματα δείχνουν πώς θα δημιουργήσετε μια σύνδεση στο Oracle Autonomous Data Warehouse (ADW).

  • Παράδειγμα 1 - Δημιουργία μιας σύνδεσης χωρίς ψηφιακό πορτοφόλι (TLS) στο Oracle ADW
  • Παράδειγμα 2 - Δημιουργία μιας σύνδεσης στο Oracle ADW που χρησιμοποιεί ένα αρχείο ψηφιακού πορτοφολιού διαπιστευτηρίων cwallet.sso (αμοιβαίο TLS)

Πρόσθετα παραδείγματα διατίθενται στο REST API για το Oracle Analytics Cloud. Ανατρέξτε στην ενότητα Δημιουργία μιας σύνδεσης (Προεπισκόπηση), Ενημέρωση μιας σύνδεσης (Προεπισκόπηση) και Διαγραφή μιας σύνδεσης (Προεπισκόπηση).

Σημείωση:

Τα φορτία JSON στα παραδείγματα αυτά είναι ειδικά για το Oracle ADW. Η μορφή φορτίου JSON διαφέρει για άλλες προελεύσεις δεδομένων. Ανατρέξτε στην ενότητα Δείγμα φορτίων JSON για υποστηριζόμενες προελεύσεις δεδομένων.

Παράδειγμα 1 Δημιουργία μιας σύνδεσης χωρίς ψηφιακό πορτοφόλι (TLS) στο Oracle ADW

Σε αυτό το παράδειγμα, δημιουργείτε μια σύνδεση που ονομάζεται oracle_adw_walletless. Το σώμα κειμένου αιτήματος περιλαμβάνει ένα απλό JSON application/json. 
curl 
  --header "Authorization: Bearer <token>"
  --header "Content-Type: application/json" 
  --request POST https://example.com/api/20210901/catalog/connections 
  --data "{
     "version": "2.0.0",
     "type": "connection",
     "name": "oracle_adw_walletless",
     "description": "Δείγμα σύνδεσης Oracle ADW χωρίς πορτοφόλι που δημιουργήθηκε με το API συνδέσεων",
     "content": {    
       "connectionParams": {
           "connectionType": "oracle-autonomous-data-warehouse",
           "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_adwwalletless_high.adb.oraclecloud.com))(security=(ssl_server_dn_match=yes)))",
           "username": "ADMIN",
           "password": "<<password>>",
           "systemConnection": false,        
           "remoteData": false,
           "sslType": "ServerSideSSL"
       }
     }
   }"

Κυρίως τμήμα απόκρισης

{"connectionID":"J0FkbWluJy4nb3JhY2xlX2Fkd193YWxsZXRsZXNzJw=="}

Δημιουργήστε μια σημείωση για το connectionId με κωδικοποίηση Base64 στο κυρίως τμήμα απόκρισης. Αργότερα, μπορείτε να χρησιμοποιήσετε αυτήν την τιμή για να ενημερώσετε ή να διαγράψετε τη σύνδεση.

Παράδειγμα 2 Δημιουργία μιας σύνδεσης στο Oracle ADW που χρησιμοποιεί ένα αρχείο ψηφιακού πορτοφολιού (αμοιβαίο TLS)

Σε αυτό το παράδειγμα, δημιουργείτε μια σύνδεση που ονομάζεται oracle_adw_with_wallet. Το κυρίως τμήμα αιτήματος περιλαμβάνει multipart/form-data, που σημαίνει ότι χρειάζεται ένα αρχείο ψηφιακού πορτοφολιού από το Oracle ADW (cwallet.sso), αλλά και παραμέτρους σύνδεσης Oracle ADW. 
curl
 --header "Authorization: Bearer <token>"
 -–request POST https://<hostname>/api/20210901/catalog/connections 
 --form "cert=@"/Users/scott/Downloads/Wallet_adw/cwallet.sso"" 
 --form "connectionParams= "{
    "version": "2.0.0",
    "type": "connection",
    "name": "oracle_adw_with_wallet",
    "description": "Δείγμα σύνδεσης Oracle ADW με πορτοφόλι που δημιουργήθηκε με το API συνδέσεων",   
    "content": {
      "connectionParams": {
        "connectionType": "oracle-autonomous-data-warehouse",
        "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-ashburn-1.oraclecloud.com))(connect_data=(service_name=abcdefg1hijkl2m_walletadw_high.adwc.oraclecloud.com/))(security=(ssl_server_dn_match=yes)))",
        "username": "ADMIN",
        "password": "<<password>>",
        "remoteData": "false",   
        "systemConnection": false,
        "sslType": "ClientSideSSL"    
       }
      }
    }"

Κυρίως τμήμα απόκρισης

{"connectionID":"J2FkbWluJy4nb3JhY2xlX2Fkd193aXRoX3dhbGxldCc="}

Δημιουργήστε μια σημείωση για το connectionId με κωδικοποίηση Base64 στο κυρίως τμήμα απόκρισης. Αργότερα, μπορείτε να χρησιμοποιήσετε αυτήν την τιμή για να ενημερώσετε ή να διαγράψετε τη σύνδεση.

Δείγμα φορτίων JSON για πηγές δεδομένων

Για να συνδεθείτε σε μια πηγή δεδομένων, παρέχετε παραμέτρους σύνδεσης. Όταν χρησιμοποιείτε το REST API συνδέσεων, πρέπει να ορίσετε τις παραμέτρους σύνδεσης σε μορφή φορτίου δεδομένων JSON. Χρησιμοποιήστε αυτόν τον πίνακα για τον προσδιορισμό του φορτίου JSON για την προέλευση δεδομένων στην οποία θέλετε να συνδεθείτε.

Προέλευση δεδομένων Τύπος αιτήματος Είσοδος φορτίου

Oracle Database

(Όχι SSL)

 application/json

Βασικός τύπος σύνδεσης

{ 
 "version": "2.0.0", 
 "type": "connection",  
 "name": "oracle_db_non_ssl_basic",
 "description": "Sample non-SSL Oracle Database connection created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "oracle-database",
     "host": "example.com",
     "port": "1521",
     "serviceName": "orcl",
     "username": "admin",
     "password": "<password>",
     "remoteData": false,
     "systemConnection": false
   }
  }
 }

Σύνθετος τύπος σύνδεσης

{
  "version": "2.0.0",
  "type": "connection",
  "name": "oracle_db_non_ssl_advanced ",
  "description": " Sample non-SSL Oracle Database connection created with the advanced connection string format using Connections API",
  "content": {
    "connectionParams": {
     "connectionString": "(DESCRIPTION= (ADDRESS_LIST= (LOAD_BALANCE=on)(FAILOVER=ON) (ADDRESS=(PROTOCOL=tcp)(HOST=example.com)(PORT=1521))) (CONNECT_DATA=(SERVICE_NAME=ORCLPDB1)))",
     "username": "admin",
     "password": "<password>",
     "connectionType": "oracle-database",
     "remoteData": false,
     "systemConnection": false
    }
  }
}

Oracle Database με SSL

 multi-part/form-data 
cwallet.sso (client credentials file)

Βασικός τύπος σύνδεσης

cert: <cwallet.sso file location>
connectionParams: {
 "version": "2.0.0",
 "type": "connection",
 "name": "oracle_db_ssl",
 "description": "Sample Oracle Database connection with SSL created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "oracle-database",
     "host": "example.com",
     "port": "2484",
     "serviceName": "ORCLPDB1",
     "username": "admin",
     "password": "<password>",
     "systemConnection": false,
     "remoteData": false
   }
  }
}

Oracle Autonomous Data Warehouse - Χωρίς ψηφιακό πορτοφόλι (TLS)

 application/json

Βασικός τύπος σύνδεσης

{
 "version": "2.0.0",
 "type": "connection",
 "name": "oracle_adw_walletless_basic",
 "description": "Sample Oracle ADW connection without a wallet created using Connections API",
 "content": {
   "connectionParams": { "connectionType": "oracle-autonomous-data-warehouse",
     "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1521) (host=example.com)) (connect_data=(service_name=example.com)) (security=(ssl_server_dn_match=yes)))",
     "username": "admin",
     "password": "<password>",
     "systemConnection": false,
     "remoteData": false,
     "sslType": "ServerSideSSL"
     }
   }
 }

Oracle Autonomous Data Warehouse - Ψηφιακό πορτοφόλι (αμοιβαίο TLS)

 multipart/form-data 
cwallet.sso (client credentials file)

Βασικός τύπος σύνδεσης

cert: <cwallet.sso file location>

connectionParams: {
 "version": "2.0.0",
 "type": "connection",
 "name": "oracle_adw_with_wallet",
 "description": "Sample Oracle ADW connection with wallet created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "oracle-autonomous-data-warehouse",
     "connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)
                        (port=1522)(host=example.com))
                        (connect_data=(service_name=example.com))
                        (security=(ssl_server_dn_match=yes)))",
     "username": "admin",
     "password": "<password>",
     "remoteData": "false",
     "systemConnection": false,
     "sslType": "ClientSideSSL"
    }
  }
 }

PostgreSQL

(Όχι SSL)

 application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "postgres_non_SSL",
 "description": "Sample PostgreSQL connection created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "postgresql-database",
     "host": "example.com",
     "port": "5432",
     "serviceName": "postgres",
     "username": "admin",
     "password": "<password>",
     "remoteData": false,
     "systemConnection": false 
    }
  }
}

PostgreSQL με SSL

 application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "postgres_SSL_Conn",
 "description": "Sample PostgreSQL connection with SSL created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "postgresql-database",
     "host": "example.com",
     "port": "5432",
     "serviceName": "postgres",
     "username": "admin",
     "password": "<password>",
     "sslType":"ServerSideSSL",
     "remoteData": false,
     "systemConnection": false
    }
  }
}

SQL Server

(Όχι SSL)

 application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "SqlServer_non_ssl",
 "description": "Sample non-SSL SQL Server connection created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "sqlserver-database",
     "host": "example.com",
     "port": "1400",
     "serviceName": "sqlserver1",
     "username": "admin",
     "password": "<password>",
     "remoteData": false,
     "systemConnection": false
    }
  }
}
SQL Server με SSL application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "SqlServer_ssl",
 "description": "Sample SQL Server connection with SSL created using the Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "sqlserver-database",
     "host": "example.com",
     "port": "60190",
     "serviceName": "sqlserver1",
     "username": "admin",
     "password": "<password>",
     "sslType":"ServerSideSSL",
     "remoteData": false,
     "systemConnection": false
    }
  }
}

MySQL

(Όχι SSL)

 application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "MySql_no_SSL",
 "description": "Sample MySQL connection created using the Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "mysql-database",
     "host": "example.com",
     "port": "3307",
     "serviceName": "mysql1",
     "username": "admin",
     "password": "<password>",
     "remoteData": false,
     "systemConnection": false
    }
 }
}
MySQL με SSL application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "MySql_ssl",
 "description": "Sample MySQL connection with SSL created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "mysql-database",
     "host": "example.com",
     "port": "3306",
     "serviceName": "mysql1",
     "username": "admin",
     "password": "<password>",
     "sslType":"ServerSideSSL",
     "remoteData": false,
     "systemConnection": false
    }
  }
}

Oracle Essbase

 application/json

Βασικός τύπος σύνδεσης

{
 "version":"2.0.0",
 "type": "connection",
 "name": "Oracle_Essbase",
 "description": "Sample Oracle Essbase connection created using Connections API",
 "content": {
   "connectionParams": {
     "connectionType": "oracle-essbase",
     "dsn":"example.com",
     "username":"admin",
     "password":"<password>",
     "remoteData": false,
     "systemConnection": false,
     "authentication":"current"/"private"/"sso"
    }
  }
}