Partilhar via


agrupamento()

Aplica-se a: ✅Microsoft FabricAzure Data Explorer

Altera a referência da consulta para um cluster remoto. Para acessar um banco de dados dentro do mesmo cluster, use a função database(). Para obter mais informações, consulte consultas entre bancos de dados e clusters.

Altera a referência da consulta para um Eventhouse remoto. Para acessar um banco de dados dentro da mesma Eventhouse, use a função database(). Para obter mais informações, consulte consultas entre bancos de dados e clusters.

Sintaxe

cluster( Designação)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
Nome string ✔️ O nome do cluster a ser referenciado. O valor pode ser especificado como um nome de domínio totalmente qualificado ou o nome do cluster sem o sufixo .kusto.windows.net . O nome do cluster é tratado como insensível a maiúsculas e minúsculas e a recomendação é fornecê-lo em minúsculas. O valor não pode ser o resultado da avaliação de subconsulta.
Nome Tipo Obrigatório Descrição
Nome string ✔️ O URL completo do Eventhouse para referência. O valor pode ser especificado como um nome de domínio totalmente qualificado ou o nome da Casa de Eventos. O nome Eventhouse é tratado como minúsculo e a recomendação é fornecê-lo em minúsculas. O valor não pode ser o resultado da avaliação de subconsulta.

Exemplos

O exemplo a seguir mostra como usar a cluster() função para acessar um cluster remoto. A consulta pode ser executada em qualquer cluster.

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

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

O exemplo a seguir mostra como usar a cluster() função para acessar um Eventhouse remoto. A consulta pode ser executada em qualquer Eventhouse.

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

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

Realização

Contar
59066

A consulta anterior pode ser reescrita para usar uma função definida por consulta (let instrução) que usa um parâmetro chamado clusterName e o passa para a cluster() função.

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

Realização

Contar
59066

A mesma consulta acima pode ser reescrita para ser usada em uma função que recebe um parâmetro clusterName - que é passado para a função cluster().

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

Observação

As funções armazenadas usando a cluster() função não podem ser usadas em consultas entre clusters.

Observação

As funções armazenadas usando a cluster() função não podem ser usadas em consultas entre Eventhouse.