Database 매뉴얼 · Chapter 4

DB Studio — SQL · Data 탭으로 검증

스크립트로 코드를 작성하기 전에, DB Studio 의 두 탭으로 연결과 데이터를 직접 확인해 두는 것을 권장합니다. 같은 SQL 을 두 번 실행해 보고, 같은 결과가 나오는지 확인한 뒤 스크립트로 옮기는 흐름입니다.

xscript
Solution Explorer
├── Data Editor Pages
└── Database                       ← Data Editor Pages 와 같은 최상위 레벨
    ├── Database Connections       (2장)
    ├── Database Studio            ← 이 챕터
    │   ├── Structure 탭            (3장에서 테이블 / 컬럼 트리)
    │   ├── Data 탭                 ( 단위 조회 — 읽기 전용)
    │   └── SQL 탭                  (자유로운 SQL 실행)
    └── Database Events            (8장)

좌측 트리에서 local 연결을 선택한 뒤 탭을 전환합니다.

SQL 탭 — 자유 실행

상단 입력란에 SQL 을 작성하고 [Run] 버튼 또는 F5 로 실행합니다.

샘플 프로젝트에서 자주 써보면 좋은 SQL 들입니다.

sql
-- 전체 행 수
SELECT COUNT(*) FROM order_history;
 
-- 최근 작업 5건
SELECT id, order_no, menu_name, result, end_time
FROM   order_history
ORDER  BY id DESC
LIMIT  5;
 
-- 결과별 집계
SELECT result, COUNT(*) AS cnt
FROM   order_history
GROUP  BY result;
 
-- 에러만 보기
SELECT id, order_no, menu_name, weight_g
FROM   order_history
WHERE  is_error = 1;

스크립트의 RunSqlSelect / RunSqlScalarInt 가 이 탭에서 잘 동작하는 SQL 을 그대로 인자로 받습니다. 여기서 통과한 SQL 만 스크립트에 옮기는 습관 을 들이면 디버깅 시간이 크게 줄어듭니다.

결과 영역

영역내용
결과 그리드SELECT 결과 행 — 컬럼명, 값, 정렬 표시
상태 메시지SELECT 는 N row(s) returned. (ms ms), INSERT / UPDATE / DELETE 는 N row(s) affected. (ms ms)
실행 시간위 메시지의 (ms ms) 로 응답성 확인

Data 탭 — 행 단위 조회 (읽기 전용)

좌측 트리에서 테이블을 선택하면 그 테이블의 행을 표 형태로 조회 할 수 있습니다. 이 버전에서 Data 탭은 읽기 전용 이며, 다음 컨트롤로 표시할 행을 추립니다.

  • WHERE 입력란 — 필터 조건(예: is_error = 1). 비워 두면 전체 행.
  • Page Size — 한 번에 불러올 최대 행 수 (기본 100).
  • [Load] 버튼 — 위 조건으로 행을 다시 읽어 그리드에 표시.

화면 하단에는 "Data editing is read-only in this version. Use SQL tab for INSERT/UPDATE/DELETE." 안내가 있습니다. INSERT / UPDATE / DELETE 는 모두 SQL 탭에서 수행합니다.

이 탭의 권장 용도는 다음과 같습니다.

  • WHERE 필터로 특정 조건의 행만 빠르게 확인
  • 스크립트 결과(예: DB_UpdateSelected 후) 가 실제 DB 에 반영됐는지 눈으로 확인
  • 빈 테이블인지, 데이터가 들어왔는지 확인

검증 흐름 — 추천 순서

  1. Connections 에서 local 이 정상 등록됐는지 확인 (2장)
  2. Structure 탭에서 order_history 테이블이 보이는지 확인 (3장)
  3. Data 탭에서 [Load] 로 현재 행을 조회 (WHERE 로 필터 가능)
  4. SQL 탭에서 위 4 개 쿼리를 실행해 결과 확인
  5. 비어 있다면 다음 코드를 SQL 탭에서 실행해 한 행 채워 두기:
sql
INSERT INTO order_history(order_no, menu_name, start_time, end_time, weight_g, result, is_error)
VALUES('O0001', 'Americano', '2026-01-01 09:00:00', '2026-01-01 09:00:30', 250, 'Done', 0);

이 5 단계가 끝났다면 다음은 스크립트 차례입니다.