Δημιουργία και διαχείριση αποθηκευμένων λειτουργιών

Οι συναρτήσεις είναι ερωτήματα που επαναχρησιμοποιούνται ή τμήματα ερωτημάτων. Η Ευφυΐα σε πραγματικό χρόνο υποστηρίζει δύο τύπους συναρτήσεων:

  • Ενσωματωμένες συναρτήσεις, οι οποίες είναι ενσωματωμένες συναρτήσεις που δεν μπορείτε να τροποποιήσετε.

  • Συναρτήσεις που ορίζονται από τον χρήστη, οι οποίες χωρίζονται σε δύο τύπους:

    • Αποθηκευμένες συναρτήσεις: συναρτήσεις που ορίζονται από το χρήστη και τις οποίες αποθηκεύετε και διαχειρίζεστε ως οντότητες σχήματος βάσης δεδομένων, όπως πίνακες. Για περισσότερες πληροφορίες σχετικά με τον τρόπο δημιουργίας και διαχείρισης αποθηκευμένων συναρτήσεων, ανατρέξτε στην ενότητα Επισκόπηση διαχείρισης αποθηκευμένων συναρτήσεων.
    • Συναρτήσεις οριζόμενες από ερώτημα: συναρτήσεις οριζόμενες από το χρήστη που ορίζετε και χρησιμοποιείτε εντός του πεδίου εφαρμογής ενός μεμονωμένου ερωτήματος. Ορίζετε αυτές τις συναρτήσεις μέσω μιας let δήλωσης. Για περισσότερες πληροφορίες σχετικά με τον τρόπο δημιουργίας συναρτήσεων που ορίζονται από ερωτήματα, ανατρέξτε στο θέμα Δημιουργία συνάρτησης οριζόμενης από το χρήστη.

Σε αυτό το άρθρο, θα μάθετε πώς μπορείτε να δημιουργήσετε ή να τροποποιήσετε μια υπάρχουσα αποθηκευμένη συνάρτηση χρησιμοποιώντας το .create-or-alterfunction.

Για περισσότερες πληροφορίες σχετικά με την .create-or-alterfunction εντολή, ανατρέξτε στο θέμα .create-or-alter function.

Προαπαιτούμενα στοιχεία

Δημιουργία συναρτήσεων

Αυτή η δυνατότητα σάς επιτρέπει να δημιουργήσετε ή να τροποποιήσετε μια υπάρχουσα συνάρτηση χρησιμοποιώντας την .create-or-alterfunction εντολή. Η εντολή αποθηκεύει τη συνάρτηση στα μεταδεδομένα της βάσης δεδομένων. Εάν η συνάρτηση με το παρεχόμενο functionName δεν υπάρχει στα μεταδεδομένα της βάσης δεδομένων, η εντολή δημιουργεί μια νέα συνάρτηση. Διαφορετικά, η εντολή αλλάζει την ονομαζόμενη συνάρτηση.

  1. Μεταβείτε στη βάση δεδομένων KQL και επιλέξτε Νέα>συνάρτηση. Η .create-or-alter εντολή εμφανίζεται αυτόματα στο παράθυρο Εξερεύνηση των δεδομένων σας .

    Στιγμιότυπο οθόνης μιας σελίδας προορισμού βάσης δεδομένων KQL που εμφανίζει το αναπτυσσόμενο μενού Νέα επιλογή. Επισημαίνεται η επιλογή με τίτλο Λειτουργία.

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

    Στιγμιότυπο οθόνης του παραθύρου Εξερεύνηση των δεδομένων σας που εμφανίζει τη συνάρτηση που μόλις δημιουργήθηκε στο Real-Time Intelligence.

    Οι αποθηκευμένες συναρτήσεις εμφανίζονται στην περιοχή Συναρτήσεις στο παράθυρο Εξερεύνηση .

    Στιγμιότυπο οθόνης του παραθύρου Explorer που εμφανίζει τη λίστα των αποθηκευμένων συναρτήσεων που ορίζονται από το χρήστη.

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

    Στιγμιότυπο οθόνης του παραθύρου Εξερεύνηση των δεδομένων σας που εμφανίζει τα αποτελέσματα ερωτήματος μιας αποθηκευμένης συνάρτησης στο Real-Time Intelligence.

Λίστα αποθηκευμένων συναρτήσεων

Μπορείτε να δείτε μια λίστα με όλες τις αποθηκευμένες λειτουργίες στη βάση δεδομένων. Κάνοντας αριστερό κλικ στην επιλογή Λειτουργίες ή επιλέγοντας Εμφάνιση συναρτήσεων στο αναπτυσσόμενο μενού, μπορείτε να ανοίξετε τη λίστα συναρτήσεων.
Στιγμιότυπο οθόνης του δέντρου συναρτήσεων στο παράθυρο Εξερεύνηση.

Η λίστα περιλαμβάνει:

  • Ο φάκελος της συνάρτησης και η περιγραφή της.
  • Προαιρετικές δυνατότητες ταξινόμησης και αναζήτησης που θα σας βοηθήσουν να βρείτε συγκεκριμένες λειτουργίες.

Στιγμιότυπο οθόνης της λίστας των αποθηκευμένων λειτουργιών.

Κάνοντας αριστερό κλικ σε μια συνάρτηση στη λίστα ανοίγει μια έκδοση προεπισκόπησης μόνο για ανάγνωση της συνάρτησης. Στο αναπτυσσόμενο μενού, μπορείτε επίσης να επιλέξετε Εμφάνιση συνάρτησης για να ανοίξετε την έκδοση προεπισκόπησης της συνάρτησης , να επεξεργαστείτε ή να διαγράψετε τη συνάρτηση.

Οργανώστε τις λειτουργίες με φακέλους

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

  1. Στο παράθυρο εξερεύνησης, είτε:
    • Κάντε δεξί κλικ στη λειτουργία και επιλέξτε Μετακίνηση σε φάκελο>+ Νέος φάκελος.
      Στιγμιότυπο οθόνης του αναδυόμενου μενού που δείχνει την επιλογή δημιουργίας νέου φακέλου για τη λειτουργία.
    • Εναλλακτικά, επιλέξτε τα αποσιωπητικά (...) δίπλα στη συγκεκριμένη συνάρτηση και επιλέξτε Μετακίνηση σε φάκελο>+ Νέος φάκελος ή επιλέξτε έναν υπάρχοντα φάκελο.
      Στιγμιότυπο οθόνης του αναδυόμενου μενού που δείχνει την επιλογή μετακίνησης της συνάρτησης σε έναν υπάρχοντα φάκελο ή δημιουργίας νέου.
  2. Για να δημιουργήσετε έναν φάκελο, πληκτρολογήστε ένα όνομα για τον φάκελο και επιλέξτε Δημιουργία. Η συνάρτηση μετακινείται στον νέο φάκελο.
    Στιγμιότυπο οθόνης του νέου φακέλου που δημιουργείται.
  3. Για να μετακινήσετε περισσότερες από μία λειτουργίες, εισαγάγετε ένα άλλο όνομα φακέλου ή επιλέξτε το αναπτυσσόμενο μενού και επιλέξτε τα πλαίσια δίπλα στις λειτουργίες που θέλετε να μετακινήσετε στον ίδιο φάκελο.
    Στιγμιότυπο οθόνης του αναδυόμενου μενού που εμφανίζει την επιλογή μετακίνησης πολλών λειτουργιών στον ίδιο φάκελο.
  4. Μπορείτε επίσης να μετακινήσετε συναρτήσεις σε έναν υπάρχοντα φάκελο. Για να το κάνετε αυτό, επιλέξτε Μετακίνηση σε φάκελο και, στη συνέχεια, επιλέξτε το φάκελο στον οποίο θέλετε να μετακινήσετε τη συνάρτηση ή σύρετε και αποθέστε τη συνάρτηση στο φάκελο.

Σημείωμα

  • Εάν διαγράψετε έναν υποφάκελο, οι λειτουργίες εντός του φακέλου δεν διαγράφονται, αλλά μετακινούνται πίσω στον γονικό φάκελο.
  • Ένας υποφάκελος διαγράφεται αυτόματα όταν δεν υπάρχουν λειτουργίες μέσα στο φάκελο.
  • Οι φάκελοι μπορούν να δημιουργηθούν ανά τύπο πάγιου στοιχείου και το όνομα πρέπει να είναι μοναδικό ανά τύπο πάγιου στοιχείου. Για παράδειγμα, μπορείτε να έχετε έναν φάκελο πίνακα και έναν φάκελο συναρτήσεων με το ίδιο όνομα, αλλά δεν μπορείτε να έχετε δύο φακέλους συναρτήσεων με το ίδιο όνομα.

Προβολή και προεπισκόπηση μιας αποθηκευμένης λειτουργίας

Για να προβάλετε ή να κάνετε προεπισκόπηση μιας υπάρχουσας αποθηκευμένης συνάρτησης, ακολουθήστε τα εξής βήματα:

  1. Στο παράθυρο Εξερεύνηση , αναπτύξτε την ενότητα Λειτουργίες . Κάντε αριστερό κλικ στην επιθυμητή λειτουργία για να ανοίξετε την προεπισκόπηση ή επιλέξτε τις τρεις τελείες και τη λειτουργία εμφάνισης.

  2. Ανοίγει μια έκδοση μόνο για ανάγνωση της δέσμης ενεργειών συνάρτησης στο παράθυρο Εξερεύνηση των δεδομένων σας .

    • Μπορείτε να επιλέξετε Προεπισκόπηση αποτελεσμάτων για προεπισκόπηση των αποτελεσμάτων της συνάρτησης.
    • Εάν η συνάρτηση περιλαμβάνει παραμέτρους, μπορείτε να εισαγάγετε τιμές για αυτές τις παραμέτρους. Στη συνέχεια, επιλέξτε Προεπισκόπηση αποτελεσμάτων για να δείτε την έξοδο με βάση τις τιμές παραμέτρων που παρείχατε.
    • Τα αποτελέσματα προεπισκόπησης εμφανίζουν έως και 100 εγγραφές με βάση το ερώτημα της συνάρτησης.

    Στιγμιότυπο οθόνης του παραθύρου Εξερεύνηση των δεδομένων σας που εμφανίζει μια αποθηκευμένη δέσμη ενεργειών συνάρτησης.

Επεξεργασία ή διαγραφή αποθηκευμένης συνάρτησης

Για να επεξεργαστείτε ή να διαγράψετε μια υπάρχουσα αποθηκευμένη λειτουργία, ακολουθήστε τα παρακάτω βήματα:

  1. Στο παράθυρο Εξερεύνηση , αναπτύξτε την ενότητα Λειτουργίες . Επιλέξτε τις τρεις τελείες δίπλα στην επιθυμητή λειτουργία.

  2. Από το αναπτυσσόμενο μενού, επιλέξτε ένα από τα εξής:

    • Επεξεργασία με κώδικα για να επεξεργαστείτε τη δέσμη ενεργειών συνάρτησης στο παράθυρο Εξερεύνηση των δεδομένων σας .

    Στιγμιότυπο οθόνης του αναπτυσσόμενου μενού.

  3. Εάν τροποποιήσατε τη δέσμη ενεργειών συνάρτησης, επιλέξτε Εκτέλεση για να αποθηκεύσετε τις αλλαγές σας.