Créer des fonctions stockées

Les fonctions sont des requêtes ou des parties de requête réutilisables. L’Analytique en temps réel 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 une requête : fonctions définies par l’utilisateur et utilisées dans le cadre d’une seule requête. 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 une 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’information sur la commande .create-or-alterfunction, consultez .create-or-alter function

Prérequis

Functions

Cette fonctionnalité vous permet de créer ou de modifier une fonction existante à l'aide de la commande .create-or-alterfunction, 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 nouvelle fonction. Sinon, la fonction nommée est modifiée.

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

    Screenshot of a KQL database landing page showing the New option dropdown menu. The option titled Function is highlighted.

  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.

    Screenshot of the Explore your data window showing the newly created function in Real-Time Analytics.

    Les fonctions enregistrées apparaissent sous Functions dans le volet Explorer.

    Screenshot of Explorer pane showing the list of stored user-defined functions.

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

    Screenshot of the Explore your data window showing query results of a stored function in Real-Time Analytics.