SQL 편집기는 데이터를 한꺼번에 삭제하거나 테이블을 없애는 문장을 실행하기 직전에 확인 창을 띄웁니다. 창의 모양과 버튼, 그리고 실행 경로마다 어떤 확인이 걸리는지 설명합니다. 어떤 장치가 어떤 실행에 걸리는지의 전체 그림은 운영 DB 안전장치 에 있습니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 제목 | TRUNCATE, DROP, ALTER … DROP 이 있으면 위험한 작업 제목, WHERE 가 없는 UPDATE, DELETE 만 있으면 실행 확인 제목입니다. |
| 2 | 이유 | 창이 표시된 이유입니다. 아래 표의 이유 문구와 이 SQL 문을 실행하시겠습니까? 문구가 나옵니다. 여러 문장을 실행할 때는 걸린 문장의 앞부분을 함께 보여 줍니다. |
| 3 | 이 커넥션에서 이 유형은 다시 묻지 않기 상자 | 선택하고 실행하면 같은 커넥션에서 같은 유형의 문장은 앱을 다시 시작할 때까지(웹은 페이지를 새로고침할 때까지) 묻지 않습니다. 다른 커넥션과 다른 프로젝트에는 적용되지 않습니다. 처음에는 비활성화되어 있습니다. |
| 4 | 취소 버튼 | 실행하지 않고 창을 닫습니다. 창이 열리면 이 버튼에 초점이 있어서, 창을 읽지 않고 Enter 키를 눌러도 실행되지 않습니다. |
| 5 | 실행 버튼 | 문장을 실행합니다. |
창이 표시되는 문장과 이유 문구는 아래와 같습니다.
| 문장 | 이유 문구 |
|---|---|
TRUNCATE 로 시작하는 문장 | TRUNCATE 문 |
DROP 으로 시작하는 문장(DROP TABLE, DROP VIEW, DROP PROCEDURE 등 모두) | DROP 문 |
ALTER TABLE … DROP COLUMN 처럼 무언가를 삭제하는 ALTER | ALTER … DROP 문(컬럼·제약 등 삭제) |
WHERE 가 없는 UPDATE(WITH 로 시작하는 것 포함) | WHERE 절 없는 UPDATE 문 |
WHERE 가 없는 DELETE(WITH 로 시작하는 것 포함) | WHERE 절 없는 DELETE 문 |
- 주석과 문자열 안의 글자는 보지 않습니다. 서브쿼리 안의
WHERE는 대상 행을 거르지 않으므로WHERE로 치지 않습니다. - 커넥션 프로파일과 상관없이 모든 커넥션에서 표시됩니다.
확인하고 실행하기
- SQL 탭에서 문장에 커서를 두고 Execute 버튼을 클릭합니다(
Ctrl+Enter, macOS 는Cmd+Enter). 바인드 파라미터가 있으면 값을 넣는 창(바인드 파라미터)이 먼저 열리고, 값을 넣은 문장으로 판단합니다. - 창이 표시되면 이유를 읽고, 편집기의 문장과 탭의 실행 대상(커넥션, 데이터베이스, 스키마)이 맞는지 확인합니다.
- 실행하려면 실행 버튼을, 멈추려면 취소 버튼을 클릭합니다. 창 밖을 클릭하거나
Esc키를 눌러도 닫히지 않습니다.
확인 창을 띄우기 전에 아래 검사를 차례로 합니다. 앞의 검사에서 차단되면 묻지 않고 멈추므로, 실행을 확인한 뒤에 차단되는 일은 없습니다.
| 순서 | 검사 | 걸리면 |
|---|---|---|
| 1 | 역할별 DDL 제한(계정 프로젝트) | 실행하지 않고 DDL 실행이 제한되어 있습니다. 승인자에게 DB 반영을 요청하세요. 알림을 띄웁니다 |
| 2 | 커넥션 프로파일의 보호 모드 | 읽기 전용이면 차단하고, 확인이면 아래 '보호 모드의 확인 창' 을 띄웁니다 |
| 3 | 위험 SQL 확인 | 묻습니다. 2 에서 이미 창을 띄웠으면 그 창 하나로 함께 묻습니다 |
보호 모드의 확인 창
커넥션 프로파일의 보호 모드가 확인 (DDL + 위험 DML) 상태인 커넥션에서는 DDL 과 WHERE 가 없는 UPDATE, DELETE 를 실행하기 전에 이 창이 표시됩니다. 스테이징 환경과 운영 환경은 처음부터 같은 상태입니다(커넥션 프로파일).
- 제목(1)은
[PROD] shop-db처럼 대문자로 표기한 환경의 영문 이름과 커넥션 이름입니다. 환경이 사용자 지정 상태인 프로파일이면 환경 자리에 보호됨 표시가 나옵니다. - 이유(2)는 DDL 이면 보호된 커넥션의 스키마 변경(DDL)입니다. 문구,
WHERE가 없는UPDATE,DELETE이면 보호된 커넥션에서 WHERE 절 없는 UPDATE/DELETE 입니다. 문구입니다. 위험 SQL 확인에도 걸리는 문장이면 그 이유도 같은 창에 함께 나옵니다. - 실행 버튼(3)을 클릭해야 실행합니다. 처음 초점은 취소 버튼에 있습니다. 보호 모드의 확인 창에는 이 커넥션에서 이 유형은 다시 묻지 않기 상자가 없어서, 위험 SQL 확인을 비활성화해 둔 유형도 보호된 커넥션에서는 계속 묻습니다.
- Run Script 버튼으로 여러 문장을 실행할 때는 걸리는 문장을 모아 실행 전에 한 번만 묻습니다. 본문 아래 문구는 이 스크립트를 실행하시겠습니까? 입니다.
- 결과 편집 반영, ERD 의 DB 반영처럼 SQL 편집기 밖에서 DB 의 데이터를 변경하는 경로도 같은 창으로 묻습니다. 이때 버튼은 적용 버튼이고 문구는 이 변경을 DB 에 반영하시겠습니까? 입니다.
읽기 전용 커넥션에서 차단되는 모양
보호 모드가 읽기 전용 (SELECT 외 차단) 상태인 커넥션에서 조회가 아닌 문장을 실행하면, 실행하지 않고 화면 위에 빨간 알림을 띄웁니다. 묻는 창은 없습니다.
| 문장 | 알림 |
|---|---|
| DDL | 읽기 전용 커넥션에서는 DDL 을 실행할 수 없습니다. |
| 나머지 데이터를 변경하는 문장 | 읽기 전용 커넥션에서는 데이터를 바꾸는 문장을 실행할 수 없습니다. |
- Run Script 버튼은 차단되는 문장이 하나라도 있으면 스크립트 전체를 실행하지 않습니다.
DELETE FROM coupon처럼 위험 SQL 확인에도 걸리는 문장도 위험 SQL 확인 창 없이 바로 차단됩니다.- 조회인지는 문장 본문까지 보고 판단합니다. 판단 기준은 운영 DB 안전장치 에서 설명합니다.
실행 경로마다 걸리는 확인
위험 SQL 확인 창은 SQL 편집기의 Execute 버튼(단축키와 편집기 우클릭의 현재 문 실행 항목 포함)과 Run Script 버튼으로 실행할 때 표시됩니다. 보호 모드는 DB 의 데이터를 변경하는 모든 경로에 걸립니다.
| 실행 경로 | 위험 SQL 확인 창 | 보호 모드 |
|---|---|---|
| Execute 버튼 | 표시됩니다 | 걸립니다 |
| Run Script 버튼 | 표시됩니다. 걸린 문장을 모아 한 번 묻습니다 | 걸립니다 |
| 결과 그리드 편집의 반영(탭을 닫을 때 반영을 선택한 경우와 테이블, 객체의 데이터 탭 포함) | 표시되지 않습니다. 데이터 변경사항 미리보기 창이 실행할 SQL 을 먼저 보여 줍니다 | 걸립니다 |
| ERD 의 DB 반영, 테이블 저장, 탐색기의 객체 변경과 삭제 | 표시되지 않습니다. 각 화면이 실행할 SQL 을 먼저 보여 줍니다 | 걸립니다 |
| 파일의 데이터를 테이블에 넣기, 덤프 파일 복원 | 표시되지 않습니다 | 걸립니다 |
| AI Assistant 패널이 실행하는 SQL | 표시되지 않습니다 | 걸립니다 |
| 외부 MCP 클라이언트가 보낸 SQL | 표시되지 않습니다 | 걸립니다. 모든 문장이 대상입니다 |
주의할 점
- 위험 SQL 확인은 문장의 모양만 봅니다.
WHERE 1=1을 붙인DELETE처럼 조건이 있어도 모든 행을 변경하는 문장은 창 없이 실행됩니다. - 여러 문장을 선택하고 Execute 버튼을 클릭하면 선택한 글자를 한 번에 보내지만, 확인은 문장마다 합니다. 어느 한 문장이라도 걸리면 묻습니다.
- 운영 DB 에서 데이터를 수정할 때는 Auto Commit 스위치를 비활성화하고 실행한 뒤 결과를 확인하고 커밋하세요 (SQL 실행과 트랜잭션).
관련 화면
- 운영 DB 안전장치: 위험 SQL 확인, 보호 모드, 역할별 DDL 제한이 어떤 실행에 걸리는지입니다.
- 커넥션 프로파일: 보호 모드와 환경을 정하는 탭입니다.
- SQL 편집기: Execute 버튼과 Run Script 버튼입니다.
- 결과 데이터 편집: 미리보기 창에서 변경 SQL 을 확인하고 실행합니다.