remote
페데레이션에 등록된 원격 노드에서 쿼리를 실행합니다. 노드 접속에 실패하면 쿼리가 실패합니다. 이 명령어는 클러스터 관리자 권한이 필요합니다.
명령어 속성
| 항목 | 설명 |
|---|---|
| 명령어 유형 | 드라이버 쿼리 |
| 필요 권한 | 클러스터 관리자 권한 |
| 라이선스 사용량 | 해당 없음 |
| 병렬 실행 | 미지원 |
| 분산 실행 | 미지원 |
문법
remote NODE_NAME [ SUBQUERY ]
대상
NODE_NAME- 쿼리를 실행할 원격 노드의 이름.
[ SUBQUERY ]- 원격 노드에서 실행할 쿼리문. 대괄호(
[,])로 감싸서 지정합니다.
출력 필드
없음 (데이터 소스에 따라 동적으로 결정)
오류 코드
파싱 오류
| 오류 코드 | 메시지 | 설명 |
|---|---|---|
| 30800 | 클러스터 관리자 권한이 필요합니다. | 클러스터 관리자 권한이 없는 경우 |
| - | node-not-found | 지정된 원격 노드가 존재하지 않는 경우 |
| - | invalid-syntax | 명령어 형식이 올바르지 않은 경우 |
런타임 오류
해당 사항 없음
설명
remote 명령어는 클러스터에 등록된 원격 노드에서 쿼리를 실행하고, 결과를 로컬로 가져옵니다. 노드 접속에 실패하면 쿼리가 실패합니다.
사용 예
-
원격 노드에서 테이블 조회
remote data-node-1 [ table duration=1h WEB_APACHE_SAMPLE ]data-node-1노드에서 최근 1시간의WEB_APACHE_SAMPLE테이블을 조회합니다. -
원격 노드에서 집계 쿼리 실행
remote data-node-1 [ table duration=1d WEB_APACHE_SAMPLE | stats count by status ]data-node-1노드에서 최근 1일의 웹 접근 로그를 HTTP 상태 코드별로 집계하여 가져옵니다.
호환성
remote 명령어는 소나 4.0 이전 버전부터 제공되었습니다.