Jaa

Eventhouse- ja KQL-tietokannan käyttöönottoputket ja Git-integrointi (esikatselu)

  • Artikkeli

Tapahtumatalot ja KQL-tietokannat integroituvat Microsoft Fabricin elinkaaren hallintaominaisuuksiin , mikä tarjoaa standardoidun yhteistyön kaikkien kehitystiimin 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, millaisia määritysvaihtoehtoja On saatavilla Microsoft Fabricin elinkaaren hallinnan kautta tapahtumataloille ja KQL-tietokannuksille.

Eventhouse- ja KQL-tietokannan Git-integrointi

Eventhouse- ja KQL-tietokannat ovat kohteita, jotka sisältävät sekä metatietoja että tietoja, joihin viitataan useissa työtilan objekteissa. Eventhouse- ja KQL-tietokannat sisältävät taulukoita, funktioita ja muodostettuja näkymiä. Kehitystyönkulun näkökulmasta seuraavat riippuvaiset objektit saattavat viitata tapahtumatalo- tai KQL-tietokantaan:

Git-integrointia sovelletaan tapahtumatalojen ja KQL-tietokantojen käyttöympäristö- ja tietotasolla.

Ympäristötason integrointi

Seuraavat tapahtumatalon ja KQL:n tietokantatiedot sarjoitetaan ja seurataan Git-yhdistettyyn työtilaan:

  • Eventhouse

    • Name
    • Kuvaus
    • Looginen guid-tunnus

  • KQL-tietokanta

    • Name
    • Kuvaus
    • Välimuistiin tallentamisen käytäntö
    • Säilytyskäytäntö
    • Looginen guid-tunnus

Tietotason integrointi

Tietotason integrointi suoritetaan käyttämällä KQL-komentosarjaa tietokantaobjektien rakenteet, ominaisuudet ja käytännöt luomiseen tai muokkaamiseen. 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:

    • Table
    • Function
    • 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ä 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
    Table Luo tai yhdistä
    Function 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

    Seuraavassa on esimerkki kql-komentosarjasta, jolla luodaan taulukko ja sen tietojen yhdistämisen yhdistäminen.

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

Liittyvä sisältö