Partager via


cluster()

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

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

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 Catégorie Requise Descriptif
nom string ✔️ Nom du cluster à référencer. La valeur peut être spécifiée en tant que nom de domaine complet ou nom du cluster sans suffixe .kusto.windows.net . Le nom du cluster est traité en tant que 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.
Nom Catégorie Requise Descriptif
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

L’exemple suivant montre comment utiliser la cluster() fonction pour accéder à un cluster distant. La requête peut être exécutée sur n’importe quel cluster.

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

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

L’exemple suivant montre comment utiliser la cluster() fonction pour accéder à un eventhouse distant. La requête 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

Nombre
59066

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

Nombre
59066

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-clusters.

Remarque

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