Source Connector για το Snowflake¶

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

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

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

Εγκαταστήστε τον Snowflake ODBC Driver στο μηχάνημα που εκτελεί το backend του digna, ακολουθώντας τον οδηγό εγκατάστασης της Snowflake.

Ο driver καταχωρίζεται ως SnowflakeDSIIDriver. Διαβάστε το ακριβές καταχωρισμένο όνομα στον host σας, όπως περιγράφεται στην ενότητα Εγκατάσταση του ODBC Driver στον Host του digna.

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

Η πρόσβαση στο Snowflake γίνεται με ένα programmatic access token (PAT) — τη μέθοδο αυθεντικοποίησης με την οποία έχει επαληθευτεί το digna, και αυτήν που απαιτεί το Snowflake για λογαριασμούς στους οποίους η είσοδος μόνο με κωδικό πρόσβασης είναι αποκλεισμένη.

Παράδειγμα, όχι προδιαγραφή

Το παρακάτω σύνολο είναι ένας συνδυασμός που είναι γνωστό ότι λειτουργεί. Οι ιδιότητες ανήκουν στον Snowflake ODBC driver, οπότε τα ονόματα, οι προεπιλογές και οι αποδεκτές τιμές τους διαφέρουν ανάμεσα σε εκδόσεις driver και πλατφόρμες, και το ποιες επιλογές αυθεντικοποίησης επιτρέπει ο λογαριασμός σας καθορίζεται από την πολιτική ασφαλείας του λογαριασμού. Χρησιμοποιήστε το ως σημείο εκκίνησης και ελέγξτε την τεκμηρίωση της έκδοσης driver που εγκαταστήσατε.

Κλειδί	Παράδειγμα τιμής	Σημειώσεις
`Driver`	`{SnowflakeDSIIDriver}`	Πρέπει να ταιριάζει με το όνομα του driver που είναι καταχωρισμένο στον host του digna
`Server`	`<account>.snowflakecomputing.com`	Αναγνωριστικό λογαριασμού μαζί με το επίθημα, π.χ. `rx42698.switzerland-north.azure.snowflakecomputing.com`
`UID`	`digna`	Ο χρήστης Snowflake στον οποίο ανήκει το token
`Database`	`TEST`	Η βάση δεδομένων που περιέχει τα schemas πηγής. Είναι η μόνη βάση δεδομένων στην οποία αυτή η σύνδεση μπορεί να κάνει profiling
`Schema`	`PUBLIC`	Προεπιλεγμένο schema του session
`authenticator`	`PROGRAMMATIC_ACCESS_TOKEN`	Επιλέγει την αυθεντικοποίηση με token
`token`	`<programmatic access token>`	Επιλέξτε Encrypted

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

Driver={SnowflakeDSIIDriver};Server=<account>.snowflakecomputing.com;UID=digna;Database=TEST;Schema=PUBLIC;authenticator=PROGRAMMATIC_ACCESS_TOKEN;token=<programmatic access token>

Warehouse και role¶

Τα queries χρειάζονται ένα warehouse. Αν ο χρήστης του digna έχει προεπιλεγμένο warehouse και προεπιλεγμένο role, το session τα χρησιμοποιεί αυτόματα και δεν χρειάζεται καμία διαμόρφωση. Διαφορετικά προσθέστε:

Κλειδί	Παράδειγμα τιμής	Σημειώσεις
`Warehouse`	`DIGNA_WH`	Το warehouse που εκτελεί τα queries profiling
`Role`	`DIGNA_READER`	Το role του οποίου τα grants χρησιμοποιεί το session

Δώστε στο digna δικό του warehouse

Ένα ξεχωριστό, μικρό warehouse με auto-suspend κρατά το κόστος του profiling ορατό και αποτρέπει το digna από το να ανταγωνίζεται τους διαδραστικούς χρήστες για υπολογιστικούς πόρους.

Αυθεντικοποίηση με κωδικό πρόσβασης¶

Όπου ο λογαριασμός το επιτρέπει ακόμη, ένας κωδικός πρόσβασης λειτουργεί στη θέση του token — αφαιρέστε τα authenticator και token και προσθέστε:

Κλειδί	Παράδειγμα τιμής	Σημειώσεις
`PWD`	`<password>`	Επιλέξτε Encrypted

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

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

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

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

Τα tokens λήγουν. Ένα programmatic access token εκδίδεται με συγκεκριμένη διάρκεια ζωής, και το profiling σταματά την ημέρα που λήγει. Σημειώστε την ημερομηνία λήξης όταν το δημιουργείτε, και εισαγάγετε ξανά το νέο token στην ιδιότητα token — οι κρυπτογραφημένες τιμές μπορούν να αντικατασταθούν αλλά όχι να διαβαστούν ξανά.
Μία σύνδεση βλέπει μία βάση δεδομένων. Το digna προσφέρει τα schemas της βάσης δεδομένων που ορίζεται στο Database, επειδή το Snowflake αναφέρει μόνο την τρέχουσα βάση δεδομένων ως catalog. Πίνακες πηγής σε άλλη βάση δεδομένων χρειάζονται δική τους σύνδεση.
Τα αναγνωριστικά είναι με κεφαλαία, εκτός αν δημιουργήθηκαν σε εισαγωγικά. Το digna χρησιμοποιεί τα ονόματα όπως τα αναφέρει το Snowflake.
Profiling modes. Το Permanent δημιουργεί τους πίνακες εργασίας στο Work Schema, οπότε το role χρειάζεται CREATE TABLE εκεί. Το Session χρησιμοποιεί CREATE TEMPORARY TABLE και δεν αγγίζει το Work Schema. Το Standard χρειάζεται μόνο πρόσβαση ανάγνωσης — και κανένα grant εγγραφής.

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

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

Βήμα 1¶

Βήμα 1

Σημειώσεις:

Η τιμή για το Server αποτελείται από το αναγνωριστικό του λογαριασμού σας στο Snowflake, ακολουθούμενο από .snowflakecomputing.com.
Τα Database, Schema και Warehouse που εισάγονται εδώ αντιστοιχούν στις ιδιότητες Database, Schema και Warehouse της ενότητας 2.

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

Κάντε κλικ στο κουμπί TEST. Μια επιτυχημένη σύνδεση θα πρέπει να μοιάζει ως εξής:

Βήμα 2