Έργα του Power BI Desktop (ΠΡΟΕΠΙΣΚΟΠΗΣΗ)

Important

Τα έργα Power BI Desktop βρίσκονται αυτήν τη στιγμή σε προεπισκόπηση.

Tip

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

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

Η αποθήκευση της εργασίας σας ως έργου έχει τα εξής πλεονεκτήματα:

• Υποστήριξη προγράμματος επεξεργασίας κειμένου - Τα αρχεία PBIP είναι μορφοποιημένα αρχεία κειμένου που περιέχουν σημασιολογικό μοντέλο και μετα-δεδομένα αναφοράς. Αυτά τα αρχεία είναι δημόσια τεκμηριωμένα και αναγνώσιμα από τον άνθρωπο. Παρόλο που τα αρχεία έργου υποστηρίζουν απλά εργαλεία επεξεργασίας κειμένου όπως το Σημειωματάριο, είναι προτιμότερο να χρησιμοποιήσετε ένα πρόγραμμα επεξεργασίας κώδικα όπως το Visual Studio Code (VS Code), το οποίο παρέχει μια πλούσια εμπειρία επεξεργασίας, όπως intellisense, επικύρωση και ενοποίηση Git.

• Διαφάνεια δομής φακέλων - Ξεχωριστοί φάκελοι για το μοντέλο σημασιολογίας και την αναφορά, ενεργοποιώντας ισχυρές αλλά απλές εργασίες, όπως η αντιγραφή πινάκων σημασιολογικών μοντέλων μεταξύ έργων ή η επαναχρησιοποίηση σελίδων αναφοράς. Μια εξαιρετική επιλογή για τη δημιουργία και επαναχρηση των προτύπων ανάπτυξης.

• Έτοιμο στοιχείο ελέγχου προέλευσης - Ανοίξτε αρχεία κειμένου, σχεδιασμένα για απρόσκοπτη ενοποίηση με το Git, ενεργοποιώντας το ιστορικό εκδόσεων και τη συνεργασία ομάδων. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Στοιχείο ελέγχου έκδοσης στο Git.

• Υποστήριξη συνεχούς ενοποίησης και συνεχούς παράδοσης (CI/CD) - Εφαρμόστε πρακτικές CI/CD πάνω από τα υπάρχοντα συστήματα ελέγχου προέλευσης, χρησιμοποιώντας αρχεία PBIP, ενσωματώνοντας πύλες ποιότητας και αυτοματοποιώντας την ανάπτυξη σε περιβάλλοντα παραγωγής. Για να μάθετε περισσότερα σχετικά με το CI/CD στο Fabric, ανατρέξτε στο θέμα Ροές εργασιών CI/CD Fabric.

• ορισμούς στοιχείων μέσω προγραμματισμού και επεξεργασία - Μπορείτε να δημιουργήσετε και να τροποποιήσετε αρχεία κειμένου ορισμού στοιχείων μέσω προγραμματισμού, ενεργοποιώντας λειτουργίες δέσμης, όπως ενημέρωση όλων των απεικονίσεων σελίδων αναφοράς ή προσθήκη ενός συνόλου μετρήσεων σε κάθε πίνακα. Για σημασιολογικά μοντέλα, μπορείτε να χρησιμοποιήσετε το μοντέλου αντικειμένου σε μορφή πίνακα (TOM) βιβλιοθήκη προγράμματος-πελάτη για να αποεικονοποιήσετε τα μετα-δεδομένα μοντέλου σημασιολογίας, να πραγματοποιήσετε τροποποιήσεις μέσω προγραμματισμού και να τα σειριοποιήσετε ξανά στα αρχεία.

Ενεργοποίηση δυνατοτήτων προεπισκόπησης

Η αποθήκευση ως έργο Power BI στο Power BI Desktop βρίσκεται αυτήν τη στιγμή σε προεπισκόπηση και πρέπει να την ενεργοποιήσετε στις δυνατότητες προεπισκόπησης.

Μεταβείτε στην επιλογή Αρχείο > Επιλογές και ρυθμίσεις > Επιλογές Δυνατότητες > προεπισκόπησης και επιλέξτε το πλαίσιο δίπλα στην επιλογή Αποθήκευση του Power BI Project (.pbip).

Αποθήκευση ως έργου

Εάν εργάζεστε σε ένα νέο έργο ή ανοίξατε ένα υπάρχον αρχείο Power BI Desktop (pbix), μπορείτε να αποθηκεύσετε την εργασία σας ως αρχείο έργου Power BI (pbip):

Όταν αποθηκεύετε ως έργο, το Power BI Desktop αποθηκεύει στοιχεία αναφοράς και σημασιολογικών μοντέλων ως φακέλους, καθένα από τα οποία περιέχει αρχεία κειμένου που ορίζουν το στοιχείο:

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

Ας δούμε καλύτερα τι βλέπετε στον ριζικό φάκελο του έργου σας:

<όνομα> έργου. SemanticModel

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

<όνομα> έργου. Έκθεση

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

.gitIgnore

Καθορίζει τα σκόπιμα μη παρακολουθούμενα αρχεία, το Git θα πρέπει να παραβλέπει τα αρχεία Power BI Project, όπως τα cache.abf και localSettings.json.

Το Power BI Desktop δημιουργεί το αρχείο .gitignore μόνο εάν δεν υπάρχει ήδη στον επιλεγμένο φάκελο αποθήκευσης ή στο γονικό αποθετήριο Git.

Προεπιλεγμένο περιεχόμενο .gitignore κατά την αποθήκευση ως PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf

<όνομα> έργου.pbip

Το αρχείο PBIP περιέχει έναν δείκτη σε έναν φάκελο αναφοράς, ανοίγοντας ένα PBIP ανοίγει η αναφορά προορισμού και το μοντέλο για τη σύνταξη.

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

Άνοιγμα έργου Power BI

Μπορείτε να ανοίξετε το Power BI Desktop από το φάκελο Power BI Project είτε ανοίγοντας το αρχείο pbip είτε το αρχείο pbir στο φάκελο αναφοράς. Και οι δύο επιλογές ανοίγουν την αναφορά για επεξεργασία και το μοντέλο σημασιολογίας, εάν υπάρχει σχετική αναφορά σε ένα μοντέλο σημασιολογίας.

Μπορείτε να αποθηκεύσετε πολλές αναφορές και σημασιολογικά μοντέλα στον ίδιο φάκελο. Δεν απαιτείται ξεχωριστό αρχείο pbip για κάθε αναφορά, επειδή μπορείτε να ανοίξετε κάθε αναφορά απευθείας από το αρχείο .pbir μέσα στο φάκελο αναφοράς.

project/
├── AdventureWorks-Sales.Report/
│   └── definition.pbir
├── AdventureWorks-Stocks.Report/
│   └── definition.pbir
├── AdventureWorks.SemanticModel/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

Μετάβαση σε αρχεία

Μετά την αποθήκευση ως έργο, μπορείτε να δείτε πότε εργάζεστε σε ένα έργο κοιτάζοντας τη γραμμή τίτλου:

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

Αλλαγές εκτός του Power BI Desktop

Όταν αποθηκευτεί ως έργο, δεν είστε αναγκασμένοι να κάνετε αλλαγές στους ορισμούς σημασιολογικού μοντέλου και αναφοράς μόνο στο Power BI Desktop. Μπορείτε να χρησιμοποιήσετε άλλα εργαλεία όπως κώδικα VS, εργαλεία κοινότητας ανοιχτού κώδικα, όπως το Tabular Editor ή ακόμα και το Σημειωματάριο. Ωστόσο, δεν υποστηρίζουν όλα τα αρχεία ή οι αλλαγές την επεξεργασία από εξωτερικά εργαλεία ανοιχτού κώδικα.

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

Εάν είναι δυνατό, το Power BI Desktop υποδεικνύει το αρχείο και τη θέση του σφάλματος:

Οι λεπτομέρειες σχήματος για τα ακόλουθα αρχεία δεν τεκμηριώνονται. Κατά την προεπισκόπηση, οι αλλαγές σε αυτά τα αρχεία εκτός του Power BI Desktop δεν υποστηρίζονται:

• Report\
  • report.json
  • mobileState.json
  • semanticModelDiagramLayout.json
• SemanticModel\
  • diagramLayout.json

Ανάπτυξη στον χώρο εργασίας Fabric

Όταν εργάζεστε με αρχεία έργου Power BI, μπορείτε να αναπτύξετε το περιεχόμενό σας σε έναν χώρο εργασίας Fabric χρησιμοποιώντας τους ακόλουθους μηχανισμούς δημοσίευσης:

• Χρησιμοποιήστεενοποίησης Git Fabric .
• Χρησιμοποιήστε API υφάσματος.
• Χρησιμοποιήστε επιλογή δημοσίευσης του Power BI Desktop.

Note

Η δημοσίευση μέσω Power BI Desktop δημοσιεύει χρησιμοποιεί ένα προσωρινό αρχείο PBIX που έχει δημοσιευτεί στην υπηρεσία, όμοια με την αποθήκευση και δημοσίευση ενός αρχείου PBIX. Σε αντίθεση με άλλες επιλογές ανάπτυξης PBIP που αναπτύσσουν μόνο μετα-δεδομένα, αυτή η μέθοδος δημοσίευσης αναπτύσσει τόσο τα μετα-δεδομένα όσο και το τοπικό cache δεδομένων του μοντέλου σημασιολογίας που επεξεργάζεται.

Σύνταξη μοντέλου

Μπορείτε να κάνετε αλλαγές στον ορισμό μοντέλου σημασιολογίας χρησιμοποιώντας εξωτερικά εργαλεία με δύο τρόπους:

• Με σύνδεση στην παρουσία της Υπηρεσίας ανάλυσης (AS) του Power BI Desktop με εξωτερικά εργαλεία.
• Με την επεξεργασία μετα-δεδομένων TMDL στον /definition φάκελο με χρήση κώδικα VS ή άλλου εξωτερικού εργαλείου.

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

Έχετε υπόψη σας:

• Οποιεσδήποτε αλλαγές σε ανοιχτά αρχεία που πραγματοποιούνται εκτός του Power BI Desktop απαιτούν επανεκκίνηση προκειμένου αυτές οι αλλαγές να εμφανίζονται στο Power BI Desktop. Το Power BI Desktop δεν γνωρίζει τις αλλαγές στα αρχεία έργου που έχουν γίνει από άλλα εργαλεία.

• Οι αυτόματες πίνακες ημερομηνιών που δημιουργούνται από το Power BI Desktop δεν πρέπει να τροποποιούνται με εξωτερικά εργαλεία.

• Εάν το σημασιολογικό μοντέλο έχει ενεργοποιημένη τη δυνατότητα αυτόματης ημερομηνίας/ώρας και δημιουργήσετε μια νέα στήλη ημερομηνίας/ώρας εκτός του Power BI Desktop, ο τοπικός πίνακας ημερομηνιών δεν δημιουργείται αυτόματα.

• Τα σημασιολογικά μοντέλα - όπως τα σύνθετα μοντέλα ή η άμεση λίμνη - μπορούν να περιλαμβάνουν αντικείμενα και ιδιότητες που προέρχονται από άλλα μοντέλα ή πηγές δεδομένων. Κατά την προσαρμογή αυτών των ιδιοτήτων ή την κατάργηση συγχρονισμένων αντικειμένων, το Power BI απαιτεί να οριστεί η changedProperties ιδιότητα και το PBI_RemovedChildren σχόλιο. Αυτές οι ενδείξεις επισημαίνουν τις αλλαγές ως προσαρμογές χρήστη, εξασφαλίζοντας ότι θα διατηρηθούν κατά τον επόμενο συγχρονισμό σχήματος με την προέλευση δεδομένων. Για να μάθετε περισσότερα, ανατρέξτε στο θέμα Ετικέτες διαχρονικής καταγραφής για σημασιολογικά μοντέλα Power BI.

• Τυχόν αλλαγές εκφράσεων εκτός του Power BI Desktop σε ένα έργο με unappliedChanges.json χάνονται όταν εφαρμόζονται αυτές οι αλλαγές.

Σχήματα αρχείου JSON

Τα περισσότερα αρχεία έργου περιέχουν μετα-δεδομένα σε μορφή JSON. Τα αντίστοιχα σχήματα JSON μπορούν να χρησιμοποιηθούν για επικύρωση και τεκμηρίωση.

Με τα σχήματα JSON, μπορείτε να κάνετε τα εξής:

• Μάθετε σχετικά με τις ιδιότητες με δυνατότητα ρύθμισης παραμέτρων.
• Χρησιμοποιήστε την ενσωματωμένη επικύρωση JSON που παρέχεται από το πρόγραμμα επεξεργασίας κώδικα.
• Βελτιώστε τη σύνταξη με επισήμανση σύνταξης, συμβουλές εργαλείων και αυτόματη συμπλήρωση.
• Χρησιμοποιήστε εξωτερικά εργαλεία με γνώση των υποστηριζόμενων ιδιοτήτων εντός των μετα-δεδομένων έργου.

Χρησιμοποιήστε τον κώδικα VS για να αντιστοιχίσετε σχήματα JSON στα αρχεία που έχουν συνταθεί. Τα σχήματα JSON για αρχεία έργου παρέχονται στο αποθετήριο δεδομένων Git json-schemas.

Ζητήματα προς εξέταση και περιορισμοί

• Το Power BI Desktop δεν γνωρίζει τις αλλαγές που πραγματοποιήθηκαν με άλλα εργαλεία ή εφαρμογές. Οι αλλαγές που πραγματοποιήθηκαν με χρήση εξωτερικών εργαλείων απαιτούν επανεκκίνηση του Power BI Desktop προτού εμφανιστούν αυτές οι αλλαγές.
• Οι ετικέτες ευαισθησίας δεν υποστηρίζονται με έργα Power BI.
• Η προβολή διαγράμματος παραβλέπεται κατά την επεξεργασία μοντέλων στην υπηρεσία.
• Κατά την αποθήκευση ενός PBIP, έχετε υπόψη σας ότι το μέγιστο μήκος διαδρομής για αρχεία έργου περιορίζεται σε 260 χαρακτήρες από προεπιλογή στα Windows. Δεδομένου ότι τα αρχεία PBIP αποθηκεύονται ως υποφάκελοι και αρχεία, μεγάλα ονόματα αντικειμένων, όπως ονόματα πινάκων, μπορεί να προκαλέσουν υπέρβαση αυτού του ορίου στο συνολικό μήκος διαδρομής, με αποτέλεσμα σφάλματα κατά τις λειτουργίες αποθήκευσης. Για να μετριάσετε αυτόν τον κίνδυνο, χρησιμοποιήστε μια σύντομη διαδρομή φακέλου ως ριζική θέση για το PBIP σας.
• Στο Power BI Desktop, δεν μπορείτε να κάνετε αποθήκευση ως PBIP απευθείας στο OneDrive και το SharePoint. Μπορείτε να χρησιμοποιήσετε την Αποθήκευση ως για να αποθηκεύσετε αρχεία σε έναν τοπικά συγχρονισμένο φάκελο OneDrive. Ωστόσο, αυτό μπορεί να προκαλέσει προβλήματα συγχρονισμού αρχείων, οδηγώντας ενδεχομένως σε αποτυχημένες λειτουργίες αποθήκευσης στο Power BI Desktop.
• Κατά την επεξεργασία αρχείων PBIP εκτός του Power BI Desktop, θα πρέπει να αποθηκεύονται μέσω UTF-8 χωρίς κωδικοποίηση BOM.
• Το Γλωσσικό σχήμα αναφοράς (συνώνυμα σελίδας αναφοράς) δεν υποστηρίζεται με έργα Power BI.
• Το Power BI Desktop χρησιμοποιεί το CRLF ως τέλος γραμμής. Για να αποφύγετε προβλήματα στις διαφορές σας, ρυθμίστε το Git ώστε να χειρίζεται τις καταλήξεις γραμμών ενεργοποιώντας το autocrlf.
• Το Power BI Projects δεν υποστηρίζεται προς το παρόν στην έκδοση του Microsoft Power BI Desktop που έχει βελτιστοποιηθεί για τον Power BI Report Server.
• Δεν είναι δυνατή η λήψη και ο ορισμός μελών ρόλων ασφαλείας σε επίπεδο γραμμών χρησιμοποιώντας το Fabric REST API
• Δεν είναι δυνατή η λήψη και ο ορισμός κατατμήσεων σταδιακής ανανέωσης χρησιμοποιώντας το Fabric REST API. Ωστόσο, εξάγει ένα μεμονωμένο διαμέρισμα χρησιμοποιώντας το ερώτημα που ορίζεται στην πολιτική ανανέωσης.

Συνήθεις ερωτήσεις

Ερώτηση: Εξετάζοντας τους ορισμούς του σημασιολογικού μοντέλου και του φακέλου στοιχείων αναφοράς, μόνο λίγα αρχεία επισημαίνονται ως απαραίτητα, τι θα συμβεί εάν τα διαγράψω;

Απάντηση: Το Power BI Desktop τα δημιουργεί αυτόματα κατά την αποθήκευση ως έργο (PBIP).

Ερώτηση: Γνωρίζει το Power BI Desktop τις αλλαγές που κάνω στα αρχεία του Power BI Project από ένα εξωτερικό εργαλείο ή εφαρμογή;

Απάντηση: Όχι. Οποιαδήποτε αλλαγή έγινε στα αρχεία απαιτεί επανεκκίνηση του Power BI Desktop, ώστε να αντικατοπτρίζονται αυτές οι αλλαγές.

Ερώτηση: Εάν μετατρέψω ένα PBIX σε PBIP, μπορώ να το μετατρέψω ξανά σε PBIX;

Απάντηση: Ναι. Μπορείτε να αποθηκεύσετε ένα PBIX ως PBIP ή να αποθηκεύσετε ένα PBIP ως PBIX.

Ερώτηση: Μπορώ να μετατρέψω PBIX σε PBIP και αντίστροφα μέσω προγραμματισμού;

Απάντηση: Όχι. Μπορείτε να μετατρέψετε ένα PBIX σε PBIP μόνο και αντίστροφα χρησιμοποιώντας την Αποθήκευση αρχείου> του Power BI Desktopως.

Ερώτηση: Μπορώ να αναπτύξω ένα έργο Power BI Desktop στις Υπηρεσίες ανάλυσης Azure (AAS) ή στις Υπηρεσίες ανάλυσης του SQL Server (ΑΑΠ);

Απάντηση: Όχι. Οι ορισμοί αναφοράς έργου Power BI Desktop δεν υποστηρίζονται στο AAS και το SSAS. Επίσης, οι ορισμοί μοντέλων χρησιμοποιούν βελτιωμένα μετα-δεδομένα που είναι μοναδικά για το Power BI. Για έργα AAS και SSAS, χρησιμοποιήστε το Microsoft Visual Studio για σύνταξη μοντέλων, ενοποίηση Git και Azure DevOps.

Ερώτηση: Γιατί δεν υπάρχει αρχείο *.pbip όταν συνδέω τον χώρο εργασίας Fabric στο Git; Πώς μπορώ να επεξεργαστώ την αναφορά και το μοντέλο σημασιολογίας στο Power BI Desktop;

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

Σχετικό περιεχόμενο

• Φάκελος σημασιολογικού μοντέλου έργου Power BI Desktop
• Φάκελος αναφοράς έργου Power BI Desktop
• Ενοποίηση έργων Git έργων του Power BI Desktop
• Ενοποίηση έργων Azure DevOps με το Power BI Desktop
• Εξωτερικά εργαλεία στο Power BI Desktop