타일 설정 창은 대시보드 타일 하나를 정하는 창입니다. 어느 커넥션에 어떤 SELECT 문을 보내고, 결과를 숫자, 차트, 표 가운데 무엇으로 그리고, 얼마나 크게, 얼마나 자주 실행할지를 정합니다. 왼쪽이 타일의 정의이고 오른쪽이 정의로 실제로 조회해 본 미리보기입니다. 타일이 놓이는 대시보드 화면은 대시보드 에서 설명합니다.
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 타입 칸 | 숫자(단일값), 차트, 표 항목 가운데 선택합니다. |
| 2 | 차트 종류 칸 | 차트를 선택했을 때만 보입니다. 막대, 세로 막대, 선, 영역, 파이, 도넛, 산점도 항목 가운데 선택합니다. |
| 3 | 이름 칸 | 타일 머리에 보일 이름입니다. 비워 두면 이름 없는 타일 표시가 보입니다. |
| 4 | 커넥션 칸과 스키마 칸 | 타일이 조회할 커넥션과 데이터베이스, 스키마입니다. 스키마를 선택하지 않은 타일(새 타일, 커넥션 제안으로 만든 타일)은 칸에 커넥션 기본 스키마 표시가 보이고 커넥션의 기본 스키마로 조회합니다. 커넥션을 변경하면 새 커넥션의 첫 스키마가 선택됩니다. |
| 5 | 쿼리 칸 | 타일의 SELECT 문입니다. 선택한 스키마의 테이블과 컬럼이 자동 완성됩니다. 아래에 선택한 타입이 기대하는 결과 모양이 한 줄로 적힙니다. |
| 6 | 데이터 조회 버튼 | 지금 정의로 실제로 조회합니다. SQL 이 규칙에 맞지 않으면 비활성화되고 옆에 이유가 보입니다. |
| 7 | 표시 옵션 칸 | 단위 칸, 소수점 칸, 표시 건수 칸처럼 선택한 타입이 사용하는 옵션만 보입니다(아래 '표시 옵션'). |
| 8 | 크기 칸 | 폭(12칸 가운데)과 높이(행) 항목입니다. 옆에 선택한 타입의 최소, 최대 크기가 적힙니다. |
| 9 | 실행 주기 칸 | 자동 실행 스위치와 주기입니다(아래 '실행 주기'). |
| 10 | 결과 데이터 표 | 조회한 결과의 앞 10행입니다. 조회하기 전에는 데이터 조회를 누르면 결과가 여기 표시됩니다 안내가 보입니다. |
| 11 | 컬럼 지정 칸 | 차트에서 어느 컬럼이 어떤 역할을 할지 정합니다. 조회해서 컬럼을 안 뒤에만 보입니다(아래 '컬럼 지정'). |
| 12 | 차트 미리보기 버튼 | 차트 타입일 때 미리보기 결과를 타일과 같은 차트로 그립니다. 한 번 펼치면 옵션을 변경할 때마다 다시 그립니다. |
- 창의 확인 버튼은 SQL 이 규칙에 맞고 커넥션이 선택되어 있을 때 활성화됩니다. 미리보기를 하지 않아도 저장할 수 있습니다.
- 차트 종류 칸, 컬럼 지정 칸, 표시 옵션 칸을 변경할 때는 다시 조회하지 않고 이미 가져온 결과를 다시 그립니다. 조회는 버튼을 클릭할 때만 나갑니다.
타일 만들기
- 대시보드 도구 모음의 + 타일 버튼을 클릭합니다. 타일 추가 창이 열립니다.
- 타입 칸에서 타입을 선택하고, 차트이면 종류를 선택합니다.
- 커넥션과 스키마를 선택하고 SELECT 문을 적습니다. 쿼리 칸 아래의 결과 모양 안내에 맞춰 컬럼을 선택하세요.
- 데이터 조회 버튼을 클릭해 결과를 확인합니다. 차트이면 차트 미리보기 버튼으로 모양을 봅니다.
- 주기적으로 실행할 타일이면 자동 실행 스위치를 활성화합니다.
- 확인 버튼을 클릭합니다. 타일이 첫 빈 자리에 들어가고 한 번 실행됩니다.
- SQL 편집기의 대시보드 버튼으로도 타일 설정 창을 엽니다. 열면 SQL 과 실행 대상이 자동 기입되어 있습니다 (대시보드).
- 있는 타일은 머리의 설정 버튼으로 타일 설정 창을 엽니다. 타입을 변경해 크기가 커지면 옆 타일을 밀어 다시 배치합니다.
타일 SQL 의 규칙
타일은 보지 않는 사이에도 주기적으로 되풀이해 실행됩니다. 그래서 SQL 편집기보다 좁게 받습니다. 규칙은 저장할 때와 실행할 때마다 확인합니다.
SELECT나WITH로 시작하는 문장 하나만 받습니다. 앞의 주석은 괜찮습니다. 문장이 둘 이상이면 받지 않습니다.WITH뒤에INSERT,UPDATE,DELETE같은 데이터를 변경하는 구문이 있으면 받지 않습니다. 문자열 안의 낱말도 걸릴 수 있으니 문장을 변경해 작성하세요.SHOW,DESCRIBE,EXPLAIN은 받지 않습니다.- 바인드 이름은
:from과:to만 사용합니다. 다른 이름은 기입해 줄 값이 없어 받지 않습니다.
실행은 이렇게 합니다.
- 세션 없이 자동 커밋으로 실행합니다. 타일이 트랜잭션을 열어 둔 채 남지 않습니다.
- 결과는 200행까지만 받습니다. 표 타일은 받은 행 가운데 표시 건수만 그립니다.
- SQL 실행 기록에 남지 않습니다. 계정 프로젝트에서 마스킹된 컬럼은 SQL 편집기와 같이 마스킹됩니다.
- 직접 클릭한 실행은 60초, 자동 실행은 주기의 80%(60초를 넘지 않음) 안에 끝나지 않으면 시간 초과 오류가 됩니다.
결과 모양
타입마다 결과의 열을 읽는 방법이 정해져 있습니다. 쿼리 칸 아래에도 선택한 타입의 규칙이 한 줄로 적힙니다.
| 타입 | SQL 이 돌려줄 것 | 예(데모 상점) |
|---|---|---|
| 숫자 | 1행 1열의 값. 둘째 열이 있으면 값 아래의 설명이 됩니다 | SELECT COUNT(*) FROM orders |
| 막대, 세로 막대, 파이, 도넛 | 첫 열이 항목 이름, 둘째 열이 숫자. 순서는 ORDER BY 를 따릅니다 | SELECT status, COUNT(*) FROM orders GROUP BY status |
| 선, 영역 | 첫 열이 시간이나 순서, 둘째 열이 숫자. ORDER BY 로 축 순서를 맞춥니다 | SELECT date(ordered_at) AS day, SUM(total_amount) FROM orders GROUP BY day ORDER BY day |
| 산점도 | 두 열 모두 숫자. 첫 열이 x, 둘째 열이 y | SELECT price, stock FROM product |
| 표 | 열 구성은 자유. 표시 건수까지 그립니다 | SELECT order_id, status, total_amount FROM orders ORDER BY ordered_at DESC |
- 계열을 여러 개 그리려면 세 열(항목, 계열, 값)이나 숫자 열 여러 개를 돌려줍니다. 막대, 세로 막대, 선, 영역 타입만 계열을 겹칠 수 있습니다.
- 차트로 그릴 수 없으면 차트 대신 이유를 적습니다. 숫자 열이 없을 때, 계열이 50개를 넘을 때, 파이, 도넛에 계열이 여럿일 때, 숫자 열이 여럿인데 항목 값이 겹쳐 역할을 정할 수 없을 때입니다. 마지막 경우는 컬럼 지정 칸으로 해제합니다.
- 결과가 0행이면 결과가 없습니다 표시가 보입니다.
컬럼 지정
컬럼 지정 칸은 비워 두면 결과 모양으로 저절로 정합니다. 항목 값이 겹쳐 저절로 가릴 수 없을 때만 선택하세요.
- 막대, 선 같은 차트는 라벨축 칸, 값 칸이 있고, 계열을 겹칠 수 있는 차트에는 계열(범례) 칸이 더 있습니다. 계열에는 분류 열을 선택합니다. 숫자 열을 선택하면 선택한 열의 값이 계열 이름이 됩니다.
- 산점도는 X축 칸과 Y축 칸입니다. 비우면 첫 두 열을 사용합니다.
표시 옵션
| 옵션 | 사용하는 타입 | 설명 |
|---|---|---|
| 단위 칸, 소수점 칸 | 표를 제외한 모든 타입 | 값 뒤에 붙일 단위와 소수점 자릿수(0~6)입니다. 단위 앞에 공백을 넣으면 띄어 표시합니다. 차트는 축 눈금, 툴팁, 값 라벨에 사용합니다 |
| 표시 건수 칸 | 숫자를 제외한 모든 타입 | 그릴 행 수입니다. 비우면 20건, 많아야 50건입니다. 파이, 도넛으로 변경하면 비어 있을 때 8건이 기입됩니다 |
| 계열 누적 상자 | 막대, 세로 막대, 선, 영역 | 계열이 여럿일 때 쌓아 그립니다 |
| 추세선 상자 | 막대, 세로 막대, 선, 영역 | 값들을 지나는 직선 하나로 방향을 보여 줍니다. 계열이 하나일 때만 그립니다 |
| 내 시간대로 표시 상자 | 산점도를 제외한 모든 타입 | 시간대가 없는 시각 컬럼을 DB 시간대로 읽어 내 시간대로 변환해 보여 줍니다. 결과에 시각 컬럼이 없으면 보이지 않습니다 |
- 시각의 표시 형식과 내 시간대는 SQL 편집기와 같은 설정을 사용합니다(SQL 실행과 트랜잭션).
크기
폭은 12칸 가운데 몇 칸, 높이는 몇 행(1행은 118px)인지입니다. 타입마다 읽을 수 있는 크기만 선택할 수 있습니다.
| 타입 | 처음 크기 | 최소 | 최대 |
|---|---|---|---|
| 숫자 | 3×1 | 2×1 | 12×2 |
| 막대, 세로 막대 | 4×2 | 3×2 | 12×4 |
| 선, 영역 | 8×2 | 4×2 | 12×4 |
| 파이, 도넛 | 4×2 | 3×2 | 6×4 |
| 산점도 | 6×2 | 4×2 | 12×4 |
| 표 | 8×2 | 4×2 | 12×4 |
- 타입을 변경할 때 크기를 손대지 않았으면 새 타입의 처음 크기로, 손댔으면 새 타입의 최소, 최대 안으로만 맞춥니다.
- 대시보드에서 드래그해서 변경할 수도 있습니다(대시보드).
실행 주기
- 자동 실행 스위치를 활성화합니다. 직접 만든 타일은 비활성화되어 있습니다.
- 대시보드 기본값 버튼을 선택하면 대시보드 도구 모음의 기본 주기를 따릅니다. 이 타일만 따로 버튼을 선택하면 타일만의 주기를 초로 적습니다.
- 하한 30초. 앱이 떠 있고 이 탭이 보이는 동안에만 돕니다.
- 대시보드의 자동 실행 스위치가 비활성화되어 있으면 타일 스위치가 활성화되어 있어도 실행되지 않습니다.
- 스위치가 비활성화된 타일은 지금 실행 버튼이나 전체 새로고침 버튼을 클릭할 때만 실행됩니다.
조회 기간과 시간대
SQL 에 :from 이나 :to 를 사용하면 대시보드 도구 모음의 기간 칸 값이 들어갑니다. 사용하기 전에는 쿼리 칸 아래에 조회 기간을 쓰려면 :from · :to 를 넣으세요 — 툴바의 [기간] 값이 들어갑니다. 다른 이름은 받지 않습니다. 안내가 보이고, 사용하기 시작하면 아래 그림의 줄들이 나타납니다.
- 느낌표 표시(1)에 마우스를 올리면 규칙이 보입니다.
:to는 선택한 마지막 날의 다음 날 0시라>= :from AND < :to로 작성해야 선택한 날이 모두 들어옵니다. 날짜만이나 문자열로 저장된 컬럼은 쿼리에서CAST등으로 맞추세요. - 내 시간대로 조회 상자(2)를 활성화하면 DB 시간대 대신 내 시간대의 시각으로 보냅니다. 타일 바닥에 시계 아이콘이 붙습니다. 시간대가 다른 팀원은 다른 구간을 조회하게 됩니다.
- 오른쪽의 기간 칸(3)은 미리보기에만 사용합니다. 대시보드의 기간은 변경되지 않습니다. 한 번 조회한 뒤에는 기간을 변경하면 바로 다시 조회합니다.
- 조회 기간 (…) 표시(4)는 실제로 나갈
:from,:to값과 기준 시간대입니다. DB 시간대를 모르면 UTC · DB 시간대 미확인 표시가 보입니다.
세트 타일 분리
프리셋 갤러리 의 세트로 넣은 타일은 다른 타일과 조회 하나를 나눠 사용합니다. 세트 타일의 쿼리를 수정하면 옆 타일의 값이 함께 변경되므로, 설정 창을 열기 전에 세트에서 분리합니다.
- 세트 타일의 설정 버튼을 클릭합니다. 세트에서 분리 창이 표시됩니다.
- 분리하고 편집 버튼을 클릭합니다. 설정 창이 세트의 SQL 과 주기를 이어받은 타일로 열립니다.
- 설정 창에서 확인 버튼을 클릭하면 분리가 저장됩니다. 설정 창을 저장하지 않고 닫으면 타일은 세트에 그대로 남습니다.
- 분리한 타일은 따로 조회하므로 주기마다 조회가 하나 늘어납니다.
- 세트에서 결과를 계산해 사용하던 타일(예: 행 수, 합계)은 값 계산 줄에 계산을 가져옵니다. 쿼리를 수정해도 남고, 해제 버튼을 클릭하면 조회 결과를 그대로 사용합니다. 계산이 있는 동안에는 컬럼 지정 칸이 보이지 않습니다.
주의할 점
- 데이터 조회 버튼은 실제 DB 에 조회를 보냅니다. 무거운 쿼리는 운영 DB 에서 시험하지 마세요.
- 데이터를 변경하는 문장은 차단하지만, SELECT 안에서 호출하는 함수가 데이터를 변경하는 것은 문장만 보고 차단할 수 없습니다. 운영 DB 에는 읽기 전용 DB 계정을 사용하세요 (운영 DB 안전장치).
- 결과는 200행까지만 받습니다. 집계는 SQL 에서 하세요. 큰 표를 가져와 타일에서 줄이는 방식은 DB 에도 앱에도 부담입니다.
- 창의 취소 버튼은 변경한 것을 버립니다. 저장한 타일을 삭제하려면 대시보드에서 타일 머리의 삭제 버튼을 클릭하세요.
관련 화면
- 대시보드: 타일이 놓이는 화면, 기간, 자동 실행입니다.
- 프리셋 갤러리: 미리 만든 타일과 세트를 넣습니다.
- SQL 편집기: 타일로 보낼 SELECT 문을 다듬습니다.
- SQL 실행과 트랜잭션: 시각과 시간대가 보이는 방식입니다.
- 운영 DB 안전장치: 읽기 전용 계정을 권장하는 이유입니다.