Κοινή χρήση μέσω


Διοχετεύσεις ανάπτυξης βάσης δεδομένων Eventhouse και KQL και ενοποίηση git (Προεπισκόπηση)

Οι βάσεις δεδομένων Eventhouse και KQL ενοποιούνται με τις δυνατότητες διαχείρισης του κύκλου ζωής στο Microsoft Fabric, παρέχοντας μια τυποποιημένη συνεργασία μεταξύ όλων των μελών της ομάδας ανάπτυξης σε όλη τη διάρκεια ζωής του προϊόντος. Αυτή η λειτουργικότητα παρέχεται μέσω διοχετεύσεων ενοποίησης και ανάπτυξης του Git.

Σε αυτό το άρθρο, θα μάθετε σχετικά με τις επιλογές ρύθμισης παραμέτρων που είναι διαθέσιμες μέσω της διαχείρισης κύκλου ζωής του Microsoft Fabric για κέντρα συμβάντων και βάσεις δεδομένων KQL.

Ενοποίηση Eventhouse και βάσης δεδομένων KQL Git

Η αποθήκη συμβάντων και η βάση δεδομένων KQL είναι στοιχεία που περιέχουν μετα-δεδομένα και δεδομένα που αναφέρονται σε πολλά αντικείμενα στον χώρο εργασίας. Η βάση δεδομένων Eventhouse και KQL περιέχει πίνακες, συναρτήσεις και υλοποιημένες προβολές. Από την προοπτική της ροής εργασιών ανάπτυξης, τα παρακάτω εξαρτώμενα αντικείμενα μπορεί να αναφέρονται σε μια υπηρεσία συμβάντων ή σε μια βάση δεδομένων KQL:

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

Ενοποίηση σε επίπεδο πλατφόρμας

Η ακόλουθη υπηρεσία συμβάντων και οι πληροφορίες βάσης δεδομένων KQL σειριοποιούνται και παρακολουθούνται σε έναν χώρο εργασίας που είναι συνδεδεμένος με git:

  • Eventhouse

    • Ονομασία
    • Περιγραφή
    • Λογικό guid
  • Βάση δεδομένων KQL

    • Ονομασία
    • Περιγραφή
    • Πολιτική προσωρινής αποθήκευσης
    • Πολιτική διατήρησης
    • Λογικό guid

Ενοποίηση σε επίπεδο δεδομένων

Η ενοποίηση σε επίπεδο δεδομένων επιτυγχάνεται με τη χρήση μιας δέσμης ενεργειών KQL για τη δημιουργία ή την τροποποίηση σχημάτων αντικειμένων βάσης δεδομένων, ιδιοτήτων και πολιτικών. Ωστόσο, είναι σημαντικό να σημειωθεί ότι δεν είναι όλες οι εντολές που υποστηρίζονται σε μια δέσμη ενεργειών KQL συμβατές με το Microsoft Fabric ALM.

  • Βάση δεδομένων KQL

    Τα παρακάτω αντικείμενα βάσης δεδομένων υποστηρίζονται στη δέσμη ενεργειών KQL:

    • Table
    • Function
    • Ενημέρωση πολιτικής πίνακα
    • Πολιτική κωδικοποίησης στηλών
    • Υλοποιημένη προβολή
    • Αντιστοίχιση πρόσληψης πινάκων

    Για πληροφορίες σχετικά με τις υποστηριζόμενες εντολές, ανατρέξτε στην περιγραφή του αρχείου DatabaseSchema.kql στην περιοχή Αρχεία βάσης δεδομένων KQL.

Αναπαράσταση ενοποίησης Git

Κάθε eventhouse και στοιχεία βάσης δεδομένων KQL που συγχρονίζονται με το git εμφανίζονται στον δικό του φάκελο με την ονομασία, χρησιμοποιώντας την ακόλουθη μορφή: <ItemName>.<ItemType> όπου <ItemName> είναι το όνομα του στοιχείου και <ItemType> είναι ο τύπος του στοιχείου. Για παράδειγμα, για μια αποθήκη συμβάντων με το όνομα Παράδειγμα που έχει μια μεμονωμένη βάση δεδομένων KQL με το όνομα ExampleDB, εμφανίζονται οι ακόλουθοι φάκελοι στο αποθετήριο git:

  • Παράδειγμα.Eventhouse
  • ExampleDB.Βάση δεδομένων KQL

Αρχεία eventhouse

Τα παρακάτω αρχεία περιέχονται σε έναν φάκελο της υπηρεσίας συμβάντων:

  • .πλατφόρμα

    Το αρχείο χρησιμοποιεί το ακόλουθο σχήμα για να ορίσει μια υπηρεσία συμβάντων:

    {
      "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
      "metadata": {
        "type": "Eventhouse",
        "displayName": "",
        "description": ""
      },
      "config": {
        "version": "2.0",
        "logicalId": ""
      }
    }
    
  • EventhouseProperties.json

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

Αρχεία βάσης δεδομένων KQL

Τα παρακάτω αρχεία περιέχονται σε έναν φάκελο βάσης δεδομένων KQL:

  • .πλατφόρμα

    Το αρχείο χρησιμοποιεί το παρακάτω σχήμα για να ορίσει μια βάση δεδομένων KQL:

    {
      "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
      "metadata": {
        "type": "KQLDatabase",
        "displayName": "",
        "description": ""
      },
      "config": {
        "version": "2.0",
        "logicalId": ""
      }
    }
    
  • DatabaseProperties.json

    Το αρχείο χρησιμοποιεί το ακόλουθο σχήμα για να ρυθμίσει τις παραμέτρους επιπέδου πλατφόρμας για το στοιχείο βάσης δεδομένων KQL:

    {
      "databaseType": "ReadWrite",
      "parentEventhouseItemId": "",
      "oneLakeCachingPeriod": "P36500D",
      "oneLakeStandardStoragePeriod": "P36500D"
    }
    

    Ο παρακάτω πίνακας περιγράφει τις ιδιότητες στο DatabaseProperties.json αρχείο:

    Ιδιότητα Περιγραφή
    τύπος βάσης δεδομένων Έγκυρες τιμές: ReadWrite
    parentEventhouseItemId Το λογικό αναγνωριστικό της γονικής υπηρεσίας συμβάντων. Αυτό δεν πρέπει να τροποποιείται.
    oneLakeCachingPeriod Ρύθμιση επιπέδου βάσης δεδομένων για την πολιτική προσωρινής αποθήκευσης.
    oneLakeStandardStoragePeriod Ρύθμιση επιπέδου βάσης δεδομένων για την πολιτική διατήρησης.
  • DatabaseSchema.kql

    Το αρχείο είναι μια δέσμη ενεργειών KQL που ρυθμίζει τις ρυθμίσεις επιπέδου δεδομένων για τη βάση δεδομένων KQL. Δημιουργείται αυτόματα όταν η βάση δεδομένων KQL συγχρονίζεται στο git. Το αρχείο εκτελείται κατά το συγχρονισμό στον χώρο εργασίας Fabric σας.

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

    Αντικείμενο βάσης δεδομένων Υποστηριζόμενες εντολές
    Table Δημιουργία ή συγχώνευση
    Function Δημιουργία ή τροποποίηση
    Ενημέρωση πολιτικής πίνακα Μεταβάλλω
    Πολιτική κωδικοποίησης στηλών Μεταβάλλω
    Υλοποιημένη προβολή Δημιουργία ή τροποποίηση
    Αντιστοίχιση πρόσληψης πινάκων Δημιουργία ή τροποποίηση

    Ακολουθεί ένα παράδειγμα μιας δέσμης ενεργειών kql για τη δημιουργία ενός πίνακα και την αντιστοίχιση πρόσληψης.

    // KQL script
    // Use management commands in this script to configure your database items, such as tables, functions, materialized views, and more.
    
    .create-merge table SampleTable (UsageDate:datetime, PublisherType:string, ChargeType:string, ServiceName:string, ServiceTier:string, Meter:string, PartNumber:string, CostUSD:real, Cost:real, Currency:string)
    .create-or-alter table SampleTable ingestion csv mapping 'SampleTable_mapping' "[{'Properties':{'Ordinal':'0'},'column':'UsageDate','datatype':''},{'Properties':{'Ordinal':'1'},'column':'PublisherType','datatype':''}]"