Μορφή πηγαίου κώδικα ενοποίησης Git

Τα στοιχεία στο Microsoft Fabric αποθηκεύονται σε έναν φάκελο. Ο φάκελος που περιέχει το στοιχείο μπορεί να βρίσκεται είτε στον ριζικό κατάλογο είτε σε έναν υποκατάλογο. Όταν συνδέετε τον χώρο εργασίας σας στο Git, συνδεθείτε στον φάκελο που περιέχει τα στοιχεία. Κάθε στοιχείο στον φάκελο αναπαρίσταται στον δικό του υποκατάλογο.

Όνομα καταλόγου

Όταν αποθηκεύετε ένα νέο στοιχείο στο Git, η ενοποίηση Git δημιουργεί αυτόματα έναν κατάλογο για αυτό το στοιχείο.

Το όνομα του καταλόγου στοιχείων βασίζεται στους ακόλουθους κανόνες:

• Το μοτίβο για το όνομα είναι {display name}.{public facing type}.
• Εάν είναι απαραίτητο, πραγματοποιούνται οι ακόλουθες αλλαγές στο εμφανιζόμενο όνομα:
  • Οι μη έγκυροι χαρακτήρες αντικαθίστανται με τον αριθμό HTML.
  • Ο αρχικός χώρος αντικαθίσταται με τον αριθμό HTML του.
  • Το τελικό διάστημα ή κουκκίδα αντικαθίσταται με τον αριθμό HTML του.
• Εάν αυτό το όνομα φακέλου δεν είναι διαθέσιμο, χρησιμοποιείται το όνομα του λογικούID (GUID) του στοιχείου αντί για το εμφανιζόμενο όνομα.

Για παράδειγμα, εάν έχετε τα ακόλουθα στοιχεία σε έναν χώρο εργασίας (σημειώστε ότι το πρώτο και το τρίτο στοιχείο έχουν έναν αόρατο αρχικό και τελικό χώρο αντίστοιχα):

Οι ακόλουθοι κατάλογοι δημιουργούνται στο αποθετήριο δεδομένων Git:

• Όταν δημιουργηθεί, η ενοποίηση Git δεν αλλάζει ποτέ το όνομα ενός καταλόγου. Ακόμα και αν αλλάξετε το όνομα του στοιχείου, το όνομα του καταλόγου παραμένει το ίδιο.
• Εάν αλλάξετε με μη αυτόματο τρόπο το όνομα ενός καταλόγου στοιχείων, βεβαιωθείτε ότι έχετε λάβει υπόψη τις εξαρτήσεις του στοιχείου. Για παράδειγμα, εάν αλλάξετε τον κατάλογο ενός μοντέλου σημασιολογίας, θα πρέπει να βεβαιωθείτε ότι έχετε ενημερώσει τη διαδρομή του μοντέλου σημασιολογίας στο αρχείο εξάρτησης της αναφοράς. Λάβετε υπόψη ότι οι θέσεις εξάρτησης διαφέρουν μεταξύ των διαφορετικών εμπειριών Fabric. Η αλλαγή του ονόματος καταλόγου δεν προκαλεί εισερχόμενη αλλαγή στον χώρο εργασίας.

Περιεχόμενο καταλόγου

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

Αρχεία ορισμού στοιχείου

Ο κατάλογος κάθε στοιχείου έχει συγκεκριμένα, απαιτούμενα αρχεία που ορίζουν αυτό το στοιχείο.

Προς το παρόν, υποστηρίζονται τα ακόλουθα στοιχεία στο Microsoft Fabric:

• βάσεων δεδομένων Mirrored
• Σημειωματάριο
• Σελιδοποιημένη αναφορά
• Έκθεση
• Μοντέλο σημασιολογίας

Κατοπτρικές βάσεις δεδομένων

Οι φάκελοι βάσης δεδομένων με κατοπτρισμούς περιέχουν ένα αρχείο .json που ορίζει τη βάση δεδομένων κατοπτρισμού.

Για οδηγίες σχετικά με τη χρήση της ενοποίησης του Git με βάσεις δεδομένων κατοπτρισμού, ανατρέξτε στο θέμα CI/CD για βάσεις δεδομένων κατοπτρισμού.

Αρχεία σημειωματάριου

Οι φάκελοι σημειωματάριου περιέχουν ένα αρχείο .py :

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

Αρχεία σελιδοποιημένης αναφοράς

Οι φάκελοι σελιδοποιημένης αναφοράς περιέχουν ένα αρχείο .rdl που ορίζει τη σελιδοποιημένη αναφορά. Το RDL (Report Definition Language) είναι μια αναπαράσταση XML ενός ορισμού σελιδοποιημένης αναφοράς.

Για περισσότερες πληροφορίες σχετικά με την RDL, ανατρέξτε στο θέμα Report Definition Language (RDL). Για οδηγίες σχετικά με τη χρήση της ενοποίησης Git με σελιδοποιημένες αναφορές, ανατρέξτε στο θέμα Ενοποίηση Git με σελιδοποιημένες αναφορές.

Αρχεία αναφοράς

Οι φάκελοι αναφορών περιέχουν τα ακόλουθα αρχεία:

• definition.pbir
• report.json

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

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

Οι φάκελοι σημασιολογικών μοντέλων περιέχουν τα ακόλουθα αρχεία:

• definition.pbidataset
• αρχείο model.bim (μορφή TMSL) Ή φάκελος \definition (μορφή TMDL)

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

Αρχεία συστήματος που δημιουργούνται αυτόματα

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

• Ένας κατάλογος έκδοσης 1 περιέχει item.metadata.json και item.config.json. Με την V1, και τα δύο αρχεία πρέπει να βρίσκονται στον κατάλογο.
• Ένας κατάλογος έκδοσης 2 περιέχει .platform. Αυτό το αρχείο περιλαμβάνει το περιεχόμενο των αρχείων item.metadata.json και item.config.json. Εάν έχετε αυτό το αρχείο, δεν μπορείτε να έχετε τα άλλα δύο αρχεία. Εάν χρησιμοποιείτε την έκδοση 1 και διαπράττετε αλλαγές, τα αρχεία συστήματος ενημερώνονται αυτόματα σε αυτήν την έκδοση.

Σημείωση

Ο κατάλογός σας πρέπει να περιέχει είτε τα item.metadata.json αρχεία καιitem.config.json, είτε το .platform αρχείο. Δεν μπορείτε να έχετε και τα τρία αρχεία.

Έκδοση 2

Αρχείο πλατφόρμας

Στην έκδοση 2, αντί να υπάρχουν δύο αρχεία προέλευσης σε κάθε κατάλογο στοιχείων, το αρχείο .platform συνδυάζει όλες τις πληροφορίες σε ένα αρχείο μαζί με μια ιδιότητα $schema . Εάν έχετε αυτό το αρχείο, δεν μπορείτε να έχετε τα άλλα δύο αρχεία.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

Το .platform αρχείο περιέχει τα ακόλουθα χαρακτηριστικά:

• version: Αριθμός έκδοσης των αρχείων συστήματος. Αυτός ο αριθμός χρησιμοποιείται για την ενεργοποίηση συμβατότητας με προηγούμενες εκδόσεις. Ο αριθμός έκδοσης του στοιχείου μπορεί να είναι διαφορετικός.
• logicalId: Ένα αυτόματα δημιουργημένο αναγνωριστικό μεταξύ χώρων εργασίας που αντιπροσωπεύει ένα στοιχείο και την αναπαράσταση στοιχείου ελέγχου προέλευσης.
• type: (συμβολοσειρά) Ο τύπος στοιχείου (μοντέλο σημασιολογίας, αναφορά κ.λπ.)
• displayName: (συμβολοσειρά) Το όνομα του στοιχείου.
• description: (προαιρετική συμβολοσειρά) Περιγραφή του στοιχείου.

Έκδοση 1

Εάν χρησιμοποιείτε την έκδοση 1, κάθε κατάλογος στοιχείων έχει δύο αρχεία:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Αρχείο μετα-δεδομένων

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

Το αρχείο item.metadata.json περιέχει τα ακόλουθα χαρακτηριστικά:

• type: (συμβολοσειρά) Ο τύπος στοιχείου (μοντέλο σημασιολογίας, αναφορά κ.λπ.)
• displayName: (συμβολοσειρά) Το όνομα του στοιχείου
• description: (προαιρετική συμβολοσειρά) Περιγραφή του στοιχείου

Για να μετονομάσετε ένα στοιχείο, αλλάξτε το displayName στο αρχείο "item.metadata.json". Η αλλαγή του ονόματος του φακέλου δεν αλλάζει το εμφανιζόμενο όνομα του στοιχείου στον χώρο εργασίας.

Αρχείο ρύθμισης παραμέτρων

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Το item.config.json αρχείο περιέχει τα ακόλουθα χαρακτηριστικά:

• version: Αριθμός έκδοσης των αρχείων συστήματος. Αυτός ο αριθμός χρησιμοποιείται για την ενεργοποίηση συμβατότητας με προηγούμενες εκδόσεις. Ο αριθμός έκδοσης του στοιχείου μπορεί να είναι διαφορετικός.
• logicalId: Ένα αυτόματα δημιουργημένο αναγνωριστικό μεταξύ χώρων εργασίας που αντιπροσωπεύει ένα στοιχείο και την αναπαράσταση στοιχείου ελέγχου προέλευσης.

Το logicalId συνδέει ένα στοιχείο σε έναν χώρο εργασίας με το αντίστοιχο στοιχείο σε μια διακλάδωση Git. Τα στοιχεία με τα ίδια logicalIds θεωρούνται ίδια. Το logicalId διατηρεί τη σύνδεση ακόμη και αν αλλάξει το όνομα ή ο κατάλογος. Δεδομένου ότι ένας κλάδος μπορεί να συγχρονιστεί σε πολλούς χώρους εργασίας, είναι πιθανό να υπάρχουν στοιχεία σε διαφορετικούς χώρους εργασίας με το ίδιο logicalId, αλλά ένας μοναδικός χώρος εργασίας δεν μπορεί να έχει δύο στοιχεία με το ίδιο logicalId. Το logicalId δημιουργείται όταν ο χώρος εργασίας συνδέεται σε μια διακλάδωση Git ή συγχρονίζεται ένα νέο στοιχείο. Το logicalId είναι απαραίτητο για να λειτουργήσει σωστά η ενοποίηση του Git. Επομένως, είναι σημαντικό να μην το αλλάξετε με οποιονδήποτε τρόπο.

Σημείωση

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

Σημείωση

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

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

Γρήγορα αποτελέσματα με την ενοποίηση του Git.