Φάκελος σημασιολογικού μοντέλου έργου Power BI Desktop
Σημαντικό
Τα έργα του Power BI Desktop βρίσκονται αυτήν τη στιγμή σε προεπισκόπηση.
Αυτό το άρθρο περιγράφει τα αρχεία και τους υποφακέλους σε έναν φάκελο Μοντέλο σημασιολογίας ενός έργου του Microsoft Power BI Desktop. Τα αρχεία και οι υποφάκελοι εδώ αντιπροσωπεύουν ένα σημασιολογικό μοντέλο Power BI. Ανάλογα με το έργο σας, ο φάκελος σημασιολογικού μοντέλου μπορεί να περιλαμβάνει:
1 - Αυτό το αρχείο είναι υποχρεωτικό.
2 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση με χρήση της μορφής TMSL.
3 - Αυτό το αρχείο απαιτείται κατά την αποθήκευση με χρήση της μορφής TMDL.
Δεν περιλαμβάνουν όλοι οι φάκελοι μοντέλου σημασιολογίας έργου όλα τα αρχεία και τους υποφακέλους που περιγράφονται εδώ.
Αρχεία μοντέλου σημασιολογίας
.pbi\localSettings.json
Περιέχει ρυθμίσεις σημασιολογικού μοντέλου που ισχύουν μόνο για τον τρέχοντα χρήστη και υπολογιστή. Θα πρέπει να περιλαμβάνεται στο gitIgnore ή σε άλλες εξαιρέσεις στοιχείων ελέγχου προέλευσης. Από προεπιλογή, το Git αγνοεί αυτό το αρχείο.
Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο localSettings.json σχήματος.
.pbi\editorSettings.json
Περιέχει ρυθμίσεις προγράμματος επεξεργασίας σημασιολογικών μοντέλων που έχουν αποθηκευτεί ως μέρος του ορισμού σημασιολογικού μοντέλου για χρήση σε χρήστες και περιβάλλοντα.
Για περισσότερες πληροφορίες, ανατρέξτε στο έγγραφο editorSettings.json σχήματος.
.pbi\cache.abf
Ένα αρχείο αντιγράφου ασφαλείας υπηρεσιών ανάλυσης (ABF) που περιέχει ένα τοπικό αντίγραφο του μοντέλου και των δεδομένων στο cache κατά την τελευταία επεξεργασία του. Θα πρέπει να περιλαμβάνεται στο gitIgnore ή σε άλλες εξαιρέσεις στοιχείων ελέγχου προέλευσης. Από προεπιλογή, το Git αγνοεί αυτό το αρχείο.
Το Power BI Desktop μπορεί να ανοίξει ένα έργο χωρίς αρχείο cache.abf. Σε αυτή την περίπτωση, ανοίγει η αναφορά που είναι συνδεδεμένη σε ένα μοντέλο με ολόκληρο τον ορισμό του, αλλά χωρίς δεδομένα. Εάν υπάρχει cache.abf, το Power BI Desktop φορτώνει τα δεδομένα και αντικαθιστά τον ορισμό μοντέλου με το περιεχόμενο στο model.bim.
.pbi\unappliedChanges.json
Το Power BI Desktop σάς επιτρέπει να αποθηκεύσετε τις αλλαγές που πραγματοποιήθηκαν στο πρόγραμμα επεξεργασίας Μετασχηματισμός δεδομένων (Power Query) χωρίς να εφαρμόσετε πρώτα αυτές τις αλλαγές στο μοντέλο δεδομένων.
Όταν επιλέξετε Εφαρμογή αργότερα, οι μη εφαρμοσμένες αλλαγές αποθηκεύονται στο αρχείο unappliedChanges.json. Όταν οι αλλαγές σε εκκρεμότητα βρίσκονται στο αρχείο unappliedChanges, το Power BI Desktop σάς ζητά να εφαρμόσετε ή να απορρίψετε αυτές τις αλλαγές σε εκκρεμότητα:
Εάν επιλέξετε Εφαρμογή αλλαγών, το Power BI Desktop αντικαθιστά τα ερωτήματα στο model.bim με τα ερωτήματα του unappliedChanges.json. Εάν έχετε επεξεργαστεί ερωτήματα στο model.bim εκτός του 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 δημιουργείται αυτόματα από αρχεία συστήματος.
Μορφή TMDL
Με στόχο την παροχή μιας καλύτερης εμπειρίας ελέγχου προέλευσης και συν-ανάπτυξης, μπορείτε να αποθηκεύσετε τα αρχεία power BI Project (PBIP) χρησιμοποιώντας τη γλώσσα ορισμού μοντέλου σε μορφή πίνακα (TMDL) ως μορφή αρχείου σημασιολογικού μοντέλου.
Σε αντίθεση με τη γλώσσα δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL), το TMDL έχει σχεδιαστεί από την αρχή ώστε να είναι φιλικό προς τον άνθρωπο, διευκολύνοντας όχι μόνο την αναγνωσιμότητα αλλά και την εύκολη επεξεργασία σε οποιοδήποτε πρόγραμμα επεξεργασίας κειμένου. Αυτό αντιπροσωπεύει μια σημαντική βελτίωση για τον έλεγχο προέλευσης και τις εμπειρίες συνεργατικής ανάπτυξης.
Αντί για ένα μεγάλο αρχείο JSON, όπως η Γλώσσα δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL), η TMDL έχει μια δομή φακέλου με ξεχωριστά αρχεία για κάθε πίνακα, προοπτική, ρόλο και κουλτούρα. Αυτό διευκολύνει την εργασία με άλλους χρήστες και την κατανόηση της δομής σημασιολογικών μοντέλων, απλώς εξετάζοντας τον φάκελο και τα αρχεία. Τελικά, αυτό οδηγεί σε μια εξαιρετική εμπειρία ελέγχου προέλευσης και συν-ανάπτυξης κατά τον χειρισμό διενέξεων git diff και συγχώνευσης.
Μάθετε περισσότερα σχετικά με την TMDL εδώ.
Ενεργοποίηση δυνατότητας προεπισκόπησης μορφής TMDL
Η αποθήκευση ως έργο Power BI με χρήση της TMDL είναι προς το παρόν σε προεπισκόπηση. Πριν τη χρησιμοποιήσετε, πρέπει πρώτα να την ενεργοποιήσετε στις δυνατότητες προεπισκόπησης:
Μεταβείτε στην επιλογή Επιλογές αρχείου > και ρυθμίσεις > Επιλογές Δυνατότητες > προεπισκόπησης και επιλέξτε το πλαίσιο δίπλα στο σημασιολογικό μοντέλο Κατάστημα χρησιμοποιώντας τη μορφή TMDL.
Αποθήκευση ως έργου με χρήση TMDL
Με ενεργοποιημένη τη δυνατότητα προεπισκόπησης TMDL, όταν αποθηκεύετε ένα έργο, το σημασιολογικό μοντέλο σας αποθηκεύεται ως φάκελος TMDL με το όνομα \definition μέσα σε έναν φάκελο σημασιολογικού μοντέλου:
Μάθετε περισσότερα σχετικά με τη δομή φακέλων TMDL.
Μετατροπή υπάρχοντος PBIP σε TMDL
Εάν έχετε ήδη ένα PBIP που χρησιμοποιεί το TMSL ως μορφή σημασιολογικού μοντέλου, μπορείτε να το μετατρέψετε σε TMDL ως εξής:
Ανοίξτε το PBIP στο Power BI Desktop.
Βεβαιωθείτε ότι είναι ενεργοποιημένη η δυνατότητα προεπισκόπησης.
Αποθηκεύστε το έργο. Εμφανίζεται ένα μήνυμα που σας ζητά να κάνετε αναβάθμιση σε TMDL.
Επιλέξτε Αναβάθμιση.
Σημαντικό
Μετά την αναβάθμιση σε TMDL, δεν μπορείτε να επιστρέψετε στο TMSL. Εάν πιστεύετε ότι μπορεί να θέλετε να επαναφέρετε το TMSL, αποθηκεύστε πρώτα ένα αντίγραφο των αρχείων σας PBIP.
Το υπάρχον αρχείο Γλώσσα δέσμης ενεργειών μοντέλου σε μορφή πίνακα (TMSL) (model.bim) αντικαθίσταται με έναν φάκελο \definition που περιέχει την αναπαράσταση TMDL του μοντέλου σημασιολογίας.
Εάν επιλέξετε Διατήρηση τρέχουσας μορφής, το Desktop δεν θα ζητήσει ξανά αναβάθμιση.
Πραγματοποίηση εξωτερικών αλλαγών σε αρχεία TMDL
Για μια καλύτερη εμπειρία ανάγνωσης και επεξεργασίας των αρχείων σας TMDL, εγκαταστήστε την επέκταση TMDL - Visual Studio Marketplace Microsoft VS Code.
Ανοίξτε τον φάκελο PBIP χρησιμοποιώντας κώδικα VS και μεταβείτε στον φάκελο ορισμού μοντέλου σημασιολογίας.
Το Power BI Desktop δεν γνωρίζει τις αλλαγές στα αρχεία έργου που έχουν γίνει από άλλα εργαλεία. Επομένως, εάν κάνετε οποιεσδήποτε αλλαγές για να ανοίξετε αρχεία εκτός του Power BI Desktop, πρέπει να κάνετε επανεκκίνηση για να εμφανιστούν αυτές οι αλλαγές στο Power BI Desktop.
Ανατρέξτε εδώ για υποστηριζόμενες λειτουργίες εγγραφής εκτός του Power BI Desktop.
Σφάλματα TMDL
Εάν πραγματοποιηθούν μη έγκυρες αλλαγές στα αρχεία TMDL, το Power BI Desktop εμφανίζει ένα μήνυμα σφάλματος ανοιχτό, με τη θέση του σφάλματος:
Ζητήματα και περιορισμοί TMDL
Κατά τη διάρκεια της δημόσιας προεπισκόπησης, η ενοποίηση Fabric Git θα συνεχίσει να εξάγει το σημασιολογικό μοντέλο χρησιμοποιώντας TMSL από προεπιλογή. Ωστόσο, εάν το σημασιολογικό μοντέλο εισάγεται στο Fabric χρησιμοποιώντας την Ενοποίηση Fabric Git με τη μορφή TMDL, τότε η Ενοποίηση Fabric Git θα χρησιμοποιήσει τη μορφή TMDL για να εξαγάγει τον ορισμό σημασιολογικού μοντέλου στο Git εάν υπάρχουν αλλαγές σημασιολογικού μοντέλου στην υπηρεσία.
Σημαντικό
Εάν εισαγάγετε το σημασιολογικό μοντέλο σας χρησιμοποιώντας οποιαδήποτε άλλη μέθοδο εισαγωγής, όπως Δημοσίευση στο Power BI Desktop, Ενοποίηση Fabric Git θα επιστρέψει στην προεπιλεγμένη μορφή TMSL.