Del via

Udrulningspipelines til eventhouse- og KQL-databaser og git-integration (prøveversion)

  • Artikel

Eventhouses og KQL-databaser integreres med livscyklusstyringsfunktionerne i Microsoft Fabric, hvilket giver et standardiseret samarbejde mellem alle medlemmer af udviklingsteamet gennem hele produktets levetid. Denne funktionalitet leveres via Git-integrations - og udrulningspipelines.

I denne artikel får du mere at vide om de konfigurationsmuligheder, der er tilgængelige via Microsoft Fabric's livscyklusstyring for eventhouses og KQL-databaser.

Git-integration af Eventhouse- og KQL-database

Hændelseshuset og KQL-databasen er elementer, der indeholder både metadata og data, der refereres til i flere objekter i arbejdsområdet. Eventhouse- og KQL-databasen indeholder tabeller, funktioner og materialiserede visninger. Fra et udviklingsarbejdsprocesperspektiv refererer følgende afhængige objekter muligvis til et hændelseshus eller en KQL-database:

Git-integrationen gælder på platform- og dataniveau for eventhouses og KQL-databaser.

Integration på platformsniveau

Følgende hændelseshus- og KQL-databaseoplysninger serialiseres og spores i et git-forbundet arbejdsområde:

  • Eventhouse

    • Navn
    • Beskrivelse
    • Logisk GUID

  • KQL-database

    • Navn
    • Beskrivelse
    • Cachelagringspolitik
    • Opbevaringspolitik
    • Logisk GUID

Integration på dataniveau

Integration på dataniveau opnås ved hjælp af et KQL-script til at oprette eller redigere skemaer, egenskaber og politikker for databaseobjekter. Det er dog vigtigt at bemærke, at ikke alle de kommandoer, der understøttes i et KQL-script, er kompatible med Microsoft Fabric ALM.

  • KQL-database

    Følgende databaseobjekter understøttes i KQL-scriptet:

    • Table
    • Funktion
    • Opdatering af tabelpolitik
    • Politik for kolonnekodning
    • Materialiseret visning
    • Tilknytning af tabelindtagelse

    Du kan få oplysninger om understøttede kommandoer i beskrivelsen af filen DatabaseSchema.kql under KQL-databasefiler.

Git-integrationsrepræsentation

Hver hændelseshouse- og KQL-databaseelementer, der er synkroniseret med git, vises i deres egen mappe med navnet i følgende format: <ItemName>.<ItemType> hvor <ItemName> er navnet på elementet og <ItemType> er elementets type. For et hændelseshus med navnet Eksempel , der har en enkelt KQL-database med navnet ExampleDB, vises følgende mapper f.eks. i Git-lageret:

  • Eksempel.Eventhouse
  • ExampleDB.KQLDatabase

Eventhouse-filer

Følgende filer er indeholdt i en eventhouse-mappe:

  • .perron

    Filen bruger følgende skema til at definere et hændelseshus:

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

    Filen giver dig mulighed for at konfigurere indstillinger på platformniveau for eventhouse-elementet.

KQL-databasefiler

Følgende filer findes i en KQL-databasemappe:

  • .perron

    Filen bruger følgende skema til at 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 bruger følgende skema til at konfigurere indstillinger på platformniveau for KQL-databaseelementet:

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

    I følgende tabel beskrives egenskaberne i DatabaseProperties.json filen:

    Egenskab Beskrivelse
    databaseType Gyldige værdier: ReadWrite
    parentEventhouseItemId Det logiske id for det overordnede hændelseshus. Dette bør ikke ændres.
    oneLakeCachingPeriod Indstilling af databaseniveau for cachelagringspolitikken.
    oneLakeStandardStoragePeriod Indstilling af databaseniveau for opbevaringspolitikken.

  • DatabaseSchema.kql

    Filen er et KQL-script , der konfigurerer indstillingerne på dataniveau for KQL-databasen. Den genereres automatisk, når KQL-databasen synkroniseres til git. Filen udføres, når der synkroniseres til dit Fabric Workspace.

    Du kan ændre dette script ved at tilføje eller ændre følgende understøttede kommandoer:

    Databaseobjekt Understøttede kommandoer
    Table Opret eller flet
    Funktion Opret eller rediger
    Opdatering af tabelpolitik Forandre
    Politik for kolonnekodning Forandre
    Materialiseret visning Opret eller rediger
    Tilknytning af tabelindtagelse Opret eller rediger

    Følgende er et eksempel på et kql-script til oprettelse af en tabel og tilknytning af dens indtagelse.

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

Relateret indhold