Freigeben über

Eventhouse- und KQL-Datenbank – Git-Integration

Im folgenden Artikel wird die Dateistruktur für Eventhouse- und KQL-Datenbank erläutert, sobald sie mit einem GitHub- oder Azure Devops-Repository synchronisiert wurden.

Ordnerstruktur

Sobald ein Arbeitsbereich mit einem Repository synchronisiert wurde, wird ein Ordner der obersten Ebene für den Arbeitsbereich und ein Unterordner für jedes Element angezeigt, das synchronisiert wurde. Jeder Unterordner ist mit dem Elementnamen formatiert. Elementtyp

Im Ordner für Eventhouse- und KQL-Datenbank werden die folgenden Dateien angezeigt:

  • Plattform: Definiert Fabric-Plattformwerte wie Anzeigename und Beschreibung.
  • Eigenschaften: Definiert elementspezifische Werte.

Darüber hinaus wird für die KQL-Datenbank eine Schemadatei angezeigt, die zum Bereitstellen der Elemente in einer KQL-Datenbank verwendet wird.

Hier ist ein Beispiel dafür, wie die Ordnerstruktur aussieht:

Repo-

  • Arbeitsbereich A
    • Item_A.Eventhouse
      • .Plattform
      • EventhouseProperties.json
    • Item_B.KQLDatabase
      • .Plattform
      • DatabaseProperties.json
      • DatabaseSchema.kql
  • Arbeitsbereich B
    • Item_C.Eventhouse
      • .Plattform
      • EventhouseProperties.json
    • Item_D.KQLDatenbank
      • .Plattform
      • DatabaseProperties.json
      • DatabaseSchema.kql

Eventhouse-Dateien

Die folgenden Dateien sind in einem Eventhouse-Ordner enthalten:

  • .Plattform

    Die Datei verwendet das folgende Schema, um ein Eventhouse zu definieren:

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

    Mit der Datei können Sie Einstellungen auf Plattformebene für das Eventhouse-Element konfigurieren.

KQL-Datenbankdateien

Die folgenden Dateien sind in einem KQL-Datenbankordner enthalten:

  • .Plattform

    Die Datei verwendet das folgende Schema, um eine KQL-Datenbank zu definieren:

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

    Die Datei verwendet das folgende Schema, um Einstellungen auf Plattformebene für das KQL-Datenbankelement (Kusto Query Language) zu konfigurieren:

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

    In der folgenden Tabelle werden die Eigenschaften in der DatabaseProperties.json Datei beschrieben:

    Eigentum BESCHREIBUNG
    Datenbanktyp Gültige Werte: LeseSchreib
    parentEventhouseItemId Die logische ID des übergeordneten Ereignishauses. Dieser Wert sollte nicht geändert werden.
    oneLakeCachingPeriod Einstellung auf Datenbankebene für die Cache-Richtlinie.
    oneLakeStandardStoragePeriod Einstellung auf Datenbankebene für die Aufbewahrungsrichtlinie.

  • DatabaseSchema.kql

    Die Datei ist ein KQL-Skript , das die Einstellungen auf Datenebene für die KQL-Datenbank konfiguriert. Es wird automatisch generiert, wenn die KQL-Datenbank mit Git synchronisiert wird. Die Datei wird ausgeführt, wenn sie mit Ihrem Fabric-Arbeitsbereich synchronisiert wird.

    Sie können Änderungen an diesem Skript vornehmen, indem Sie die folgenden unterstützten Befehle hinzufügen oder ändern:

    Database-Objekt Unterstützte Befehle
    Tabelle Erstellen oder Zusammenführen
    Funktion Erstellen oder Ändern
    Aktualisierung der Tabellenrichtlinien Ändern
    Spaltencodierungsrichtlinie Ändern
    Materialisierte Ansicht Erstellen oder Ändern
    Tabellenzuordnung für die Datenaufnahme Erstellen oder Ändern

    Das folgende Beispiel ist ein KQL-Skript zur Erzeugung einer Tabelle und deren Ingestionszuordnung.

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

Verwandte Inhalte

  • Last updated on