cluster()

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer

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

Sintaxe

cluster( nome)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Digitar	Obrigatória	Descrição
nome	string	✔️	O URL completo do Eventhouse a ser referenciado. O valor pode ser especificado como um nome de domínio totalmente qualificado ou o nome da Casa de Eventos. O nome da Eventhouse é tratado como sem distinção entre maiúsculas e minúsculas e a recomendação é fornecê-lo em letras 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 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

Saída

Contagem
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')

Saída

Contagem
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 que usam a cluster() função não podem ser usadas em consultas entre eventos.