API Fabric για προβολή σχήματος GraphQL και εξερεύνηση σχημάτων
Το σχήμα GraphQL, το οποίο βασίζεται στη γλώσσα ορισμού σχήματος GraphQL (SDL), ορίζει τη μορφή των δεδομένων που εμφανίζονται στο API. Πρόκειται για ένα επίπεδο αφαίρεσης που παρέχει ευελιξία στους καταναλωτές, αποκρύπτοντας παράλληλα τις λεπτομέρειες υλοποίησης παρασκηνίου. Το σχήμα βασίζεται σε μια συλλογή τύπων αντικειμένων που περιέχουν πεδία.
Προβολή σχήματος
Μπορείτε να αποκτήσετε πρόσβαση στην προβολή σχήματος επιλέγοντας Σχήμα στην κάτω αριστερή γωνία της οθόνης Ανάπτυξη δεδομένων. Η προβολή εμφανίζει μια έκδοση βάσει κειμένου του GraphQL SDL με τύπους, πεδία και λειτουργίες που δημιουργήθηκαν.
Η παρακάτω εικόνα είναι ένα παράδειγμα της προβολής σχήματος, συμπεριλαμβανομένης μιας εκτεταμένης λίστας αντικειμένων που είναι διαθέσιμα σε αυτό το σχήμα.
Σημείωμα
Η προβολή σχήματος είναι μόνο για ανάγνωση. Μπορείτε να τροποποιήσετε αντικείμενα μόνο στην Εξερεύνηση σχημάτων.
Εξερεύνηση σχημάτων
Η Εξερεύνηση σχημάτων βρίσκεται στο τμήμα παραθύρου στα αριστερά και είναι επίσης διαθέσιμη όταν χρησιμοποιείτε το πρόγραμμα επεξεργασίας στην προβολή ερωτήματος. Η εξερεύνηση επιτρέπει στους χρήστες να απεικονίζουν γρήγορα τους διαθέσιμους τύπους και πεδία, καθώς και ερωτήματα και μεταλλάξεις, που ορίζονται στο API.
Όλοι οι τύποι GraphQL που είναι διαθέσιμοι από τα αντικείμενα που επιλέγετε όταν συνδέεστε σε μια προέλευση δεδομένων εμφανίζονται στη λίστα Εξερεύνηση σχημάτων. Οι τύποι εμφανίζονται με το όνομα της προέλευσης δεδομένων από την οποία προέρχονται. Στην παρακάτω εικόνα, βλέπετε τον τύπο SalesOrderDetail που προέρχεται από τον πίνακα SalesOrderDetail στο τελικό σημείο ανάλυσης SQL AdventureWorks.
Εκτός από τους τύπους, το API Fabric για GraphQL δημιουργεί αυτόματα ερωτήματα και μεταλλάξεις για τυχόν νέα αντικείμενα που επιλέγετε να εκθέσετε.
Στο παράδειγμά μας AdventureWorks, η ανάπτυξη της λίστας ερωτημάτων εμφανίζει τα ερωτήματα που δημιουργούνται αυτόματα για την προέλευση δεδομένων.
Για να δείτε τις μεταλλάξεις που δημιουργούνται αυτόματα από το API, επεκτείνετε τον κόμβο μεταλλάξεων στο δέντρο εξερεύνησης σχημάτων.
Τροποποίηση αντικειμένων με χρήση της Εξερεύνησης σχημάτων
Μπορείτε να χρησιμοποιήσετε την Εξερεύνηση σχημάτων για να τροποποιήσετε αντικείμενα αφού το API τα δημιουργήσει για εσάς. Στο παρακάτω παράδειγμα, επιλέγουμε τα αποσιωπητικά δίπλα στον τύπο SalesOrderDetail που προέρχονται από τη βάση δεδομένων μας AdventureWorks :
Οι παρακάτω επιλογές είναι διαθέσιμες για τους τύπους:
- Ενημέρωση σχήματος - Σάς επιτρέπει να ενημερώσετε το σχήμα με νέα αντικείμενα από την προέλευση δεδομένων.
- Μετονομασία - Αλλάζει το όνομα του αντικειμένου. ΣΗΜΕΙΩΣΗ: Αυτή η αλλαγή επηρεάζει μόνο το σχήμα API και δεν έχει καμία επίδραση στο αρχικό αντικείμενο προέλευσης δεδομένων από το οποίο προήλθε.
- Κατάργηση από το σχήμα - Ουσιαστικά, διαγράφει το αντικείμενο από το σχήμα GraphQL, ώστε να μην μπορείτε πλέον να το αναφέρετε.
- Διαχείριση σχέσεων - Σας μεταφέρει στην εμπειρία διαχείρισης σχέσεων. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Διαχείριση σχέσεων στο API Fabric για GraphQL.
- Ιδιότητες - Εμφανίζει πρόσθετες πληροφορίες σχετικά με το αντικείμενο.
Ενεργοποίηση και απενεργοποίηση ερωτημάτων και μεταλλάξεων
Η δυνατότητα ενεργοποίησης/απενεργοποίησης για ερωτήματα και μεταλλάξεις παρέχει στους διαχειριστές και τους προγραμματιστές λεπτομερή έλεγχο της πρόσβασης και χρήσης του API. Σας επιτρέπει να ενεργοποιήσετε ή να απενεργοποιήσετε επιλεκτικά συγκεκριμένα ερωτήματα και μεταλλάξεις μέσα στο σχήμα GraphQL. Αυτό σας επιτρέπει να διαχειρίζεστε τις δυνατότητες του API δυναμικά χωρίς να τροποποιείτε κώδικα ή να αναπτύσσετε αλλαγές.
Τα ερωτήματα και οι μεταλλάξεις στην εξερεύνηση σχημάτων έχουν δύο πρόσθετες επιλογές:
- Απενεργοποίηση - Αποτρέπει τυχόν αιτήσεις από την εκτέλεση του ερωτήματος ή μετάλλαξης. Εάν επιχειρηθεί εκτέλεση, επιστρέφεται σφάλμα. Όταν ένα ερώτημα ή μια μετάλλαξη απενεργοποιηθεί, πραγματοποιείται επαναφόρτωση σχήματος και το ερώτημα ή η μετάλλαξη εμφανίζεται απενεργοποιημένα στην εξερεύνηση σχημάτων.
- Ενεργοποίηση - Ενεργοποιήστε ξανά ένα ερώτημα ή μετάλλαξη που ήταν ήδη απενεργοποιημένο. Η εκτέλεση του στοιχείου είναι αμέσως διαθέσιμη κατά τη λειτουργία επαναφόρτωσης σχήματος που πραγματοποιείται αφού ενεργοποιηθεί η επιλογή Ενεργοποίηση .
Λάβετε υπόψη ότι ερωτήματα ή μεταλλάξεις που δημιουργούνται αυτόματα από αποθηκευμένες διαδικασίες μπορούν μόνο να διαγραφούν. Αφού διαγραφούν, μπορούν να προστεθούν ξανά χρησιμοποιώντας τις επιλογές Λήψη δεδομένων ή Ενημέρωση σχήματος .