Κοινή χρήση μέσω

Σύνδεση στο Microsoft OneLake

  • Άρθρο

Το Microsoft OneLake παρέχει ανοιχτή πρόσβαση σε όλα τα στοιχεία Fabric μέσω των υπαρχόντων API Και SDK Azure Data Lake Storage (ADLS) Gen2. Μπορείτε να αποκτήσετε πρόσβαση στα δεδομένα σας στο OneLake μέσω οποιουδήποτε API, SDK ή εργαλείου που είναι συμβατό με το ADLS Gen2, απλώς χρησιμοποιώντας ένα URI OneLake. Μπορείτε να αποστείλετε δεδομένα σε μια λίμνη μέσω της Εξερεύνησης υπηρεσίας αποθήκευσης Azure ή να διαβάσετε έναν πίνακα δέλτα μέσω μιας συντόμευσης από το Azure Databricks.

Καθώς το OneLake είναι λογισμικό ως υπηρεσία (SaaS), ορισμένες λειτουργίες, όπως η διαχείριση δικαιωμάτων ή η ενημέρωση στοιχείων, πρέπει να γίνονται μέσω εμπειριών Fabric αντί για ADLS Gen2 API. Για μια πλήρη λίστα των αλλαγών σε αυτά τα API, ανατρέξτε στο θέμα Ισοτιμία API OneLake.

Σύνταξη URI

Επειδή το OneLake υπάρχει σε ολόκληρο τον μισθωτή σας Microsoft Fabric, μπορείτε να αναφερθείτε σε οτιδήποτε στον μισθωτή σας σύμφωνα με τον χώρο εργασίας, το στοιχείο και τη διαδρομή του:

https://onelake.dfs.fabric.microsoft.com/<workspace>/<item>.<itemtype>/<path>/<fileName>

Σημείωμα

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

Το OneLake υποστηρίζει επίσης την αναφορά χώρων εργασίας και στοιχείων με καθολικά μοναδικά αναγνωριστικά (GUID). Η oneLake αντιστοιχίζει GUID και GUID δεν αλλάζουν, ακόμη και αν αλλάξει το όνομα του χώρου εργασίας ή του στοιχείου. Μπορείτε να βρείτε το συσχετισμένο GUID για τον χώρο εργασίας ή το στοιχείο στη διεύθυνση URL στην πύλη Fabric. Πρέπει να χρησιμοποιήσετε GUID τόσο για τον χώρο εργασίας όσο και για το στοιχείο και δεν χρειάζεστε τον τύπο στοιχείου.

https://onelake.dfs.fabric.microsoft.com/<workspaceGUID>/<itemGUID>/<path>/<fileName>

Κατά την υιοθέτηση ενός εργαλείου για χρήση μέσω OneLake αντί του ADLS Gen2, χρησιμοποιήστε την ακόλουθη αντιστοίχιση:

  • Το όνομα λογαριασμού είναι πάντα onelake.
  • Το όνομα κοντέινερ είναι το όνομα του χώρου εργασίας σας.
  • Η διαδρομή δεδομένων ξεκινά από το στοιχείο. Για παράδειγμα: /mylakehouse.lakehouse/Files/.

Το OneLake υποστηρίζει επίσης το πρόγραμμα οδήγησης συστήματος αρχείων blob Azure (ABFS) για μεγαλύτερη συμβατότητα με τα ADLS Gen2 και Azure Blob Storage. Το πρόγραμμα οδήγησης ABFS χρησιμοποιεί το δικό του αναγνωριστικό abfs συνδυασμού και διαφορετική μορφή URI για την αντιμετώπιση αρχείων και καταλόγων σε λογαριασμούς ADLS Gen2. Για να χρησιμοποιήσετε αυτήν τη μορφή URI σε OneLake, αλλάξτε τον χώρο εργασίας για το σύστημα αρχείων και συμπεριλάβετε τον τύπο στοιχείου και στοιχείου.

abfs[s]://<workspace>@onelake.dfs.fabric.microsoft.com/<item>.<itemtype>/<path>/<fileName>

Το URI προγράμματος οδήγησης abfs δεν επιτρέπει ειδικούς χαρακτήρες, όπως κενά διαστήματα, στο όνομα του χώρου εργασίας. Σε αυτές τις περιπτώσεις, μπορείτε να αναφερθείτε σε χώρους εργασίας και στοιχεία με τα καθολικά μοναδικά αναγνωριστικά (GUID), όπως περιγράφεται παραπάνω σε αυτή την ενότητα.

Εξουσιοδότηση

Μπορείτε να ελέγξετε την ταυτότητα των API OneLake χρησιμοποιώντας το Αναγνωριστικό Entra της Microsoft, μεταβιβάζοντας μια κεφαλίδα εξουσιοδότησης. Εάν ένα εργαλείο υποστηρίζει τη σύνδεση στον λογαριασμό σας Azure για την ενεργοποίηση της διαβίβασης διακριτικού, μπορείτε να επιλέξετε οποιαδήποτε συνδρομή. Το OneLake απαιτεί μόνο το διακριτικό χρήστη σας και δεν ενδιαφέρεται για τη συνδρομή σας Azure.

Όταν καλείτε απευθείας το OneLake μέσω API DFS, μπορείτε να κάνετε έλεγχο ταυτότητας με ένα διακριτικό φορέα για τον λογαριασμό σας Microsoft Entra. Για να μάθετε περισσότερα σχετικά με την αίτηση και τη διαχείριση διακριτικών κομιστή για τον οργανισμό σας, ανατρέξτε στη Βιβλιοθήκη ελέγχου ταυτότητας της Microsoft.

Για γρήγορες, ad-hoc δοκιμές του OneLake με απευθείας κλήσεις API, δείτε ένα απλό παράδειγμα χρήσης του PowerShell για είσοδο στον λογαριασμό σας Azure, ανάκτηση ενός διακριτικού εμβέλειας χώρου αποθήκευσης και αντιγραφή του στο πρόχειρό σας για εύκολη χρήση αλλού. Για περισσότερες πληροφορίες σχετικά με την ανάκτηση διακριτικών πρόσβασης με χρήση του PowerShell, ανατρέξτε στο θέμα Get-AzAccessToken.

Σημείωμα

Το OneLake υποστηρίζει μόνο διακριτικά στο Storage κοινό. Στο παρακάτω παράδειγμα, ορίζουμε το κοινό μέσω της ResourceTypeName παραμέτρου.

Connect-AzAccount
$testToken = Get-AzAccessToken -ResourceTypeName Storage
$testToken.Token | Set-Clipboard

Αποθήκευση δεδομένων

Εάν χρησιμοποιείτε το καθολικό τελικό σημείο ('https://onelake.dfs.fabric.microsoft.com') για να υποβάλετε ερωτήματα σε δεδομένα σε μια περιοχή διαφορετική από την περιοχή του χώρου εργασίας σας, υπάρχει πιθανότητα τα δεδομένα να εγκαταλείψουν την περιοχή σας κατά τη διάρκεια της διαδικασίας επίλυσης τελικού σημείου. Εάν ανησυχείτε για το σημείο αποθήκευσης δεδομένων, η χρήση του σωστού τοπικού τελικού σημείου για τον χώρο εργασίας σας εξασφαλίζει ότι τα δεδομένα σας παραμένουν εντός της τρέχουσας περιοχής και δεν διασχίζουν τα περιφερειακά όρια. Μπορείτε να ανακαλύψετε το σωστό τελικό σημείο περιοχής, ελέγχοντας την περιοχή των εκχωρημένων πόρων στους οποίους συνδέεται ο χώρος εργασίας.

Τα τελικά σημεία της περιοχής OneLake έχουν όλες την ίδια μορφή: https://<region>-onelake.dfs.fabric.microsoft.com. Για παράδειγμα, ένας χώρος εργασίας που συνδέεται σε ένα σύνολο εκχωρημένων πόρων στην περιοχή των Δυτικών Η.Π.Α. θα είναι προσβάσιμος μέσω του τοπικού τελικού σημείου https://westus-onelake.dfs.fabric.microsoft.com.

Συνήθη προβλήματα

Εάν ένα εργαλείο ή πακέτο που είναι συμβατό με το ADLS Gen2 δεν λειτουργεί μέσω του OneLake, το πιο συνηθισμένο ζήτημα είναι η επικύρωση διεύθυνσης URL. Καθώς το OneLake χρησιμοποιεί ένα διαφορετικό τελικό σημείο (dfs.fabric.microsoft.com) από το ADLS Gen2 (dfs.core.windows.net), ορισμένα εργαλεία δεν αναγνωρίζουν το τελικό σημείο OneLake και το αποκλείουν. Ορισμένα εργαλεία σάς επιτρέπουν να χρησιμοποιείτε προσαρμοσμένα τελικά σημεία (όπως το PowerShell). Διαφορετικά, συχνά είναι μια απλή επιδιόρθωση για να προσθέσετε το τελικό σημείο του OneLake ως υποστηριζόμενο τελικό σημείο. Εάν εντοπίσετε κάποιο πρόβλημα επικύρωσης διεύθυνσης URL ή έχετε τυχόν άλλα προβλήματα που συνδέονται με το OneLake, ενημερώστε μας.

Δείγματα

Δημιουργία αρχείου

Αίτηση ΒΆΖΩ https://onelake.dfs.fabric.microsoft.com/{workspace}/{item}.{itemtype}/Files/sample?resource=file
Κεφαλίδες Authorization: Bearer <userAADToken>
Response Κωδικός απόκρισης: 201 Created
Κεφαλίδες:
x-ms-version : 2021-06-08
x-ms-request-id : 272526c7-0995-4cc4-b04a-8ea3477bc67b
x-ms-content-crc64 : OAJ6r0dQWP0=
x-ms-request-server-encrypted : true
ETag : 0x8DA58EE365
Σώμα:

Σχετικό περιεχόμενο