Compartir a través de


clúster ()

Se aplica a: ✅Microsoft FabricAzure Data Explorer

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

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( nombre)

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

Parámetros

Nombre Tipo Obligatorio Descripción
nombre string ✔️ Nombre del clúster al que se va a hacer referencia. El valor se puede especificar como un nombre de dominio completo o el nombre del clúster sin el .kusto.windows.net sufijo. El nombre del clúster 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.
Nombre Tipo Obligatorio Descripción
nombre 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

En el ejemplo siguiente se muestra cómo usar la cluster() función para acceder a un clúster remoto. La consulta se puede ejecutar en cualquier clúster.

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

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

En el ejemplo siguiente se muestra cómo usar la cluster() función para acceder a un centro de eventos remoto. La consulta se puede ejecutar en cualquier instancia de Eventhouse.

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

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

Salida

Contar
59066

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

Contar
59066

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 clústeres.

Nota:

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