Κοινοποίηση μέσω

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

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

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

Σύνταξη URI

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

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

Σημείωμα

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

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

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

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

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

Το OneLake υποστηρίζει επίσης το πρόγραμμα οδήγησης Azure Blob Filesystem (ABFS) για μεγαλύτερη συμβατότητα με το ADLS και το Azure Blob Storage. Το πρόγραμμα οδήγησης ABFS χρησιμοποιεί το δικό του αναγνωριστικό abfs σχήματος και μια διαφορετική μορφή URI για τη διεύθυνση αρχείων και καταλόγων σε λογαριασμούς ADLS. Για να χρησιμοποιήσετε αυτήν τη μορφή 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 -AsSecureString -ResourceTypeName Storage
# Retrieved token is of string type which you can validate with the "$testToken.Token.GetTypeCode()" command.
$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 δεν λειτουργεί μέσω του OneLake, το πιο συνηθισμένο πρόβλημα είναι η επικύρωση URL. Καθώς το OneLake χρησιμοποιεί διαφορετικό τελικό σημείο (dfs.fabric.microsoft.com) από το ADLS (dfs.core.windows.net), ορισμένα εργαλεία δεν αναγνωρίζουν το τελικό σημείο OneLake και το αποκλείουν. Ορισμένα εργαλεία σάς επιτρέπουν να χρησιμοποιείτε προσαρμοσμένα τελικά σημεία (όπως το PowerShell). Διαφορετικά, συχνά είναι μια απλή επιδιόρθωση για να προσθέσετε το τελικό σημείο του OneLake ως υποστηριζόμενο τελικό σημείο. Εάν εντοπίσετε κάποιο πρόβλημα επικύρωσης διεύθυνσης URL ή έχετε τυχόν άλλα προβλήματα που συνδέονται με το OneLake, ενημερώστε μας.

Πόροι

Το OneLake είναι προσβάσιμο μέσω των ίδιων API και SDK με το ADLS. Για να μάθετε περισσότερα σχετικά με τη χρήση των API ADLS, ανατρέξτε στις ακόλουθες σελίδες:

Δείγματα

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

Αίτηση ΒΆΖΩ 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
Σώμα:

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

  • Last updated on