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


Επισκόπηση των API πίνακα OneLake

Το OneLake προσφέρει ένα τελικό σημείο REST API για αλληλεπίδραση με πίνακες στο Microsoft Fabric. Αυτό το τελικό σημείο μπορεί να χρησιμοποιηθεί με πελάτες και βιβλιοθήκες που είναι συμβατές με το ανοιχτό πρότυπο Iceberg REST Catalog (IRC) API ή το ανοιχτό πρότυπο Unity Catalog API.

Σημαντικό

Αυτή η δυνατότητα βρίσκεται προεπισκόπηση.

Προαπαιτούμενα

Η χρήση αυτών των API είναι απλή μόλις εντοπίσετε μερικές πληροφορίες και επιλέξετε την προτιμώμενη ροή ελέγχου ταυτότητας Microsoft Entra ID.

Συλλογή βασικών πληροφοριών

Για να χρησιμοποιήσετε αυτά τα API, πρέπει πρώτα να συγκεντρώσετε τις ακόλουθες πληροφορίες:

  • Το αναγνωριστικό μισθωτή Fabric.

    Το αναγνωριστικό μισθωτή είναι ένα GUID και μπορείτε να το βρείτε στην κάρτα Προφίλ ή στο μενού **Βοήθεια, Πληροφορίες για το Fabric στο Fabric.

  • Το αναγνωριστικό χώρου εργασίας και στοιχείου δεδομένων του στοιχείου δεδομένων (όπως μια λίμνη) με έναν κατάλογο πινάκων ανώτατου επιπέδου.

    Αυτά τα αναγνωριστικά είναι GUID. Μπορούν να βρεθούν στη διεύθυνση URL του OneLake οποιουδήποτε πίνακα στο OneLake. Εναλλακτικά, μπορούν να βρεθούν στη διεύθυνση URL που εμφανίζεται στο πρόγραμμα περιήγησής σας, όταν έχετε ανοιχτό ένα στοιχείο δεδομένων στο Fabric.

  • Η ταυτότητα χρήστη ή κύριας υπηρεσίας στο Microsoft Entra ID που έχει δικαιώματα ανάγνωσης πινάκων στο επιλεγμένο στοιχείο δεδομένων.

Προετοιμασία για έλεγχο ταυτότητας

  1. Αποφασίστε πώς θέλετε να πραγματοποιήσετε έλεγχο ταυτότητας με το Microsoft Entra ID για να αποκτήσετε ένα διακριτικό πρόσβασης για την ταυτότητα Microsoft Entra που έχετε επιλέξει.

    Μπορείτε να ελέγξετε αυτόν τον οδηγό για να μάθετε σχετικά με τους διαφορετικούς τρόπους απόκτησης διακριτικού πρόσβασης με το Microsoft Entra ID. Η Microsoft προσφέρει εύχρηστες βιβλιοθήκες ελέγχου ταυτότητας σε πολλές γλώσσες.

  2. Εάν αναπτύσσετε μια νέα εφαρμογή που είτε θα επιτρέπει στους χρήστες να εισέρχονται είτε να συνδέονται ως αυτόνομη εφαρμογή, καταχωρήστε την εφαρμογή σας με το Microsoft Entra ID.

  3. Εκχωρήστε δικαιώματα API για το ακροατήριο διακριτικού Χώρος αποθήκευσης Azure (https://storage.azure.com/), στην εφαρμογή Microsoft Entra ID. Η παραχώρηση αυτής της άδειας διασφαλίζει ότι η εφαρμογή σας μπορεί να αποκτήσει διακριτικά για χρήση με το τελικό σημείο πίνακα OneLake.

    Σημείωμα

    Το τελικό σημείο API πίνακα OneLake δέχεται το ίδιο κοινό διακριτικού με τα τελικά σημεία του συστήματος αρχείων OneLake.

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

Λειτουργίες API Iceberg REST Catalog (IRC) στο OneLake

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

Σημείωμα

Πριν χρησιμοποιήσετε τα API του Iceberg, βεβαιωθείτε ότι έχετε ενεργοποιήσει τη μετατροπή μετα-δεδομένων Delta Lake σε Iceberg για τον μισθωτή ή τον χώρο εργασίας σας. Ανατρέξτε στις οδηγίες, για να μάθετε πώς μπορείτε να ενεργοποιήσετε την αυτόματη μετατροπή μορφής πίνακα Delta Lake σε Iceberg.

Λειτουργίες Delta Lake REST API στο OneLake

Μάθετε πώς μπορείτε να ξεκινήσετε με το τελικό σημείο API πίνακα OneLake για να αλληλεπιδράσετε με πίνακες Delta στο OneLake.