Skip to main content
clickhouse-server가 시작 또는 종료 단계에서 멈추면 일반 포트는 연결을 허용하지 않아 서버가 수행 중인 작업을 확인할 수 없습니다. 내부 검사 포트는 서버가 테이블을 ATTACH하기 전에 시작되며, 테이블 DETACH가 완료된 후에야 중지되는 네이티브 프로토콜 TCP 리스너입니다. 이 기간에는 연산자가 기본 clickhouse-client로 연결하여 SHOW PROCESSLIST, SELECT * FROM system.stack_trace, SYSTEM INSTRUMENT ADD 'QueryMetricLog::startQuery' SLEEP ENTRY 0.5와 같은 쿼리를 실행할 수 있습니다.

구성

내부 검사 포트는 <introspection>true</introspection>로 표시된 조합형 프로토콜 엔드포인트입니다. 기본적으로 내부 검사 포트는 구성되어 있지 않습니다:
일반 조합형 프로토콜 엔드포인트이므로 host, port, description, networks 허용 목록, default_database, tlsproxy1 레이어로의 래핑 등 엔드포인트에서 지원하는 모든 기능을 지원합니다. introspection 플래그는 port를 포함하는 항목인 엔드포인트의 속성이며, impl 참조를 통해 상속되지 않습니다. 따라서 내부 검사 엔드포인트와 일반 엔드포인트에서 레이어를 공유할 수 있습니다. 아래의 의미 체계는 네이티브 프로토콜 handler에서 구현되므로 스택은 반드시 tcp 레이어로 끝나야 합니다. 스택에 http, mysql, postgres, prometheus 또는 interserver 레이어가 포함된 엔드포인트를 표시하면, 정작 필요할 때 응답하지 않는 포트가 생성되는 대신 시작 시 INVALID_CONFIG_PARAMETER 오류와 함께 거부됩니다.

동작

  • 허용되는 쿼리는 SELECT, SHOW, DESCRIBE, EXPLAIN, EXISTS, KILL QUERY, SYSTEM, SET, USE입니다. DDL 및 데이터를 수정하는 쿼리를 비롯한 그 밖의 모든 쿼리는 서버 상태가 아직 완전히 구성되지 않았거나 종료 중인 상태에서도 포트가 열려 있으므로 QUERY_IS_PROHIBITED와 함께 거부됩니다.
  • 시작 과정에서 구성을 다시 로드하면 초기화 순서가 깨질 수 있으므로, 서버가 완전히 시작될 때까지 SYSTEM RELOAD CONFIGSYSTEM RELOAD USERSQUERY_IS_PROHIBITED와 함께 거부됩니다.
  • 이 포트의 쿼리는 SHOW PROCESSLIST와 마찬가지로 max_concurrent_queries 및 워크로드 스케줄러를 우회합니다.
  • 연결은 전용 스레드 풀에서 처리되므로 일반 연결 풀의 고갈은 이 포트에 영향을 주지 않습니다. 풀 크기는 max_connections로 결정됩니다.
  • CPU 과부하로 인해 서버가 일반 연결을 거부하는 경우에도 연결은 허용됩니다.
  • 일반적인 인증 및 권한 부여가 모두 적용됩니다. 이 포트에 연결해도 추가 접근 권한이 부여되지는 않습니다. 다만 앞서 언급한 동시성 제한은 해제되므로 운영자만 접근할 수 있는 주소에 바인딩하십시오.
  • 이 포트는 SYSTEM START LISTEN / SYSTEM STOP LISTEN(ALLCUSTOM 포함)의 영향을 받지 않으며, 구성 다시 로드 시 재구성되지 않습니다.
마지막 수정일 2026년 8월 26일