다음을 통해 공유


cluster()

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer

쿼리 참조를 원격 클러스터로 변경합니다. 동일한 클러스터 내의 데이터베이스에 액세스하려면 database() 함수를 사용합니다. 자세한 내용은 데이터베이스 간 및 클러스터 간 쿼리를 참조 하세요.

쿼리 참조를 원격 Eventhouse로 변경합니다. 동일한 Eventhouse 내의 데이터베이스에 액세스하려면 database() 함수를 사용합니다. 자세한 내용은 데이터베이스 간 및 클러스터 간 쿼리를 참조 하세요.

구문

cluster(이름)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름 Type 필수 설명
이름 string ✔️ 참조할 클러스터의 이름입니다. 값은 정규화된 도메인 이름 또는 접미사가 없는 .kusto.windows.net 클러스터 이름으로 지정할 수 있습니다. 클러스터 이름은 대/소문자를 구분하지 않는 것으로 처리되며 소문자를 제공하는 것이 좋습니다. 값은 하위 쿼리 평가의 결과일 수 없습니다.
속성 Type 필수 설명
이름 string ✔️ 참조할 Eventhouse의 전체 URL입니다. 값은 정규화된 도메인 이름 또는 Eventhouse 이름으로 지정할 수 있습니다. Eventhouse 이름은 대/소문자를 구분하지 않는 것으로 처리되며 소문자를 제공하는 것이 좋습니다. 값은 하위 쿼리 평가의 결과일 수 없습니다.

예제

클러스터()를 사용하여 원격 클러스터에 액세스

다음 쿼리는 모든 클러스터에서 실행할 수 있습니다.

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

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

cluster()를 사용하여 원격 Eventhouse에 액세스

다음 쿼리는 Eventhouse에서 실행할 수 있습니다.

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

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

출력

Count
59066

let 문 내에서 cluster() 사용

이전 쿼리는 호출 clusterName 된 매개 변수를 사용하여 함수에 전달하는 쿼리 정의 함수(let문)를 사용하도록 다시 작성할 cluster() 수 있습니다.

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

출력

Count
59066

Functions 내에서 cluster() 사용

위와 동일한 쿼리를 다시 작성하여 클러스터() 함수에 전달되는 매개 변수 clusterName 를 수신하는 함수에 사용할 수 있습니다.

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

참고 항목

이 함수를 사용하는 저장된 함수는 cluster() 클러스터 간 쿼리에서 사용할 수 없습니다.

참고 항목

함수를 사용하는 저장된 함수는 cluster() 이벤트 하우스 간 쿼리에서 사용할 수 없습니다.