Delen via

Eventhouse- en KQL-database - Git-integratie

In het volgende artikel wordt de bestandsstructuur voor Eventhouse en KQL Database beschreven zodra deze zijn gesynchroniseerd met een GitHub- of Azure Devops-opslagplaats.

Mapstructuur

Zodra een werkruimte is gesynchroniseerd met een opslagplaats, ziet u een map op het hoogste niveau voor de werkruimte en een submap voor elk item dat is gesynchroniseerd. Elke submap is opgemaakt met itemnaam. Itemtype

In de map voor zowel Eventhouse als KQL Database ziet u de volgende bestanden:

  • Platform: Definieert platformwaarden voor infrastructuur zoals Weergavenaam en Beschrijving.
  • Eigenschappen: Hiermee definieert u itemspecifieke waarden.

Daarnaast ziet u voor de KQL-database een schemabestand dat wordt gebruikt om de items in een KQL-database te implementeren.

Hier volgt een voorbeeld van hoe de mapstructuur eruitziet:

Repository

  • Werkruimte A
    • Item_A.Eventhouse
      • .platform
      • EventhouseProperties.json
    • Item_B.KQLDatabase
      • .platform
      • DatabaseProperties.json
      • DatabaseSchema.kql
  • Werkruimte B
    • Item_C.Eventhouse
      • .platform
      • EventhouseProperties.json
    • Item_D.KQLDatabase
      • .platform
      • DatabaseProperties.json
      • DatabaseSchema.kql

Eventhouse-bestanden

De volgende bestanden bevinden zich in een evenementenhuis-map:

  • .platform

    Het bestand maakt gebruik van het volgende schema om een gebeurtenishouse te definiëren:

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

    Met het bestand kunt u instellingen op platformniveau configureren voor het eventhouse-item.

KQL-databasebestanden

De volgende bestanden bevinden zich in een KQL-database map:

  • .platform

    Het bestand maakt gebruik van het volgende schema om een KQL-database te definiëren:

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

    Het bestand gebruikt het volgende schema om instellingen op platformniveau te configureren voor het KQL-database-item (Kusto Query Language):

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

    In de volgende tabel worden de eigenschappen in het DatabaseProperties.json bestand beschreven:

    Vastgoed Beschrijving
    databaseType Geldige waarden: ReadWrite
    parentEventhouseItemId De logische ID van het ouderlijke evenementenhuis. Deze waarde mag niet worden gewijzigd.
    oneLakeCachingPeriod Instelling op databaseniveau voor het cachebeleid.
    oneLakeStandardStoragePeriod Instelling op databaseniveau voor het bewaarbeleid.

  • DatabaseSchema.kql

    Het bestand is een KQL-script waarmee de instellingen op gegevensniveau voor de KQL-database worden geconfigureerd. Deze wordt automatisch gegenereerd wanneer de KQL-database wordt gesynchroniseerd met Git. Het bestand wordt uitgevoerd tijdens het synchroniseren met uw Fabric Workspace.

    U kunt wijzigingen aanbrengen in dit script door de volgende ondersteunde opdrachten toe te voegen of te wijzigen:

    Databaseobject Ondersteunde opdrachten
    Tabel Aanmaken of samenvoegen
    Functie Maken of wijzigen
    Update van tabelbeleid Veranderen
    Kolomcoderingsbeleid Veranderen
    Gerealiseerde weergave Maken of wijzigen
    Toewijzing van tabelopname Maken of wijzigen

    Het volgende voorbeeld is een KQL-script om een tabel en de invoertoewijzing te maken.

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

Verwante inhoud

  • Last updated on