Partager via

Base de données Eventhouse et KQL - Intégration Git

L’article suivant détaille la structure de fichiers pour Eventhouse et KQL Database une fois qu’ils sont synchronisés avec un dépôt GitHub ou Azure Devops.

Structure de dossiers

Une fois qu’un espace de travail est synchronisé avec un dépôt, vous voyez un dossier de niveau supérieur pour l’espace de travail et un sous-dossier pour chaque élément synchronisé. Chaque sous-dossier est mis en forme avec le nom de l’élément. Type d’élément

Dans le dossier pour Eventhouse et KQL Database, vous voyez les fichiers suivants :

  • Plateforme : définit des valeurs de plateforme de structure telles que le nom d’affichage et la description.
  • Propriétés : définit des valeurs spécifiques à l’élément.

En outre, pour la base de données KQL, vous voyez un fichier de schéma utilisé pour déployer les éléments à l’intérieur d’une base de données KQL.

Voici un exemple de ce que ressemble la structure de dossiers :

dépôt

  • Espace de travail A
    • Item_A.Eventhouse
      • .plateforme
      • EventhouseProperties.json
    • Item_B.KQLDatabase
      • .plateforme
      • DatabaseProperties.json
      • DatabaseSchema.kql
  • Espace de travail B
    • Item_C.Eventhouse
      • .plateforme
      • EventhouseProperties.json
    • Item_D.KQLDatabase
      • .plateforme
      • DatabaseProperties.json
      • DatabaseSchema.kql

Fichiers Eventhouse

Les fichiers suivants sont contenus dans un dossier eventhouse :

  • .plateforme

    Le fichier utilise le schéma suivant pour définir un 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

    Le fichier vous permet de configurer les paramètres au niveau de la plateforme pour l’élément eventhouse.

Fichiers de base de données KQL

Les fichiers suivants sont contenus dans un dossier de base de données KQL :

  • .plateforme

    Le fichier utilise le schéma suivant pour définir une base de données 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

    Le fichier utilise le schéma suivant pour configurer les paramètres au niveau de la plateforme pour l’élément de base de données KQL (Kusto Query Language) :

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

    Le tableau suivant décrit les propriétés du DatabaseProperties.json fichier :

    Propriété Descriptif
    TypeDeBaseDeDonnées Valeurs valides : ReadWrite
    parentEventhouseItemId Identifiant logique du lieu d'événements parent. Cette valeur ne doit pas être modifiée.
    oneLakeCachingPeriod Paramètre de niveau base de données pour la stratégie de mise en cache.
    oneLakeStandardStoragePeriod Paramètre de niveau base de données pour la stratégie de rétention.

  • DatabaseSchema.kql

    Le fichier est un script KQL qui configure les paramètres au niveau des données pour la base de données KQL. Elle est générée automatiquement lorsque la base de données KQL est synchronisée avec git. Le fichier est exécuté lors de la synchronisation avec votre espace de travail Fabric.

    Vous pouvez apporter des modifications à ce script en ajoutant ou en modifiant les commandes prises en charge suivantes :

    Objet de base de données Commandes prises en charge
    Tableau Créer ou fusionner
    Fonction Créer ou modifier
    Mise à jour de la politique de table Changer
    Stratégie d’encodage de colonne Changer
    Vue matérialisée Créer ou modifier
    Mappage d’ingestion de table Créer ou modifier

    L’exemple suivant est un script KQL pour créer une table et son mappage d’ingestion.

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

Contenu connexe

  • Last updated on