cluster()

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

Ändert den Verweis der Abfrage in ein Remoteereignishaus. Um auf eine Datenbank innerhalb desselben Eventhouse zuzugreifen, verwenden Sie die Datenbank() -Funktion. Weitere Informationen finden Sie unter datenbankübergreifende und clusterübergreifende Abfragen.

Syntax

cluster(name)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
name	string	✔️	Die vollständige URL des zu referenzierenden Eventhouses. Der Wert kann als vollqualifizierter Domänenname oder als Name des Eventhouse angegeben werden. Der Eventhouse-Name wird als case-insenstive behandelt, und die Empfehlung besteht darin, ihn kleingeschrieben zu machen. Der Wert kann nicht das Ergebnis der Unterabfrageauswertung sein.

Beispiele

Verwenden von Cluster() für den Zugriff auf remote Eventhouse

Die folgende Abfrage kann für jedes Eventhouse ausgeführt werden.

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

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

Output

Anzahl
59066

Verwenden von Cluster() innerhalb von Let-Anweisungen

Die vorherige Abfrage kann umgeschrieben werden, um eine abfragedefinierte Funktion (let Anweisung) zu verwenden, die einen aufgerufenen clusterName Parameter verwendet und an die cluster() Funktion übergibt.

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

Ausgabe

Anzahl
59066

Verwenden von Cluster() innerhalb von Funktionen

Die gleiche Abfrage wie oben kann neu geschrieben werden, um in einer Funktion zu verwenden, die einen Parameter clusterName empfängt - der an die Cluster()-Funktion übergeben wird.

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

Hinweis

Gespeicherte Funktionen, die die cluster() Funktion verwenden, können nicht in Eventhouse-Abfragen verwendet werden.