
- 쿼리를 실행할 ClickHouse 연결을 선택합니다.
- 필요에 따라 Source를 선택합니다. 이렇게 하면
$__filters매크로를 통해 대시보드 수준 필터를 차트에 적용할 수 있습니다. - 편집기에서 SQL 쿼리를 작성하고, 쿼리 매개변수와 매크로를 사용해 대시보드 시간 범위, 필터 및 변수와 연동합니다.
- 실행 버튼을 클릭해 결과를 미리 본 다음 저장합니다.
{paramName:Type}을 사용합니다.
사용 가능한 매개변수는 차트 유형에 따라 달라집니다.
Line 및 Stacked Bar 차트:
Table, Pie 및 Number 차트:
매크로는 자주 사용하는 ClickHouse SQL 표현식으로 확장되는 단축 구문입니다.
$__ 접두사가 붙으며, 쿼리가 ClickHouse로 전송되기 전에 치환됩니다.
이 매크로는 대시보드의 시작 시간 또는 종료 시간을 나타내는 ClickHouse 표현식을 반환합니다. 인수는 없습니다.
이 매크로는 컬럼을 대시보드 시간 범위에 맞게 필터링하는
WHERE 절 조각을 생성합니다.
$__timeFilter(TimestampTime)의 예시 확장:
SELECT 및 GROUP BY 절에 사용됩니다. 이 매크로는 Line 및 Stacked-bar 시각화에서만 사용할 수 있습니다.
$__timeInterval(TimestampTime)의 확장 예시:
차트에서 Source가 선택되어 있고 대시보드 필터가 활성화되어 있으면
$__filters는 해당 SQL WHERE 조건으로 확장됩니다. Source가 선택되지 않았거나 적용된 필터가 없으면 (1=1)로 확장되므로 WHERE 절에 포함해도 항상 안전합니다.
Broadcast filter condition이 활성화된 필터만 $__filters에 적용됩니다. 변수로 노출된 필터는 아래에 설명된 대로 명시적으로 참조합니다.
대시보드 필터를 변수로 사용할 수 있는 경우, 선택된 값을 쿼리 어디에서나 참조할 수 있습니다. 이러한 매크로는 하나 이상의 변수를 선언한 대시보드에 속한 타일에서만 사용할 수 있습니다.
변수 값은
$name 또는 ${name}으로 직접 보간할 수도 있으며, 선택적으로 포맷을 지정할 수 있습니다. ${name:sqlstring}(기본값), ${name:csv}, ${name:regex}를 사용할 수 있습니다. 기본 포맷에서 직접 참조하면 아무 값도 선택되지 않은 경우 NULL이 렌더링되므로, 프레디케이트가 필요한 곳에서는 위 매크로를 사용하는 것이 좋습니다.
ClickStack는 컬럼 타입에 따라 결과 컬럼을 차트 요소에 자동으로 매핑합니다. 매핑 규칙은 차트 유형별로 다릅니다.
모든 결과 컬럼이 테이블의 컬럼으로 직접 표시됩니다.
필수 system table 접근 권한play-clickstack.clickhouse.com에서 다음 예시를 실행하려면
otel_v2.otel_logs 또는 otel_v2.otel_traces를 지정해야 합니다.ts(DateTime)는 x축 타임스탬프로 사용됩니다.count(numeric)는 시리즈 값으로 표시됩니다.ServiceName(string)은 서비스마다 별도의 선을 생성합니다.
ServiceName에 대한 service 변수와 SeverityText에 대한 severity 변수가 있는 대시보드에서 이 쿼리는 차트를 현재 선택된 서비스로 제한하고 선택된 심각도는 제외합니다. 두 매크로는 변수에서 아무것도 선택되지 않은 경우 1=1로 확장되므로, Viewer가 값을 선택하기 전까지 차트는 필터링 없이 표시됩니다.
request_count(숫자형)은 각 조각의 크기를 결정합니다.ServiceName(문자열)은 각 조각의 레이블을 지정합니다.
total_errors가 표시됩니다.
- SQL 기반 시각화는
readonly모드가 활성화된 상태로 실행되며,SELECT쿼리만 허용됩니다. - SQL 기반 시각화에는 SQL 쿼리가 정확히 하나만 포함되어야 하며, 여러 쿼리는 지원되지 않습니다.
- SQL Editor는 쿼리 매개변수와 매크로 모두에 대해 자동 완성 제안을 제공합니다.
- 대시보드 필터를 SQL 기반 시각화에 적용하려면 Source를 선택해야 합니다. 정확하게 필터링되도록 Source는 조회하는 테이블과 일치해야 합니다.
- 대시보드 변수에는 Source가 필요하지 않습니다. 값은 타일 자체의 Source가 아니라 대시보드의 필터 드롭다운에서 가져옵니다.
- 대시보드 변수를 참조하는 SQL 타일의 알림은 대시보드에서 선택한 값이 아니라 모든 변수가 비어 있는 상태에서 평가됩니다.