Condividi tramite

Pipeline di distribuzione di database KQL e githouse (anteprima)

  • Articolo

Le case eventi e i database KQL si integrano con le funzionalità di gestione del ciclo di vita in Microsoft Fabric, offrendo una collaborazione standardizzata tra tutti i membri del team di sviluppo durante tutta la vita del prodotto. Questa funzionalità viene distribuita tramite pipeline di integrazione e distribuzione Git.

In questo articolo vengono fornite informazioni sulle opzioni di configurazione disponibili tramite la gestione del ciclo di vita di Microsoft Fabric per le case eventi e i database KQL.

Integrazione git del database KQL e dell'eventhouse

La eventhouse e il database KQL sono elementi che contengono sia metadati che dati a cui si fa riferimento in più oggetti nell'area di lavoro. Il database Eventhouse e KQL contengono tabelle, funzioni e viste materializzate. Dal punto di vista del flusso di lavoro di sviluppo, gli oggetti dipendenti seguenti possono fare riferimento a un database eventhouse o KQL:

L'integrazione git si applica a livello di piattaforma e dati per le case eventi e i database KQL.

Integrazione a livello di piattaforma

Le informazioni del database KQL e della eventhouse seguenti vengono serializzate e rilevate in un'area di lavoro connessa a Git:

  • Eventhouse

    • Nome
    • Descrizione
    • GUID logico

  • Database KQL

    • Nome
    • Descrizione
    • Criteri di memorizzazione nella cache
    • Criteri di conservazione
    • GUID logico

Integrazione a livello di dati

L'integrazione a livello di dati viene ottenuta tramite l'uso di uno script KQL per creare o modificare schemi, proprietà e criteri di oggetti di database. Tuttavia, è importante notare che non tutti i comandi supportati in uno script KQL sono compatibili con Microsoft Fabric ALM.

  • Database KQL

    Gli oggetti di database seguenti sono supportati nello script KQL:

    • Tabella
    • Funzione
    • Aggiornamento dei criteri di tabella
    • Criteri di codifica delle colonne
    • Vista materializzata
    • Mapping di inserimento tabelle

    Per informazioni sui comandi supportati, vedere la descrizione del file DatabaseSchema.kql nei file di database KQL.

Rappresentazione dell'integrazione git

Ogni eventhouse e gli elementi del database KQL sincronizzati con Git vengono visualizzati nella propria cartella denominata usando il formato seguente: <ItemName>.<ItemType> dove <ItemName> è il nome dell'elemento e <ItemType> è il tipo dell'elemento. Ad esempio, per una eventhouse denominata Example con un singolo database KQL denominato ExampleDB, nel repository Git vengono visualizzate le cartelle seguenti:

  • Esempio.Eventhouse
  • ExampleDB.KQLDatabase

File eventhouse

I file seguenti sono contenuti in una cartella eventhouse:

  • .platform

    Il file usa lo schema seguente per definire una eventhouse:

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

    Il file consente di configurare le impostazioni a livello di piattaforma per l'elemento eventhouse.

File di database KQL

I file seguenti sono contenuti in una cartella di database KQL:

  • .platform

    Il file usa lo schema seguente per definire un database 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

    Il file usa lo schema seguente per configurare le impostazioni a livello di piattaforma per l'elemento di database KQL:

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

    Nella tabella seguente vengono descritte le proprietà nel DatabaseProperties.json file :

    Proprietà Descrizione
    databaseType Valori validi: ReadWrite
    parentEventhouseItemId ID logico della eventhouse padre. Questa operazione non deve essere modificata.
    oneLakeCachingPeriod Impostazione a livello di database per i criteri di memorizzazione nella cache.
    oneLakeStandardStoragePeriod Impostazione a livello di database per i criteri di conservazione.

  • DatabaseSchema.kql

    Il file è uno script KQL che configura le impostazioni a livello di dati per il database KQL. Viene generato automaticamente quando il database KQL viene sincronizzato con Git. Il file viene eseguito durante la sincronizzazione con l'area di lavoro infrastruttura.

    È possibile apportare modifiche a questo script aggiungendo o modificando i comandi supportati seguenti:

    Oggetto di database Comandi supportati
    Tabella Creare o unire
    Funzione Creare o modificare
    Aggiornamento dei criteri di tabella Alter
    Criteri di codifica delle colonne Alter
    Vista materializzata Creare o modificare
    Mapping di inserimento tabelle Creare o modificare

    Di seguito è riportato un esempio di script kql per creare una tabella e il relativo mapping di inserimento.

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

Contenuto correlato