remote

페데레이션에 등록된 원격 노드에서 쿼리를 실행합니다. 노드 접속에 실패하면 쿼리가 실패합니다. 이 명령어는 클러스터 관리자 권한이 필요합니다.

명령어 속성

항목설명
명령어 유형드라이버 쿼리
필요 권한클러스터 관리자 권한
라이선스 사용량해당 없음
병렬 실행미지원
분산 실행미지원

문법

remote NODE_NAME [ SUBQUERY ]

대상

NODE_NAME
쿼리를 실행할 원격 노드의 이름.
[ SUBQUERY ]
원격 노드에서 실행할 쿼리문. 대괄호([, ])로 감싸서 지정합니다.

출력 필드

없음 (데이터 소스에 따라 동적으로 결정)

오류 코드

파싱 오류
오류 코드메시지설명
30800클러스터 관리자 권한이 필요합니다.클러스터 관리자 권한이 없는 경우
-node-not-found지정된 원격 노드가 존재하지 않는 경우
-invalid-syntax명령어 형식이 올바르지 않은 경우
런타임 오류

해당 사항 없음

설명

remote 명령어는 클러스터에 등록된 원격 노드에서 쿼리를 실행하고, 결과를 로컬로 가져옵니다. 노드 접속에 실패하면 쿼리가 실패합니다.

사용 예

  1. 원격 노드에서 테이블 조회

    remote data-node-1 [ table duration=1h WEB_APACHE_SAMPLE ]
    

    data-node-1 노드에서 최근 1시간의 WEB_APACHE_SAMPLE 테이블을 조회합니다.

  2. 원격 노드에서 집계 쿼리 실행

    remote data-node-1 [ table duration=1d WEB_APACHE_SAMPLE | stats count by status ]
    

    data-node-1 노드에서 최근 1일의 웹 접근 로그를 HTTP 상태 코드별로 집계하여 가져옵니다.

호환성

remote 명령어는 소나 4.0 이전 버전부터 제공되었습니다.