Φάκελος σημασιολογικού μοντέλου έργου Power BI Desktop

Αυτό το άρθρο περιγράφει τα αρχεία και τους υποφακέλους σε έναν φάκελο Μοντέλο σημασιολογίας ενός έργου του Microsoft Power BI Desktop. Τα αρχεία και οι υποφάκελοι εδώ αντιπροσωπεύουν ένα σημασιολογικό μοντέλο Power BI. Ανάλογα με το έργο σας, ο φάκελος σημασιολογικού μοντέλου μπορεί να περιλαμβάνει:

1 - Αυτό το αρχείο είναι υποχρεωτικό.
2 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση με χρήση της μορφής TMSL.
3 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση με χρήση της μορφής TMDL.

Δεν περιλαμβάνουν όλοι οι φάκελοι μοντέλου σημασιολογίας έργου όλα τα αρχεία και τους υποφακέλους που περιγράφονται εδώ.

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

.pbi\localSettings.jsενεργοποιημένο

Περιέχει ρυθμίσεις σημασιολογικού μοντέλου που ισχύουν μόνο για τον τρέχοντα χρήστη και υπολογιστή. Θα πρέπει να περιλαμβάνεται στο gitIgnore ή σε άλλες εξαιρέσεις στοιχείων ελέγχου προέλευσης. Από προεπιλογή, το Git αγνοεί αυτό το αρχείο.

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο localSettings.json σχήματος.

.pbi\editorSettings.jsενεργοποιημένο

Περιέχει ρυθμίσεις προγράμματος επεξεργασίας σημασιολογικών μοντέλων που έχουν αποθηκευτεί ως μέρος του ορισμού σημασιολογικού μοντέλου για χρήση σε χρήστες και περιβάλλοντα.

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο editorSettings.json σχήματος.

.pbi\cache.abf

Ένα αρχείο αντιγράφου ασφαλείας υπηρεσιών ανάλυσης (ABF) που περιέχει ένα τοπικό αντίγραφο του μοντέλου και των δεδομένων στο cache κατά την τελευταία επεξεργασία του. Θα πρέπει να περιλαμβάνεται στο gitIgnore ή σε άλλες εξαιρέσεις στοιχείων ελέγχου προέλευσης. Από προεπιλογή, το Git αγνοεί αυτό το αρχείο.

Το Power BI Desktop μπορεί να ανοίξει ένα έργο χωρίς αρχείο cache.abf. Σε αυτή την περίπτωση, ανοίγει η αναφορά που είναι συνδεδεμένη σε ένα μοντέλο με ολόκληρο τον ορισμό του, αλλά χωρίς δεδομένα. Εάν υπάρχει cache.abf, το Power BI Desktop φορτώνει τα δεδομένα και αντικαθιστά τον ορισμό μοντέλου με τα μετα-δεδομένα μοντέλου σημασιολογίας στο έργο.

.pbi\unappliedChanges.jsενεργοποιημένο

Το Power BI Desktop σάς επιτρέπει να αποθηκεύσετε τις αλλαγές που πραγματοποιήθηκαν στο πρόγραμμα επεξεργασίας Μετασχηματισμός δεδομένων (Power Query) χωρίς να εφαρμόσετε πρώτα αυτές τις αλλαγές στο μοντέλο δεδομένων.

Εικόνα που εμφανίζει το παράθυρο διαλόγου Εφαρμογή αλλαγής ερωτήματος.

Όταν επιλέξετε Εφαρμογή αργότερα, οι μη εφαρμοσμένες αλλαγές αποθηκεύονται στο αρχείο unappliedChanges.json. Όταν οι αλλαγές σε εκκρεμότητα βρίσκονται στο αρχείο unappliedChanges, το Power BI Desktop σάς ζητά να εφαρμόσετε ή να απορρίψετε αυτές τις αλλαγές σε εκκρεμότητα:

Εικόνα που εμφανίζει προειδοποίηση αλλαγών σε εκκρεμότητα.

Εάν επιλέξετε Εφαρμογή αλλαγών, το Power BI Desktop αντικαθιστά τα ερωτήματα στα μετα-δεδομένα μοντέλου σημασιολογίας με τα ερωτήματα του unappliedChanges.json. Εάν έχετε επεξεργαστεί ερωτήματα εκτός του Power BI Desktop και υπάρχει ένα προηγούμενο αρχείο unappliedChanges.json, οι αλλαγές σας χάνονται και αντικαθίστανται από τα ερωτήματα σε unappliedChanges.json όταν εφαρμόζονται αυτές οι αλλαγές.

Το αρχείο unappliedChanges.json ενσωματώνεται αυτόματα στον ορισμό μοντέλου σημασιολογίας και αποθηκεύεται στο Git από προεπιλογή. Αυτό σας επιτρέπει να δεσμεύσετε τις τρέχουσες εργασίες σας στον κλάδο ανάπτυξης, που λειτουργεί ως αντίγραφο ασφαλείας και το καθιστά προσβάσιμο σε άλλα μέλη της ομάδας. Ωστόσο, μπορείτε να εξαιρέσετε αυτό το αρχείο από την παρακολούθηση του Git, εμποδίζοντας τις μισοτελειωμένες εργασίες ερωτημάτων να επηρεάσουν άλλους προγραμματιστές.

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο unappliedChanges.json σχήματος.

definition.pbism

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

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

Έκδοση Υποστηριζόμενες μορφές
1.0 Ο ορισμός μοντέλου σημασιολογίας πρέπει να αποθηκευτεί ως TMSL στο αρχείο model.bim.
4.0 ή νεότερη έκδοση Ο ορισμός μοντέλου σημασιολογίας μπορεί να αποθηκευτεί ως TMSL (αρχείο model.bim) ή TMDL (φάκελος\ορισμών).

Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο definition.pbism schema.

model.bim

Αυτό το αρχείο είναι διαθέσιμο μόνο εάν το έργο Power BI αποθηκεύεται με τη μορφή TMSL. Περιέχει έναν ορισμό αντικειμένου βάσης δεδομένων της γλώσσας δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL) του μοντέλου έργου.

ορισμός\ φάκελος

Αυτός ο φάκελος είναι διαθέσιμος μόνο εάν το έργο Power BI αποθηκεύεται χρησιμοποιώντας τη μορφή TMDL. Αντικαθιστά το αρχείο model.bim .

Αυτός ο φάκελος περιέχει έναν ορισμό αντικειμένου βάσης δεδομένων μοντέλου σε μορφή πίνακα (TMDL)Ορισμός αντικειμένου βάσης δεδομένων του μοντέλου έργου.

diagramLayout.json

Περιέχει μετα-δεδομένα διαγράμματος που ορίζουν τη δομή του μοντέλου σημασιολογίας που σχετίζεται με την αναφορά. Δεν μπορείτε να επεξεργαστείτε αυτό το αρχείο εξωτερικά.

.πλατφόρμα

Αρχείο πλατφόρμας Fabric που περιέχει ιδιότητες ζωτικής σημασίας για τον καθορισμό και τη διατήρηση της σύνδεσης μεταξύ των στοιχείων Fabric και του Git.

Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Η ενοποίηση Git δημιουργείται αυτόματα από αρχεία συστήματος.

DAXQueries\ φάκελο

Περιέχει ένα αρχείο για κάθε καρτέλα ερωτήματος προβολής ερωτήματος DAX που είναι αποθηκευμένη [Tab name].dax ως αρχείο DAX.

.pbi\daxQueries.jsενεργοποιημένο

Περιέχει ρυθμίσεις προγράμματος επεξεργασίας προβολής ερωτήματος DAX , όπως defaultTab ή σειρά tab.

Φάκελος TMDLScripts\

Περιέχει ένα αρχείο για κάθε καρτέλα δέσμης ενεργειών προβολής TMDL που είναι αποθηκευμένη [Tab name].tmdl ως αρχείο TMDL.

.pbi\tmdlscripts.jsενεργοποιημένο

Περιέχει ρυθμίσεις του προγράμματος επεξεργασίας προβολής TMDL , όπως defaultTab ή σειρά tab.

Μορφή TMDL

Με στόχο την παροχή μιας καλύτερης εμπειρίας ελέγχου προέλευσης και συν-ανάπτυξης, μπορείτε να αποθηκεύσετε τα αρχεία power BI Project (PBIP) χρησιμοποιώντας τη γλώσσα ορισμού μοντέλου σε μορφή πίνακα (TMDL) ως μορφή αρχείου σημασιολογικού μοντέλου.

Σε αντίθεση με τη γλώσσα δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL), το TMDL έχει σχεδιαστεί από την αρχή ώστε να είναι φιλικό προς τον άνθρωπο, διευκολύνοντας όχι μόνο την αναγνωσιμότητα αλλά και την εύκολη επεξεργασία σε οποιοδήποτε πρόγραμμα επεξεργασίας κειμένου. Αυτό αντιπροσωπεύει μια σημαντική βελτίωση για τον έλεγχο προέλευσης και τις εμπειρίες συνεργατικής ανάπτυξης.

Στιγμιότυπο οθόνης φιλικών διαφορών TMDL.

Αντί για ένα μεγάλο αρχείο JSON, όπως η Γλώσσα δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL), η TMDL έχει μια δομή φακέλου με ξεχωριστά αρχεία για κάθε πίνακα, προοπτική, ρόλο και κουλτούρα. Αυτό διευκολύνει την εργασία με άλλους χρήστες και την κατανόηση της δομής σημασιολογικών μοντέλων, απλώς εξετάζοντας τον φάκελο και τα αρχεία. Τελικά, αυτό οδηγεί σε μια εξαιρετική εμπειρία ελέγχου προέλευσης και συν-ανάπτυξης κατά τον χειρισμό διενέξεων git diff και συγχώνευσης.

Στιγμιότυπο οθόνης των diffs μοντέλου σημασιολογίας TMDL.

Μάθετε περισσότερα σχετικά με την TMDL εδώ.

Πραγματοποίηση εξωτερικών αλλαγών σε αρχεία TMDL

Μπορείτε να επεξεργαστείτε αρχεία TMDL σε Visual Studio Code ή σε κάποιο άλλο εξωτερικό εργαλείο, ενώ το έργο παραμένει ανοιχτό στο Power BI Desktop. Για μια καλύτερη εμπειρία επεξεργασίας TMDL, εγκαταστήστε την επέκταση TMDL για Visual Studio Code.

Πριν να επεξεργαστείτε τα αρχεία εξωτερικά, αποθηκεύστε τις αλλαγές στο Power BI Desktop. Ανοίξτε τον φάκελο PBIP στο VS Code, μεταβείτε στον φάκελο μοντέλο σημασιολογίας definition και αποθηκεύστε τις αλλαγές σας TMDL. Power BI Desktop εντοπίζει τις αποθηκευμένες αλλαγές και εμφανίζει το πλαίσιο Εφαρμογή εξωτερικών αλλαγών. Επιλέξτε Εφαρμογή εξωτερικών αλλαγών για να φορτώσετε ξανά το μοντέλο σημασιολογίας χωρίς να κλείσετε και ανοίξετε ξανά το έργο.

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

Εάν Power BI Desktop έχει μη αποθηκευμένες αλλαγές, σας προειδοποιεί ότι η εφαρμογή των εξωτερικών αλλαγών θα τις αντικαταστήσει. Για την πλήρη ροή εργασιών και τους περιορισμούς, ανατρέξτε στο θέμα Επεξεργασία αρχείων PBIP εκτός του Power BI Desktop.

Για υποστηριζόμενες λειτουργίες εγγραφής εκτός του Power BI Desktop, ανατρέξτε στο θέμα Σύνταξη μοντέλου.

Σφάλματα TMDL

Εάν μια επεξεργασία TMDL δεν είναι έγκυρη, Power BI Desktop εμφανίζει ένα σφάλμα όταν εφαρμόζετε τις εξωτερικές αλλαγές ή ανοίγετε το έργο. Το σφάλμα προσδιορίζει τη θέση που πρέπει να διορθώσετε προτού το Power BI Desktop να μπορεί να φορτώσει το ενημερωμένο μοντέλο σημασιολογίας:

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