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 에 반영됐는지 눈으로 확인 - 빈 테이블인지, 데이터가 들어왔는지 확인
검증 흐름 — 추천 순서
- Connections 에서
local이 정상 등록됐는지 확인 (2장) - Structure 탭에서
order_history테이블이 보이는지 확인 (3장) - Data 탭에서 [Load] 로 현재 행을 조회 (WHERE 로 필터 가능)
- SQL 탭에서 위 4 개 쿼리를 실행해 결과 확인
- 비어 있다면 다음 코드를 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 단계가 끝났다면 다음은 스크립트 차례입니다.