운영 DB 에서 한 번 잘못 실행한 SQL 은 되돌리기 어렵습니다. NeoSQL 은 실수를 차단하는 장치를 여러 겹으로 둡니다. 장치마다 누가 정하는지, 어떤 실행에 걸리는지가 다르므로, 차단해 줄 것이라 믿은 곳이 비어 있지 않은지 알아 두세요.
안전장치는 여러 겹입니다
| 장치 | 정하는 사람 | 하는 일 | 사용할 수 있는 곳 |
|---|---|---|---|
| 커넥션 프로파일 | 나(개인 설정) | 환경을 색과 워터마크로 보여 주고, 보호 모드로 실행을 확인하거나 차단합니다 | 모든 프로젝트 |
| 위험 SQL 확인 | 늘 활성화되어 있습니다(커넥션마다 유형별로 비활성화할 수 있습니다) | 많은 데이터를 삭제하는 문장을 실행하기 전에 묻습니다 | 모든 프로젝트 |
| 역할별 DDL 제한과 DDL 승인 | 프로젝트를 관리하는 사람 | 지정한 역할의 DDL 실행을 차단하고 승인을 거치게 합니다 | 계정 프로젝트 |
| AI, MCP 커넥션 정책 | 커넥션의 AI 설정을 변경할 수 있는 사람 | AI 와 외부 MCP 클라이언트가 변경할 수 있는 것과 확인 여부를 정합니다 | 모든 프로젝트(MCP 는 데스크톱) |
| DB 계정의 권한 | DB 관리자 | DB 가 허용하지 않는 일은 어느 도구에서도 실행되지 않습니다 | NeoSQL 외부를 포함한 모든 경로 |
커넥션 프로파일로 환경을 구분합니다
커넥션 프로파일은 커넥션이 어느 환경인지 화면에 보여 주고, 실행을 얼마나 조심스럽게 할지 정합니다. 메뉴로 커넥션 창을 열고 프로파일 탭에서 정합니다.
- 프로파일은 개인 설정입니다. 계정 프로젝트에서는 내 계정에, 로컬 프로젝트에서는 기기의 프로젝트에 저장되고 팀원에게는 영향을 주지 않습니다.
- 계정 프로젝트에서 커넥션을 수정할 권한이 없는 팀원도 프로파일 탭은 열 수 있습니다.
환경 항목에서 환경을 선택하면 색상 항목, 배경 워터마크 항목, 보호 모드 항목이 함께 정해집니다. 선택한 뒤 하나씩 변경할 수 있습니다.
| 환경 | 색상 | 배경 워터마크 | 보호 모드 |
|---|---|---|---|
| 로컬 | 청록 | 끔 | 없음 |
| 개발 | 파랑 | 끔 | 없음 |
| 스테이징 | 주황 | 끔 | 확인 (DDL + 위험 DML) |
| 운영 | 빨강 | 켬 | 확인 (DDL + 위험 DML) |
| 사용자 지정 | 직접 선택합니다 | 직접 선택합니다 | 직접 선택합니다 |
- 선택한 색은 작업 탭의 표시(1)와 SQL 편집기 줄 번호 영역 오른쪽의 선(2)에 칠해집니다.
- 배경 워터마크 항목을 활성화하면 SQL 편집기와 ERD 배경에 라벨(3)이 깔립니다. 라벨 (선택) 칸을 비워 두면 커넥션 이름을 사용합니다.
- 색상 항목을 직접 선택하면 환경이 사용자 지정 환경으로 변경됩니다. 보호 모드와 워터마크는 그대로지만, SQL 세션의 유휴 시간은 사용자 지정 환경의 값을 따릅니다.
보호 모드
| 보호 모드 | 하는 일 |
|---|---|
| 없음 | 아무것도 묻지 않습니다 |
| 확인 (DDL + 위험 DML) | DDL(CREATE, ALTER, DROP, TRUNCATE, RENAME, GRANT 등으로 시작하는 문장과 테이블을 만드는 SELECT … INTO)과 WHERE 가 없는 UPDATE, DELETE 를 실행하기 전에 확인합니다. 확인 창 제목에 환경과 커넥션 이름이 나옵니다 |
| 읽기 전용 (SELECT 외 차단) | 조회가 아닌 문장을 실행하지 않습니다 |
보호 모드는 NeoSQL 안에서 DB 의 데이터를 변경하는 모든 경로에 걸립니다. 어느 경로든 같은 판단과 같은 확인 창을 사용합니다.
| 실행 경로 | 보호 모드 |
|---|---|
| SQL 편집기의 Execute 버튼과 Run Script 버튼 | 걸립니다 |
| AI Assistant 가 실행하는 SQL | 걸립니다. 읽기 전용 (SELECT 외 차단) 보호 모드면 조회가 아닌 모든 문장을 차단합니다 |
| 외부 MCP 클라이언트가 보낸 SQL | 걸립니다. 문장마다 판단하고, 여러 문장 중 하나라도 차단되면 아무것도 실행하지 않습니다 |
| 결과 그리드 편집의 반영(탭을 닫을 때 반영을 선택한 경우 포함), ERD 의 DB 반영, 탐색기의 객체 변경과 삭제 | 걸립니다. 각 화면이 실행할 SQL 을 보여 준 뒤 판단합니다 |
| 파일의 데이터를 테이블에 넣기, 덤프 파일 복원 | 걸립니다. 읽기 전용 (SELECT 외 차단) 보호 모드면 시작하지 않습니다 |
- 읽기 전용 (SELECT 외 차단) 보호 모드는 문장 본문까지 보고 조회인지 판단합니다.
SELECT,WITH,SHOW,DESCRIBE,EXPLAIN으로 시작해도WITH안에서 데이터를 변경하는 문장, 테이블을 만드는SELECT … INTO, 대상 문장을 실제로 실행하는EXPLAIN ANALYZE는 조회로 보지 않고 차단합니다. - 여러 문장을 한 번에 실행하면 문장마다 판단하고, 하나라도 차단되면 아무것도 실행하지 않습니다.
위험 SQL 확인
SQL 편집기는 커넥션 프로파일과 상관없이, 아래 문장을 실행하기 전에 한 번 더 묻습니다.
| 문장 | 확인 창 제목 |
|---|---|
TRUNCATE | 위험한 작업 |
DROP 으로 시작하는 모든 문장 | 위험한 작업 |
ALTER TABLE … DROP COLUMN 처럼 무언가를 삭제하는 ALTER | 위험한 작업 |
WHERE 가 없는 UPDATE, DELETE(WITH 로 시작하는 것 포함) | 실행 확인 |
- 위험 SQL 확인은 Execute 버튼과 Run Script 버튼으로 실행할 때 합니다. 바인드 파라미터가 있으면 값을 넣은 문장으로 판단합니다. Run Script 버튼은 걸리는 문장을 모아 실행 전에 한 번 묻습니다. 결과 그리드 편집에서는 하지 않습니다.
- 서브쿼리 안의
WHERE는 대상 행을 거르지 않으므로WHERE로 보지 않습니다. - 확인 창의 이 커넥션에서 이 유형은 다시 묻지 않기 항목을 선택하면 같은 커넥션에서 같은 유형은 앱을 다시 시작할 때까지(웹은 페이지를 새로고침할 때까지) 묻지 않습니다. 다른 커넥션과 다른 프로젝트에는 적용되지 않습니다.
- 역할별 DDL 제한과 보호 모드를 먼저 확인하고, 차단되는 문장은 묻지 않고 차단합니다. 확인 (DDL + 위험 DML) 보호 모드의 커넥션에서
WHERE가 없는UPDATE를 실행하면 두 확인을 창 하나로 묻습니다. 이 커넥션에서 이 유형은 다시 묻지 않기 항목은 보호 모드의 확인을 비활성화하지 않습니다. - 확인 창이 열리면 취소 버튼에 초점이 있습니다.
Enter키만 눌러서는 실행되지 않습니다.
계정 프로젝트의 역할별 DDL 제한과 DDL 승인
계정 프로젝트에서는 역할마다 DDL 실행을 차단하고, 스키마 변경을 승인자가 검토한 뒤 실행하게 할 수 있습니다. 프로젝트 소유자가
탭에서 역할마다 DDL 제한 항목과 승인자 역할 항목을 정합니다. 처음에는 어느 역할에도 활성화되어 있지 않습니다.| DDL 이 제한된 팀원이 | 결과 |
|---|---|
| SQL 편집기에서 DDL 을 실행하면 | 실행하지 않고 승인자에게 DB 반영을 요청하라고 안내합니다 |
| ERD 의 변경을 DB 에 반영하면 | DDL 을 실행하는 대신 사유를 적어 승인을 요청합니다 |
| AI Assistant 나 외부 MCP 클라이언트로 DDL 을 실행하면 | 차단합니다. 확인 창으로도 해제할 수 없습니다 |
- 승인자는 패널에서 요청을 검토합니다. DDL 을 수정할 수 있고, 승인 및 DDL 실행 버튼을 클릭하면 바로 DDL 이 실행됩니다. 거부 버튼으로 돌려보낼 수도 있습니다.
- 승인할 수 있는 사람은 소유자와, DDL 제한 항목이 비활성화된 역할의 팀원입니다. 요청자의 역할에 승인자 역할 항목을 정했으면 정한 역할 이상만 승인합니다(DDL 승인).
- 역할별 DDL 제한은 NeoSQL 화면 안의 실행만 차단합니다. 커넥션의 DB 계정에 DDL 권한이 있으면 같은 DB 계정으로 접속하는 다른 도구에서는 차단하지 못합니다. DDL 을 반드시 차단해야 하면 DB 계정의 권한으로 차단하세요(아래 '읽기 전용 DB 계정을 권장하는 이유').
- 역할의 DDL 제한 항목을 비활성화하고 설정을 저장하면 그 역할 멤버가 반영하지 않은 변경은 버려지고, 기다리던 요청은 취소됩니다. 남겨야 할 요청은 비활성화하기 전에 처리하세요.
- 공유와 역할은 협업과 권한 에서 설명합니다.
AI 와 MCP 의 커넥션 정책
AI Assistant 과 외부 MCP 클라이언트가 커넥션에서 무엇을 할 수 있는지는 프로젝트 화면 위의 AI 설정 버튼으로 여는 창에서 커넥션마다 정합니다.
| 항목 | AI Assistant | 외부 MCP 클라이언트(데스크톱) |
|---|---|---|
| 사용 끔 | 커넥션을 사용하지 않습니다 | 커넥션으로 온 요청을 거절합니다 |
| 스키마 변경 끔 | DDL 을 실행하기 전에 확인합니다 | 데스크톱에 MCP DDL 실행 확인 창을 띄웁니다. 45초 안에 답하지 않으면 실행하지 않습니다 |
| 스키마 변경 켬 | 확인 없이 실행합니다 | 확인 없이 실행합니다 |
| 데이터 변경 끔 | INSERT, UPDATE, DELETE 를 실행하기 전에 확인합니다 | 실행하되 커밋하지 않고, MCP 용 SQL 탭에 트랜잭션을 열어 둡니다. NeoSQL 에서 직접 커밋하거나 롤백합니다 |
| 데이터 변경 켬 | 확인 없이 실행합니다 | 자동으로 커밋합니다 |
- AI, MCP 커넥션 정책보다 역할별 DDL 제한과 보호 모드가 먼저 적용됩니다. 스키마 변경 항목을 활성화해도 DDL 이 제한된 팀원이나 읽기 전용 (SELECT 외 차단) 보호 모드의 커넥션에서는 실행되지 않고, 확인 (DDL + 위험 DML) 보호 모드면 확인을 거칩니다.
- 계정 프로젝트의 공개 커넥션은 프로젝트 소유자만, 개인 커넥션은 만든 사람만 변경할 수 있습니다. 로컬 프로젝트는 기기의 사용자가 변경합니다.
- 로컬 프로젝트에서 새로 만든 커넥션은 사용 항목이 활성화되어 있고 스키마 변경 항목과 데이터 변경 항목은 비활성화되어 있습니다.
- AI 에 무엇이 전달되는지는 AI 와 MCP 에서, 창의 다른 항목은 프로젝트 AI 설정 에서 설명합니다.
읽기 전용 DB 계정을 권장하는 이유
NeoSQL 의 장치는 실수를 줄여 주지만, DB 를 지키는 마지막 벽은 아닙니다.
- 위험 SQL 확인은 SQL 편집기에서만 합니다. 다른 경로는 보호 모드만 걸립니다.
- 문장을 모양으로 판단하므로,
WHERE 1=1처럼 모양은 안전해 보이는 위험한 문장은 지나갈 수 있습니다. 앱의 DDL 제한 설명도 완벽하게 차단하지 못하니 DB 쪽 제한을 함께 활용하라고 권합니다. - 보호 모드는 개인 설정이라 팀원마다 다릅니다. 같은 DB 계정을 사용하는 다른 도구나 애플리케이션에는 아무 영향이 없습니다.
DB 계정의 권한은 DB 가 직접 지키므로 어느 도구, 어느 경로에서든 똑같이 걸립니다. 운영 DB 에는 아래처럼 하세요.
- 조회만 하는 커넥션은
SELECT권한만 가진 DB 계정으로 만드세요. AI 나 외부 MCP 클라이언트에 운영 DB 를 열 때도 조회 전용 커넥션을 사용하세요. - 데이터를 수정하는 계정과 DDL 을 실행하는 계정을 나누고, DDL 권한은 승인자만 갖게 하세요.
- 계정 프로젝트의 공개 커넥션은 DB 사용자와 비밀번호를 팀이 함께 사용합니다(연결과 실행 대상). 공개 커넥션에 넣는 계정의 권한이 곧 커넥션을 사용하는 팀 전체의 권한입니다.
주의할 점
- 커넥션 프로파일이 없는 커넥션은 보호 모드가 없음 상태입니다. 운영 DB 커넥션을 만들면 먼저 프로파일을 정하세요.
- 결과 그리드 편집과 ERD 의 DB 반영은 위험 SQL 확인을 거치지 않습니다. 운영 DB 에서는 실행 전에 보여 주는 SQL 을 꼭 확인하세요.
- 운영 DB 의 데이터를 수정할 때는 Auto Commit 스위치를 비활성화하고 실행한 뒤 확인하고 커밋하세요. 트랜잭션은 SQL 실행과 트랜잭션 에서 설명합니다.
관련 페이지
- 커넥션 프로파일: 프로파일 탭의 항목입니다.
- 위험 SQL 확인: 확인 창의 모양과 버튼입니다.
- DDL 승인: 승인 요청을 검토하고 실행하는 패널입니다.
- 운영 DB 를 안전하게 연결하기: 보안 연결과 프로파일로 운영 DB 를 연결하는 순서입니다.