cluster()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Modifica il riferimento della query a una eventhouse remota. Per accedere a un database all'interno della stessa eventhouse, usare la funzione database(). Per altre informazioni, vedere Query tra database e tra cluster.

Sintassi

cluster(name)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
name	string	✔️	URL completo della eventhouse a cui fare riferimento. Il valore può essere specificato come nome di dominio completo o come nome dell'evento. Il nome di Eventhouse viene considerato senza distinzione tra maiuscole e minuscole e la raccomandazione consiste nel specificare lettere minuscole. Il valore non può essere il risultato della valutazione della sottoquery.

Esempi

Usare cluster() per accedere a Eventhouse remoto

La query seguente può essere eseguita in qualsiasi eventhouse.

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

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

Output

Count
59066

Usare cluster() all'interno di istruzioni let

La query precedente può essere riscritta per usare una funzione definita da query (let istruzione ) che accetta un parametro denominato clusterName e lo passa alla cluster() funzione.

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

Output

Count
59066

Usare cluster() all'interno di Funzioni

È possibile riscrivere la stessa query di cui sopra per essere usata in una funzione che riceve un parametro clusterName , che viene passato alla funzione cluster().

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

Nota

Le funzioni archiviate che usano la cluster() funzione non possono essere usate nelle query cross-Eventhouse.