Git-integrointi- ja käyttöönottoputket

2025-05-11

Real-Time Intelligence integroituu Microsoft Fabricin elinkaaren hallintaominaisuuksiin , mikä tarjoaa standardoidun yhteistyön kaikkien kehitystiimien jäsenten välillä koko tuotteen käyttöiän ajan. Tämä toiminto toimitetaan Git-integroinnin ja käyttöönottoputkien kautta.

Tässä artikkelissa kerrotaan kokoonpanovaihtoehdoista, jotka ovat käytettävissä Microsoft Fabricin Real-Time Intelligencen elinkaaren hallinnan kautta.

Git-integrointi

Real-Time Intelligence tukee Git-integrointia tapahtumataloissa, KQL-tietokannoissa, KQL-kyselyjoukoissa ja Real-Time koontinäytöissä. Git-integroinnin avulla voit seurata näiden kohteiden muutoksia Git-yhdistettyyn työtilaan. Integraation avulla voit hallita näiden kohteiden elinkaarta, mukaan lukien versioinnin, haarautumisen ja yhdistämisen.

Kaikki kohteet sisältävät metatietoja, ja tapahtumatalot ja KQL-tietokannat sisältävät myös tietoja, joihin on viitattu useilla työtilan objekteilla.

Seuraavat metatietoelementit sisältyvät Real-Time Intelligence-kohteisiin:

Eventhouse- ja KQL-tietokantakohteet: taulukot, funktiot ja muodostettavat näkymät
KQL-kyselyjoukot: välilehdet ja tietolähteet
Real-Time: tietolähteet, parametrit, peruskyselyt ja ruudut

Kehitystyönkulun näkökulmasta seuraavat riippuvaiset objektit saattavat viitata tapahtumatalo- tai KQL-tietokantaan:

Spark-työmääritykset
Kannettavat
Semanttiset mallit ja Power BI

Git-integrointia sovelletaan alustalla kaikkiin kohteisiin ja tietotasolle tapahtumataloihin ja KQL-tietokantoihin.

Ympäristötason integrointi

Seuraavat tiedot sarjoitetaan ja seurataan Git-yhdistettyyn työtilaan:

Eventhouse
- Nimi
- kuvaus
- Looginen guid-tunnus
KQL-tietokanta
- Nimi
- kuvaus
- Välimuistiin tallentamisen käytäntö
- Säilytyskäytäntö
- Looginen guid-tunnus
KQL-kyselyjoukko
- Nimi
- Versio
- Välilehdet
- Tietolähteet
Reaaliaikainen koontinäyttö
- Tunnus
- eTag
- Schema_version
- Nimi
- Ruudut []
- Pohjakyselyt []
- Parametrit[]
- Tietolähteet[]

Tietotason integrointi

Tietotason integrointi suoritetaan luomalla tai muokkaamalla tietokantaobjektien rakenteet, ominaisuudet ja käytännöt KQL-komentosarjan avulla. On kuitenkin tärkeää huomata, että kaikki KQL-komentosarjassa tuetut komennot eivät ole yhteensopivia Microsoft Fabric ALM:n kanssa.

KQL-tietokanta

KQL-komentosarja tukee seuraavia tietokantaobjekteja:
- Taulukko
- Funktio
- Taulukkokäytännön päivitys
- Sarakkeen koodauskäytäntö
- Muodostettu näkymä
- Taulukon käsittelymääritykset
Lisätietoja tuetuista komennoista on databaseSchema.kql-tiedoston kuvauksessa KQL-tietokantatiedostoissa.

Git-integrointiesitys

Jokainen Gatin kanssa synkronoidut tapahtumatalon ja KQL-tietokannan kohteet näkyvät omassa kansiossaan, jonka nimi on seuraavassa muodossa: <ItemName>. <ItemType> jossa <ItemName> on kohteen nimi ja <ItemType> kohteen tyyppi. Esimerkiksi esimerkkitapahtumatalolle, jolla on yksi KQL-tietokanta, jonka nimi on ExampleDB, seuraavat kansiot näkyvät Git-säilössä:

Esimerkki. Eventhouse
EsimerkkiDB. KQLDatabase

Eventhouse-tiedostot

Seuraavat tiedostot sisältyvät eventhouse-kansioon:

.lava

Tiedosto käyttää seuraavaa rakennetta tapahtumatalon määrittämiseen:

{
  "$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

Tiedoston avulla voit määrittää tapahtumatalokohteen ympäristötason asetukset.

KQL-tietokantatiedostot

Seuraavat tiedostot sisältyvät KQL-tietokantakansioon:

.lava

Tiedosto käyttää seuraavaa rakennetta KQL-tietokannan määrittämiseen:

{
  "$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

Tiedosto käyttää seuraavaa rakennetta ympäristötason asetusten määrittämiseen KQL-tietokantakohteelle:

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

Seuraavassa taulukossa kuvataan tiedoston ominaisuudet DatabaseProperties.json :

Ominaisuus	kuvaus
databaseType	Kelvolliset arvot: ReadWrite
parentEventhouseItemId	Päätapahtumatalon looginen tunnus. Tätä arvoa ei tule muokata.
oneLakeCachingPeriod	Välimuistikäytännön tietokantatason asetus.
oneLakeStandardStoragePeriod	Tietokantatason asetus säilytyskäytännölle.

DatabaseSchema.kql

Tiedosto on KQL-komentosarja , joka määrittää KQL-tietokannan tietotason asetukset. Se luodaan automaattisesti, kun KQL-tietokanta synkronoidaan Gitiin. Tiedosto suoritetaan, kun synkronoit Fabric-työtilan.

Voit tehdä muutoksia tähän komentosarjaan lisäämällä tai muokkaamalla seuraavia tuettuja komentoja:

Tietokantaobjektin	Tuetut komennot
Taulukko	Luo tai yhdistä
Funktio	Luo tai muokkaa
Taulukkokäytännön päivitys	Muuttaa
Sarakkeen koodauskäytäntö	Muuttaa
Muodostettu näkymä	Luo tai muokkaa
Taulukon käsittelymääritykset	Luo tai muokkaa

Seuraava esimerkki on KQL-komentosarja, jolla luodaan taulukko ja sen käsittelymääritys.

// 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':''}]"

KQL-kyselyjoukon tiedostot

Tiedosto käyttää seuraavaa rakennetta KQL-kyselyjoukon määrittämiseen:

{
  "queryset": {
    "version": "1.0.0",
    "tabs": [
      {
        "id": "",
        "title": "",
        "content": "",
        "dataSourceId": "Guid1"
      }
    ],
    "dataSources": [
      {
        "id": "",
        "clusterUri": "",
        "type": "AzureDataExplorer",
        "databaseName": ""
      },
      {
        "id": "Guid1",
        "clusterUri": "",
        "type": "Fabric",
        "databaseItemId": "",
        "databaseItemName": ""
      }
    ]
  }
}

Real-Time koontinäyttötiedostoja

Tiedosto käyttää seuraavaa rakennetta Real-Time koontinäytön määrittämiseen:

{
  "$schema": "",
  "id": "",
  "eTag": "\"\"",
  "schema_version": "",
  "title": "",
  "tiles": [
    {
      "id": "",
      "title": "",
      "visualType": "",
      "pageId": "",
      "layout": {
        "x": ,
        "y": ,
        "width": ,
        "height":
      },
      "queryRef": {
        "kind": "",
        "queryId": ""
      },
      "visualOptions": {
        "multipleYAxes": {
          "base": {
            "id": "",
            "label": "",
            "columns": [],
            "yAxisMaximumValue": ,
            "yAxisMinimumValue": ,
            "yAxisScale": "",
            "horizontalLines": []
          },
          "additional": [],
          "showMultiplePanels":
        },
        "hideLegend": ,
        "legendLocation": "",
        "xColumnTitle": "",
        "xColumn": ,
        "yColumns": ,
        "seriesColumns": ,
        "xAxisScale": "",
        "verticalLine": "",
        "crossFilterDisabled": ,
        "drillthroughDisabled": ,
        "crossFilter": [
          {
            "interaction": "",
            "property": "",
            "parameterId": "",
            "disabled":
          }
        ],
        "drillthrough": [],
        "selectedDataOnLoad": {
          "all": ,
          "limit":
        },
        "dataPointsTooltip": {
          "all": ,
          "limit":
        }
      }
    }
  ],
  "baseQueries": [],
  "parameters": [
    {
      "kind": "",
      "id": "",
      "displayName": "",
      "description": "",
      "variableName": "",
      "selectionType": "",
      "includeAllOption": ,
      "defaultValue": {
        "kind": ""
      },
      "dataSource": {
        "kind": "",
        "columns": {
          "value": ""
        },
        "queryRef": {
          "kind": "",
          "queryId": ""
        }
      },
      "showOnPages": {
        "kind": ""
      },
      "allIsNull":
    },
  ],
  "dataSources": [
    {
      "id": "",
      "name": "",
      "clusterUri": "",
      "database": "",
      "kind": "",
      "scopeId": ""
    }
  ],
  "pages": [
    {
      "name": "",
      "id": ""
    }
  ],
  "queries": [
    {
      "dataSource": {
        "kind": "",
        "dataSourceId": ""
      },
      "text": "",
      "id": "",
      "usedVariables": [
        "",
        ""
      ]
    }
  ]
}