Sdílet prostřednictvím

Kanály nasazení databáze Eventhouse a KQL a integrace Gitu (Preview)

  • Článek

Databáze Eventhouses a KQL se integrují s možnostmi správy životního cyklu v Microsoft Fabric a poskytují standardizovanou spolupráci mezi všemi členy vývojového týmu v průběhu celého života produktu. Tato funkce se dodává prostřednictvím integrace Gitu a kanálů nasazení.

V tomto článku se dozvíte o možnostech konfigurace dostupných prostřednictvím správy životního cyklu Microsoft Fabric pro eventhouses a databáze KQL.

Integrace Gitu pro eventhouse a databázi KQL

Eventhouse a databáze KQL jsou položky, které obsahují metadata i data odkazovaná v několika objektech v pracovním prostoru. Databáze Eventhouse a KQL obsahují tabulky, funkce a materializovaná zobrazení. Z hlediska vývojového pracovního postupu můžou následující závislé objekty odkazovat na eventhouse nebo databázi KQL:

Integrace Gitu se vztahuje na úrovni platformy a dat pro eventhouses a databáze KQL.

Integrace na úrovni platformy

Následující informace o databázi eventhouse a KQL se serializují a sledují v pracovním prostoru připojeném k Gitu:

  • Eventhouse

    • Název
    • Popis
    • Logický identifikátor GUID

  • Databáze KQL

    • Název
    • Popis
    • Zásady ukládání do mezipaměti
    • Zásady uchovávání informací
    • Logický identifikátor GUID

Integrace na úrovni dat

Integrace na úrovni dat se dosahuje pomocí skriptu KQL k vytvoření nebo úpravě schémat, vlastností a zásad databázových objektů. Je ale důležité si uvědomit, že ne všechny příkazy podporované ve skriptu KQL jsou kompatibilní s Microsoft Fabric ALM.

  • Databáze KQL

    Skript KQL podporuje následující databázové objekty:

    • Table
    • Function
    • Aktualizace zásad tabulky
    • Zásady kódování sloupců
    • Materializované zobrazení
    • Mapování příjmu dat tabulky

    Informace o podporovaných příkazech naleznete v popisu souboru DatabaseSchema.kql v části Databázové soubory KQL.

Reprezentace integrace Gitu

Každá událost a položky databáze KQL synchronizované s Gitem se zobrazí ve své vlastní složce s názvem s následujícím formátem: <ItemName>.<ItemType> kde <ItemName> je název položky a <ItemType> je typem položky. Například pro eventhouse s názvem Příklad , který má jednu databázi KQL s názvem ExampleDB, se v úložišti Git zobrazí následující složky:

  • Příklad:Eventhouse
  • ExampleDB.KQLDatabase

Soubory eventhouse

Následující soubory jsou obsaženy ve složce eventhouse:

  • .nástupiště

    Soubor k definování centra událostí používá následující schéma:

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

    Soubor umožňuje konfigurovat nastavení na úrovni platformy pro položku eventhouse.

Soubory databáze KQL

Následující soubory jsou obsaženy ve složce databáze KQL:

  • .nástupiště

    Soubor k definování databáze KQL používá následující schéma:

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

    Soubor používá následující schéma ke konfiguraci nastavení na úrovni platformy pro položku databáze KQL:

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

    Následující tabulka popisuje vlastnosti v DatabaseProperties.json souboru:

    Vlastnost Popis
    databaseType Platné hodnoty: ReadWrite
    parentEventhouseItemId Logické ID nadřazené objektu událostí. Neměli byste ho upravovat.
    oneLakeCachingPeriod Nastavení na úrovni databáze pro zásady ukládání do mezipaměti
    oneLakeStandardStoragePeriod Nastavení na úrovni databáze pro zásady uchovávání informací

  • DatabaseSchema.kql

    Soubor je skript KQL, který konfiguruje nastavení na úrovni dat pro databázi KQL. Automaticky se vygeneruje, když se databáze KQL synchronizuje s Gitem. Soubor se spustí při synchronizaci s pracovním prostorem Infrastruktury.

    Změny tohoto skriptu můžete provést přidáním nebo úpravou následujících podporovaných příkazů:

    Databázový objekt Podporované příkazy
    Table Vytvoření nebo sloučení
    Function Vytvoření nebo změna
    Aktualizace zásad tabulky Proměnit
    Zásady kódování sloupců Proměnit
    Materializované zobrazení Vytvoření nebo změna
    Mapování příjmu dat tabulky Vytvoření nebo změna

    Následuje příklad skriptu kql pro vytvoření tabulky a mapování příjmu dat.

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

Související obsah