메인 콘텐츠로 건너뛰기
SQL 콘솔의 대시보드 기능을 사용하면 저장된 쿼리의 시각화를 모아 공유할 수 있습니다. 먼저 쿼리를 저장하고 시각화한 다음, 해당 시각화를 대시보드에 추가하고 쿼리 매개변수를 사용해 대시보드를 상호작용형으로 구성하십시오.

핵심 개념

쿼리 공유

대시보드를 동료와 공유하려면 기반이 되는 저장된 쿼리도 반드시 공유해야 합니다. 시각화를 보려면 최소한 해당 저장된 쿼리에 대한 읽기 전용 액세스 권한이 있어야 합니다.

상호작용

대시보드를 대화형으로 만들려면 쿼리 매개변수를 사용하십시오. 예를 들어 WHERE 절에 쿼리 매개변수를 추가해 필터처럼 작동하도록 할 수 있습니다. 시각화 설정에서 “필터” 유형을 선택하면 Global Filters 사이드 패널에서 쿼리 매개변수 입력을 표시하거나 숨길 수 있습니다. 또한 대시보드의 다른 객체(예: 테이블)에 연결해 쿼리 매개변수 입력을 표시하거나 숨길 수도 있습니다. 자세한 내용은 아래 빠른 시작 가이드의 “필터 구성” 섹션을 참조하십시오.

빠른 시작

query_log 시스템 테이블(system table)을 사용해 ClickHouse 서비스를 모니터링할 대시보드를 만들어 보겠습니다.

빠른 시작

저장된 쿼리 만들기

이미 시각화할 저장된 쿼리가 있다면 이 단계는 건너뛰어도 됩니다. 새 쿼리 탭을 여세요. ClickHouse 시스템 테이블(system tables)을 사용해 서비스의 일별 쿼리 볼륨을 집계하는 쿼리를 작성해 보겠습니다: 쿼리 결과는 테이블 포맷으로 볼 수 있고, 차트 보기에서 바로 시각화 작성을 시작할 수도 있습니다. 다음 단계로 진행하기 위해 이 쿼리를 queries over time으로 저장하겠습니다: 저장된 쿼리에 관한 자세한 내용은 쿼리 저장 섹션에서 확인할 수 있습니다. 쿼리 종류별 쿼리 수를 집계하는 또 다른 쿼리인 query count by query kind도 만들고 저장할 수 있습니다. 다음은 SQL 콘솔에서 확인한 데이터의 막대 차트 시각화입니다. 이제 쿼리가 2개 준비되었으니, 이 쿼리들을 시각화하고 모아둘 대시보드를 만들어 보겠습니다.

대시보드 만들기

대시보드 패널로 이동한 뒤 “New Dashboard”를 클릭하십시오. 이름을 지정하면 첫 번째 대시보드가 생성됩니다!

시각화 추가

저장된 쿼리 queries over timequery count by query kind가 있습니다. 먼저 첫 번째 쿼리를 선 차트로 시각화해 보겠습니다. 시각화의 제목과 부제목을 입력하고, 시각화할 쿼리를 선택합니다. 다음으로 “Line” 차트 유형을 선택한 뒤 x축과 y축을 지정합니다. 여기에서는 숫자 포맷, 범례 레이아웃, 축 레이블 등 추가적인 스타일 변경도 적용할 수 있습니다. 다음으로 두 번째 쿼리를 테이블로 시각화하고, 선 차트 아래에 배치합니다. 이제 저장된 쿼리 두 개를 시각화해 첫 번째 대시보드를 만들었습니다!

필터 구성하기

쿼리 종류에 대한 필터를 추가해 이 대시보드를 대화형으로 만들어 보겠습니다. 그러면 Insert 쿼리와 관련된 추세만 표시할 수 있습니다. 이 작업은 쿼리 매개변수를 사용해 수행합니다. 선 차트 옆의 점 3개를 클릭한 다음, 쿼리 옆의 연필 버튼을 클릭해 인라인 쿼리 편집기를 엽니다. 여기서는 대시보드에서 직접 기반 저장된 쿼리를 편집할 수 있습니다. 이제 노란색 쿼리 실행 버튼을 누르면, 앞서 본 것과 동일한 쿼리에서 Insert 쿼리만 필터링된 결과가 표시됩니다. 저장 버튼을 클릭해 쿼리를 업데이트합니다. 차트 설정으로 돌아가면 선 차트를 필터링할 수 있습니다. 이제 상단 리본의 Global Filters를 사용해 입력값을 변경하여 필터를 전환할 수 있습니다. 선 차트의 필터를 테이블에 연결하려는 경우, 시각화 설정으로 돌아가 query_kind 쿼리 매개변수의 값 소스를 테이블로 변경하고 연결할 필드로 query_kind 컬럼을 선택하면 됩니다. 이제 queries by kind 테이블에서 직접 선 차트의 필터를 제어해 대시보드를 대화형으로 만들 수 있습니다.
마지막 수정일 2026년 6월 10일