화면: 대시보드

타일 설정

타일 설정 창은 대시보드 타일 하나를 정하는 창입니다. 어느 커넥션에 어떤 SELECT 문을 보내고, 결과를 숫자, 차트, 표 가운데 무엇으로 그리고, 얼마나 크게, 얼마나 자주 실행할지를 정합니다. 왼쪽이 타일의 정의이고 오른쪽이 정의로 실제로 조회해 본 미리보기입니다. 타일이 놓이는 대시보드 화면은 대시보드 에서 설명합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

화면 구성

번호이름설명
1타입 칸숫자(단일값), 차트, 표 항목 가운데 선택합니다.
2차트 종류 칸차트를 선택했을 때만 보입니다. 막대, 세로 막대, 선, 영역, 파이, 도넛, 산점도 항목 가운데 선택합니다.
3이름 칸타일 머리에 보일 이름입니다. 비워 두면 이름 없는 타일 표시가 보입니다.
4커넥션 칸과 스키마 칸타일이 조회할 커넥션과 데이터베이스, 스키마입니다. 스키마를 선택하지 않은 타일(새 타일, 커넥션 제안으로 만든 타일)은 칸에 커넥션 기본 스키마 표시가 보이고 커넥션의 기본 스키마로 조회합니다. 커넥션을 변경하면 새 커넥션의 첫 스키마가 선택됩니다.
5쿼리 칸타일의 SELECT 문입니다. 선택한 스키마의 테이블과 컬럼이 자동 완성됩니다. 아래에 선택한 타입이 기대하는 결과 모양이 한 줄로 적힙니다.
6데이터 조회 버튼지금 정의로 실제로 조회합니다. SQL 이 규칙에 맞지 않으면 비활성화되고 옆에 이유가 보입니다.
7표시 옵션 칸단위 칸, 소수점 칸, 표시 건수 칸처럼 선택한 타입이 사용하는 옵션만 보입니다(아래 '표시 옵션').
8크기 칸폭(12칸 가운데)과 높이(행) 항목입니다. 옆에 선택한 타입의 최소, 최대 크기가 적힙니다.
9실행 주기 칸자동 실행 스위치와 주기입니다(아래 '실행 주기').
10결과 데이터 표조회한 결과의 앞 10행입니다. 조회하기 전에는 데이터 조회를 누르면 결과가 여기 표시됩니다 안내가 보입니다.
11컬럼 지정 칸차트에서 어느 컬럼이 어떤 역할을 할지 정합니다. 조회해서 컬럼을 안 뒤에만 보입니다(아래 '컬럼 지정').
12차트 미리보기 버튼차트 타입일 때 미리보기 결과를 타일과 같은 차트로 그립니다. 한 번 펼치면 옵션을 변경할 때마다 다시 그립니다.
  • 창의 확인 버튼은 SQL 이 규칙에 맞고 커넥션이 선택되어 있을 때 활성화됩니다. 미리보기를 하지 않아도 저장할 수 있습니다.
  • 차트 종류 칸, 컬럼 지정 칸, 표시 옵션 칸을 변경할 때는 다시 조회하지 않고 이미 가져온 결과를 다시 그립니다. 조회는 버튼을 클릭할 때만 나갑니다.

타일 만들기

  1. 대시보드 도구 모음의 + 타일 버튼을 클릭합니다. 타일 추가 창이 열립니다.
  2. 타입 칸에서 타입을 선택하고, 차트이면 종류를 선택합니다.
  3. 커넥션과 스키마를 선택하고 SELECT 문을 적습니다. 쿼리 칸 아래의 결과 모양 안내에 맞춰 컬럼을 선택하세요.
  4. 데이터 조회 버튼을 클릭해 결과를 확인합니다. 차트이면 차트 미리보기 버튼으로 모양을 봅니다.
  5. 주기적으로 실행할 타일이면 자동 실행 스위치를 활성화합니다.
  6. 확인 버튼을 클릭합니다. 타일이 첫 빈 자리에 들어가고 한 번 실행됩니다.
  • 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, 둘째 열이 ySELECT 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 시간대로 읽어 내 시간대로 변환해 보여 줍니다. 결과에 시각 컬럼이 없으면 보이지 않습니다

크기

폭은 12칸 가운데 몇 칸, 높이는 몇 행(1행은 118px)인지입니다. 타입마다 읽을 수 있는 크기만 선택할 수 있습니다.

타입처음 크기최소최대
숫자3×12×112×2
막대, 세로 막대4×23×212×4
선, 영역8×24×212×4
파이, 도넛4×23×26×4
산점도6×24×212×4
표8×24×212×4
  • 타입을 변경할 때 크기를 손대지 않았으면 새 타입의 처음 크기로, 손댔으면 새 타입의 최소, 최대 안으로만 맞춥니다.
  • 대시보드에서 드래그해서 변경할 수도 있습니다(대시보드).

실행 주기

  1. 자동 실행 스위치를 활성화합니다. 직접 만든 타일은 비활성화되어 있습니다.
  2. 대시보드 기본값 버튼을 선택하면 대시보드 도구 모음의 기본 주기를 따릅니다. 이 타일만 따로 버튼을 선택하면 타일만의 주기를 초로 적습니다.
  • 하한 30초. 앱이 떠 있고 이 탭이 보이는 동안에만 돕니다.
  • 대시보드의 자동 실행 스위치가 비활성화되어 있으면 타일 스위치가 활성화되어 있어도 실행되지 않습니다.
  • 스위치가 비활성화된 타일은 지금 실행 버튼이나 전체 새로고침 버튼을 클릭할 때만 실행됩니다.

조회 기간과 시간대

SQL 에 :from 이나 :to 를 사용하면 대시보드 도구 모음의 기간 칸 값이 들어갑니다. 사용하기 전에는 쿼리 칸 아래에 조회 기간을 쓰려면 :from · :to 를 넣으세요 — 툴바의 [기간] 값이 들어갑니다. 다른 이름은 받지 않습니다. 안내가 보이고, 사용하기 시작하면 아래 그림의 줄들이 나타납니다.

  • 느낌표 표시(1)에 마우스를 올리면 규칙이 보입니다. :to 는 선택한 마지막 날의 다음 날 0시라 >= :from AND < :to 로 작성해야 선택한 날이 모두 들어옵니다. 날짜만이나 문자열로 저장된 컬럼은 쿼리에서 CAST 등으로 맞추세요.
  • 내 시간대로 조회 상자(2)를 활성화하면 DB 시간대 대신 내 시간대의 시각으로 보냅니다. 타일 바닥에 시계 아이콘이 붙습니다. 시간대가 다른 팀원은 다른 구간을 조회하게 됩니다.
  • 오른쪽의 기간 칸(3)은 미리보기에만 사용합니다. 대시보드의 기간은 변경되지 않습니다. 한 번 조회한 뒤에는 기간을 변경하면 바로 다시 조회합니다.
  • 조회 기간 (…) 표시(4)는 실제로 나갈 :from, :to 값과 기준 시간대입니다. DB 시간대를 모르면 UTC · DB 시간대 미확인 표시가 보입니다.

세트 타일 분리

프리셋 갤러리 의 세트로 넣은 타일은 다른 타일과 조회 하나를 나눠 사용합니다. 세트 타일의 쿼리를 수정하면 옆 타일의 값이 함께 변경되므로, 설정 창을 열기 전에 세트에서 분리합니다.

  1. 세트 타일의 설정 버튼을 클릭합니다. 세트에서 분리 창이 표시됩니다.
  2. 분리하고 편집 버튼을 클릭합니다. 설정 창이 세트의 SQL 과 주기를 이어받은 타일로 열립니다.
  3. 설정 창에서 확인 버튼을 클릭하면 분리가 저장됩니다. 설정 창을 저장하지 않고 닫으면 타일은 세트에 그대로 남습니다.
  • 분리한 타일은 따로 조회하므로 주기마다 조회가 하나 늘어납니다.
  • 세트에서 결과를 계산해 사용하던 타일(예: 행 수, 합계)은 값 계산 줄에 계산을 가져옵니다. 쿼리를 수정해도 남고, 해제 버튼을 클릭하면 조회 결과를 그대로 사용합니다. 계산이 있는 동안에는 컬럼 지정 칸이 보이지 않습니다.

주의할 점

  • 데이터 조회 버튼은 실제 DB 에 조회를 보냅니다. 무거운 쿼리는 운영 DB 에서 시험하지 마세요.
  • 데이터를 변경하는 문장은 차단하지만, SELECT 안에서 호출하는 함수가 데이터를 변경하는 것은 문장만 보고 차단할 수 없습니다. 운영 DB 에는 읽기 전용 DB 계정을 사용하세요 (운영 DB 안전장치).
  • 결과는 200행까지만 받습니다. 집계는 SQL 에서 하세요. 큰 표를 가져와 타일에서 줄이는 방식은 DB 에도 앱에도 부담입니다.
  • 창의 취소 버튼은 변경한 것을 버립니다. 저장한 타일을 삭제하려면 대시보드에서 타일 머리의 삭제 버튼을 클릭하세요.

관련 화면