Créer des fonctions stockées

Important

Microsoft Fabric est actuellement en préversion. Certaines informations portent sur un produit en préversion susceptible d’être substantiellement modifié avant sa publication. Microsoft ne donne aucune garantie, expresse ou implicite, concernant les informations fournies ici.

Les fonctions sont des requêtes ou des parties de requête réutilisables. Real-Time Analytics prend en charge deux types de fonctions :

  • Fonctions intégrées, qui sont des fonctions codées en dur qui ne peuvent pas être modifiées par les utilisateurs.

  • Fonctions définies par l’utilisateur, qui sont divisées en deux types :

    • Fonctions stockées : fonctions définies par l’utilisateur qui sont stockées et des entités de schéma de base de données managées (telles que des tables). Pour plus d’informations sur la création et la gestion des fonctions stockées, consultez Vue d’ensemble de la gestion des fonctions stockées.
    • Fonctions définies par la requête : sont des fonctions définies par l’utilisateur qui sont définies et utilisées dans l’étendue d’une requête unique. La définition de telles fonctions s’effectue par le biais d’une instruction let. Pour plus d’informations sur la création de fonctions définies par la requête, consultez Créer une fonction définie par l’utilisateur.

Dans cet article, vous allez apprendre à créer ou à modifier une fonction stockée existante à l’aide de .create-or-alterfunction.

Pour plus d’informations sur la .create-or-alterfunction commande, consultez .create-or-alter function

Prérequis

Fonctions

Cette fonctionnalité vous permet de créer ou de modifier une fonction existante à l’aide de la .create-or-alterfunction commande , qui la stocke dans les métadonnées de la base de données. Si la fonction avec le functionName fourni n’existe pas dans les métadonnées de la base de données, la commande crée une fonction. Sinon, la fonction nommée est modifiée.

  1. Accédez à votre base de données KQL, puis sélectionnez Nouvelle>fonction. La .create-or-alter commande est automatiquement remplie dans la fenêtre Explorer vos données .

    Capture d’écran d’une page d’accueil de base de données KQL montrant le menu déroulant Nouvelle option. L’option intitulée Fonction est mise en surbrillance.

  2. Entrez le nom de la fonction et les paramètres de requête de votre fonction au lieu du texte de l’espace réservé, puis sélectionnez Exécuter.

    Capture d’écran de la fenêtre Explorer vos données montrant la fonction nouvellement créée dans Real-Time Analytics.

    Les fonctions stockées apparaissent sous Fonctions dans l’arborescence données.

    Capture d’écran de l’arborescence de données montrant la liste des fonctions stockées définies par l’utilisateur.

  3. Dans la fenêtre Explorer vos données, exécutez une requête pour case activée que vous avez correctement créé ou modifié votre fonction.

    Capture d’écran de la fenêtre Explorer vos données montrant les résultats d’une requête d’une fonction stockée dans Real-Time Analytics.

Étapes suivantes

Interroger des données dans un ensemble de requêtes KQL