Del via

Eventhouse- og KQL-databasedistribusjonssamlebånd og git-integrasjon (forhåndsvisning)

  • Artikkel

Eventhouses- og KQL-databaser integreres med livssyklusadministrasjonsfunksjonene i Microsoft Fabric, noe som gir et standardisert samarbeid mellom alle medlemmer av utviklingsteamet gjennom hele produktets levetid. Denne funksjonaliteten leveres via git-integrasjon og utrullingssamlebånd.

I denne artikkelen finner du ut mer om konfigurasjonsalternativene som er tilgjengelige gjennom Microsoft Fabrics livssyklusadministrasjon for hendelseshus og KQL-databaser.

Eventhouse og KQL database git integrasjon

Hendelseshuset og KQL-databasen er elementer som inneholder både metadata og data som det refereres til i flere objekter i arbeidsområdet. Eventhouse- og KQL-database inneholder tabeller, funksjoner og materialiserte visninger. Fra et utviklingsarbeidsflytperspektiv kan følgende avhengige objekter referere til et hendelseshus eller en KQL-database:

Git-integreringen gjelder på plattform- og datanivå for hendelseshus og KQL-databaser.

Integrering på plattformnivå

Følgende hendelseshus- og KQL-databaseinformasjon serialiseres og spores i et git-tilkoblet arbeidsområde:

  • Eventhouse

    • Name
    • Bekrivelse
    • Logisk GUID

  • KQL-database

    • Name
    • Bekrivelse
    • Hurtigbufringspolicy
    • Oppbevaringspolicy
    • Logisk GUID

Integrering på datanivå

Integrering på datanivå oppnås ved bruk av et KQL-skript for å opprette eller endre databaseobjektskjemaer, egenskaper og policyer. Det er imidlertid viktig å være oppmerksom på at ikke alle kommandoer som støttes i et KQL-skript, er kompatible med Microsoft Fabric ALM.

  • KQL-database

    Følgende databaseobjekter støttes i KQL-skriptet:

    • Table
    • Function
    • Oppdatering av tabellpolicy
    • Policy for kolonnekoding
    • Materialisert visning
    • Tabellinntakstilordning

    Hvis du vil ha informasjon om støttede kommandoer, kan du se databaseschema.kql-filbeskrivelsen under KQL-databasefiler.

Git-integreringspresentasjon

Hvert hendelseshus og KQL-databaseelementer synkronisert med git, vises i sin egen mappe med navnet ved hjelp av følgende format: <ItemName>.<ItemType> hvor <ItemName> er navnet på elementet og <ItemType> er elementtypen. For et hendelseshus med navnet Eksempel som har én enkelt KQL-database kalt EksempelDB, vises følgende mapper i git-repositoriet:

  • Eksempel.Eventhouse
  • ExampleDB.KQLDatabase

Eventhouse-filer

Følgende filer finnes i en hendelseshusmappe:

  • .plattform

    Filen bruker følgende skjema til å definere et hendelseshus:

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

    Med filen kan du konfigurere innstillinger på plattformnivå for eventhouse-elementet.

KQL-databasefiler

Følgende filer finnes i en KQL-databasemappe:

  • .plattform

    Filen bruker følgende skjema til å definere en KQL-database:

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

    Filen bruker følgende skjema til å konfigurere innstillinger på plattformnivå for KQL-databaseelementet:

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

    Tabellen nedenfor beskriver egenskapene i DatabaseProperties.json filen:

    Egenskap Bekrivelse
    databaseType Gyldige verdier: Skrivebeskyttet
    parentEventhouseItemId Den logiske ID-en for det overordnede hendelseshuset. Dette bør ikke endres.
    oneLakeCachingPeriod Innstilling for databasenivå for hurtigbufringspolicyen.
    oneLakeStandardStoragePeriod Innstilling for databasenivå for oppbevaringspolicyen.

  • DatabaseSchema.kql

    Filen er et KQL-skript som konfigurerer innstillingene for datanivå for KQL-databasen. Den genereres automatisk når KQL-databasen synkroniseres til git. Filen kjøres når du synkroniserer til Fabric Workspace.

    Du kan gjøre endringer i dette skriptet ved å legge til eller endre følgende støttede kommandoer:

    Databaseobjekt Støttede kommandoer
    Table Opprette eller slå sammen
    Function Opprette eller endre
    Oppdatering av tabellpolicy Forandre
    Policy for kolonnekoding Forandre
    Materialisert visning Opprette eller endre
    Tabellinntakstilordning Opprette eller endre

    Følgende er et eksempel på et kql-skript for å opprette en tabell og inntakstilordningen.

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

Relatert innhold