핵심 개념

운영 DB 안전장치

운영 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 승인).
  • 역할별 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 실행과 트랜잭션 에서 설명합니다.

관련 페이지