Udostępnij za pośrednictwem

Potoki wdrażania bazy danych eventhouse i KQL oraz integracja usługi Git (wersja zapoznawcza)

  • Artykuł

Bazy danych Eventhouses i KQL integrują się z funkcjami zarządzania cyklem życia w usłudze Microsoft Fabric, zapewniając ustandaryzowaną współpracę między wszystkimi członkami zespołu deweloperskiego w całym życiu produktu. Ta funkcja jest dostarczana za pośrednictwem potoków integracji i wdrażania usługi Git.

W tym artykule przedstawiono opcje konfiguracji dostępne za pośrednictwem zarządzania cyklem życia usługi Microsoft Fabric dla baz danych eventhouses i KQL.

Integracja usługi Eventhouse i bazy danych KQL z usługą Git

Magazyn zdarzeń i baza danych KQL to elementy zawierające zarówno metadane, jak i dane, do których odwołuje się wiele obiektów w obszarze roboczym. Baza danych Eventhouse i KQL zawierają tabele, funkcje i zmaterializowane widoki. Z perspektywy przepływu pracy programowania następujące obiekty zależne mogą odwoływać się do bazy danych eventhouse lub KQL:

Integracja z usługą Git ma zastosowanie na poziomie platformy i danych dla baz danych eventhouses i KQL.

Integracja na poziomie platformy

Następujące informacje o bazie danych eventhouse i KQL są serializowane i śledzone w obszarze roboczym połączonym z usługą Git:

  • Eventhouse

    • Nazwa/nazwisko
    • opis
    • Identyfikator GUID logiczny

  • Baza danych KQL

    • Nazwa/nazwisko
    • opis
    • Zasady buforowania
    • Zasady przechowywania
    • Identyfikator GUID logiczny

Integracja na poziomie danych

Integracja na poziomie danych odbywa się za pomocą skryptu KQL do tworzenia lub modyfikowania schematów, właściwości i zasad obiektów bazy danych. Należy jednak pamiętać, że nie wszystkie polecenia obsługiwane w skrypicie KQL są zgodne z programem Microsoft Fabric ALM.

  • Baza danych KQL

    Następujące obiekty bazy danych są obsługiwane w skry skryptzie KQL:

    • Table
    • Function
    • Aktualizacja zasad tabeli
    • Zasady kodowania kolumn
    • Zmaterializowany widok
    • Mapowanie pozyskiwania tabel

    Aby uzyskać informacje o obsługiwanych poleceniach, zobacz opis pliku DatabaseSchema.kql w obszarze pliki bazy danych KQL.

Reprezentacja integracji z usługą Git

Każdy magazyn zdarzeń i elementy bazy danych KQL synchronizowane z usługą Git są wyświetlane we własnym folderze o nazwie o następującym formacie: <ItemName>.<ItemType> gdzie <ItemName> jest nazwą elementu i <ItemType> jest typem elementu. Na przykład w przypadku magazynu zdarzeń o nazwie Przykład z pojedynczą bazą danych KQL o nazwie ExampleDB w repozytorium git są wyświetlane następujące foldery:

  • Przykład.Eventhouse
  • ExampleDB.KQLDatabase

Pliki usługi Eventhouse

Następujące pliki znajdują się w folderze eventhouse:

  • .podest

    Plik używa następującego schematu do zdefiniowania magazynu zdarzeń:

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

    Plik umożliwia skonfigurowanie ustawień na poziomie platformy dla elementu magazynu zdarzeń.

Pliki bazy danych KQL

Następujące pliki znajdują się w folderze bazy danych KQL:

  • .podest

    Plik używa następującego schematu do zdefiniowania bazy danych KQL:

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

    Plik używa następującego schematu do konfigurowania ustawień na poziomie platformy dla elementu bazy danych KQL:

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

    W poniższej DatabaseProperties.json tabeli opisano właściwości w pliku:

    Właściwości opis
    databaseType Prawidłowe wartości: ReadWrite
    parentEventhouseItemId Logiczny identyfikator nadrzędnego magazynu zdarzeń. Nie należy tego modyfikować.
    oneLakeCachingPeriod Ustawienie poziomu bazy danych dla zasad buforowania.
    oneLakeStandardStoragePeriod Ustawienie poziomu bazy danych dla zasad przechowywania.

  • DatabaseSchema.kql

    Plik jest skryptem KQL, który konfiguruje ustawienia na poziomie danych dla bazy danych KQL. Jest on generowany automatycznie, gdy baza danych KQL jest synchronizowana z usługą git. Plik jest wykonywany podczas synchronizacji z obszarem roboczym sieci szkieletowej.

    Możesz wprowadzić zmiany w tym skrycie, dodając lub modyfikując następujące obsługiwane polecenia:

    Obiekt bazy danych Obsługiwane polecenia
    Table Tworzenie lub scalanie
    Function Tworzenie lub zmienianie
    Aktualizacja zasad tabeli Zmienić
    Zasady kodowania kolumn Zmienić
    Zmaterializowany widok Tworzenie lub zmienianie
    Mapowanie pozyskiwania tabel Tworzenie lub zmienianie

    Poniżej przedstawiono przykładowy skrypt kql umożliwiający utworzenie tabeli i jej mapowania pozyskiwania.

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

Powiązana zawartość