clúster ()

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer

Cambia la referencia de la consulta a un centro de eventos remoto. Para acceder a una base de datos dentro de la misma instancia de Eventhouse, use la función database(). Para obtener más información, consulte Consultas entre bases de datos y entre clústeres.

Sintaxis

cluster(name)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Type	Obligatorio	Descripción
name	string	✔️	Dirección URL completa de Eventhouse a la que se va a hacer referencia. El valor se puede especificar como un nombre de dominio completo o el nombre de Eventhouse. El nombre de Eventhouse se trata como insensibilidad entre mayúsculas y minúsculas y se recomienda proporcionarlo en minúsculas. El valor no puede ser el resultado de la evaluación de subconsulta.

Ejemplos

Uso de cluster() para acceder a Eventhouse remoto

La consulta siguiente se puede ejecutar en cualquier eventhouse.

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

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

Salida

Count
59066

Uso de cluster() dentro de instrucciones let

La consulta anterior se puede reescribir para usar una función definida por la consulta (let instrucción) que toma un parámetro denominado clusterName y lo pasa a la cluster() función.

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

Salida

Count
59066

Uso de cluster() dentro de Functions

Se puede volver a escribir la misma consulta que antes para usarse en una función que recibe un parámetro clusterName , que se pasa a la función cluster().

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

Nota:

Las funciones almacenadas que usan la cluster() función no se pueden usar en consultas entre centros de eventos.