Dela via

Pipelines för distribution av Eventhouse- och KQL-databaser och git-integrering (förhandsversion)

  • Artikel

Eventhouses och KQL-databaser integreras med livscykelhanteringsfunktionerna i Microsoft Fabric, vilket ger ett standardiserat samarbete mellan alla medlemmar i utvecklingsteamet under produktens hela livslängd. Den här funktionen levereras via git-integrerings - och distributionspipelines.

I den här artikeln får du lära dig mer om de konfigurationsalternativ som är tillgängliga via Microsoft Fabrics livscykelhantering för eventhouses och KQL-databaser.

Eventhouse- och KQL-databas-git-integrering

Eventhouse- och KQL-databasen är objekt som innehåller både metadata och data som refereras till i flera objekt på arbetsytan. Eventhouse- och KQL-databasen innehåller tabeller, funktioner och materialiserade vyer. Ur ett utvecklingsarbetsflödesperspektiv kan följande beroende objekt referera till en händelsehus- eller KQL-databas:

Git-integreringen gäller på plattforms- och datanivå för eventhouses och KQL-databaser.

Integrering på plattformsnivå

Följande eventhouse- och KQL-databasinformation serialiseras och spåras på en Git-ansluten arbetsyta:

  • Händelsehus

    • Name
    • beskrivning
    • Logiskt guid

  • KQL-databas

    • Name
    • beskrivning
    • Cachelagringsprincip
    • Kvarhållningsprincip
    • Logiskt guid

Integrering på datanivå

Integrering på datanivå uppnås med hjälp av ett KQL-skript för att skapa eller ändra scheman, egenskaper och principer för databasobjekt. Det är dock viktigt att observera att inte alla kommandon som stöds i ett KQL-skript är kompatibla med Microsoft Fabric ALM.

  • KQL-databas

    Följande databasobjekt stöds i KQL-skriptet:

    • Register
    • Funktion
    • Uppdatering av tabellprincip
    • Kolumnkodningsprincip
    • Materialiserad vy
    • Mappning av tabellinmatning

    Information om kommandon som stöds finns i filbeskrivningen DatabaseSchema.kql under KQL-databasfiler.

Git-integreringsrepresentation

Varje eventhouse- och KQL-databasobjekt som synkroniseras med git visas i en egen mapp med namnet med följande format: <ItemName>.<ItemType> där <ItemName> är namnet på objektet och <ItemType> är typen av objekt. För ett händelsehus med namnet Exempel som till exempel har en enda KQL-databas med namnet ExampleDB visas följande mappar på git-lagringsplatsen:

  • Exempel.Händelsehus
  • ExempelDB.KQLDatabase

Eventhouse-filer

Följande filer finns i en händelsehusmapp:

  • .plattform

    Filen använder följande schema för att definiera ett händelsehus:

    {
  "$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 konfigurera inställningar på plattformsnivå för eventhouse-objektet.

KQL-databasfiler

Följande filer finns i en KQL-databasmapp:

  • .plattform

    Filen använder följande schema för att definiera en KQL-databas:

    {
  "$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 använder följande schema för att konfigurera inställningar på plattformsnivå för KQL-databasobjektet:

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

    I följande tabell beskrivs egenskaperna i DatabaseProperties.json filen:

    Property beskrivning
    databaseType Giltiga värden: ReadWrite
    parentEventhouseItemId Det logiska ID:t för det överordnade händelsehuset. Detta bör inte ändras.
    oneLakeCachingPeriod Inställning på databasnivå för cachelagringsprincipen.
    oneLakeStandardStoragePeriod Inställning på databasnivå för kvarhållningsprincipen.

  • DatabaseSchema.kql

    Filen är ett KQL-skript som konfigurerar inställningarna på datanivå för KQL-databasen. Den genereras automatiskt när KQL-databasen synkroniseras till git. Filen körs när du synkroniserar till din infrastrukturarbetsyta.

    Du kan göra ändringar i det här skriptet genom att lägga till eller ändra följande kommandon som stöds:

    Databasobjekt Kommandon som stöds
    Register Skapa eller sammanfoga
    Funktion Skapa eller ändra
    Uppdatering av tabellprincip Ändra
    Kolumnkodningsprincip Ändra
    Materialiserad vy Skapa eller ändra
    Mappning av tabellinmatning Skapa eller ändra

    Följande är ett exempel på ett kql-skript för att skapa en tabell och dess inmatningsmappning.

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

Relaterat innehåll