cluster()

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Modifie la référence de la requête à un eventhouse distant. Pour accéder à une base de données dans le même Eventhouse, utilisez la fonction database(). Pour plus d’informations, consultez les requêtes inter-bases de données et inter-clusters.

Syntaxe

cluster(nom)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
nom	string	✔️	URL complète de l’Eventhouse à référencer. La valeur peut être spécifiée en tant que nom de domaine complet ou nom de l’Eventhouse. Le nom d’Eventhouse est traité comme un cas-insenstif et la recommandation consiste à le fournir en minuscules. La valeur ne peut pas être le résultat de l’évaluation de la sous-requête.

Exemples

Utiliser cluster() pour accéder à Eventhouse distant

La requête suivante peut être exécutée sur n’importe quel Eventhouse.

cluster('help').database('Samples').StormEvents | count

cluster('help.kusto.windows.net').database('Samples').StormEvents | count

Sortie

Count
59066

Utiliser cluster() dans les instructions let

La requête précédente peut être réécrite pour utiliser une fonction définie par la requête (let instruction) qui accepte un paramètre appelé clusterName et le transmet à la cluster() fonction.

let foo = (clusterName:string)
{
    cluster(clusterName).database('Samples').StormEvents | count
};
foo('help')

Sortie

Count
59066

Utiliser cluster() à l’intérieur de Functions

La même requête que ci-dessus peut être réécrite pour être utilisée dans une fonction qui reçoit un paramètre clusterName , qui est passé dans la fonction cluster().

.create function foo(clusterName:string)
{
    cluster(clusterName).database('Samples').StormEvents | count
};

Remarque

Les fonctions stockées utilisant la cluster() fonction ne peuvent pas être utilisées dans les requêtes inter-Eventhouse.