따라 하기

운영 DB 를 안전하게 연결하기

데모 상점의 운영 DB 를 NeoSQL 에 연결하고, 실수로 데이터나 스키마를 변경하지 못하게 장치를 차례로 거는 순서를 따라 합니다. 끝나면 운영 DB 커넥션이 빨간색과 워터마크로 구분되고, 조회가 아닌 실행은 차단되거나 확인을 거치며, AI 와 외부 MCP 클라이언트도 같은 기준을 따릅니다. 장치마다 누가 정하고 어떤 실행에 걸리는지는 운영 DB 안전장치 에서 설명합니다. 장치를 거는 순서와 이유에 집중합니다.

사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트

준비

  • DB 계정을 둘로 나누어 받으세요. 조회만 하는 SELECT 권한의 계정과, 데이터를 수정할 때만 사용하는 계정입니다. NeoSQL 의 장치는 NeoSQL 안의 실행 경로에만 걸리고 개인 설정이라 팀원마다 다릅니다. DB 계정의 권한만이 어느 도구에서든 똑같이 걸리므로 가장 먼저 정합니다.
  • 데스크톱 앱을 사용하세요. 운영 DB 의 방화벽은 보통 회사 안이나 개발자 기기에서 오는 접속만 받습니다. 웹 앱은 NeoSQL 서버에서 DB 에 접속하므로 그런 DB 에 접속하지 못합니다(웹과 데스크톱).
  • 프로젝트 종류를 정하세요. 혼자 사용하면 로컬 프로젝트로 충분합니다. 팀원이 함께 사용하면서 DDL 승인과 마스킹이 필요하면 로그인한 뒤 계정 프로젝트를 사용하세요. 종류는 나중에 변경할 수 없습니다(로그인과 프로젝트 종류).
  • DB 서버의 주소와 포트, SSL 을 사용하면 CA 인증서 파일, 배스천 호스트를 거치면 SSH 서버의 주소와 계정을 준비합니다.

데스크톱 앱에서 커넥션 만들기

먼저 조회용 계정으로 커넥션을 만듭니다. 저장하기 전에 보안 연결과 프로파일까지 정해 두면, 프로파일이 없는 채로 운영 DB 에 접속하는 순간이 생기지 않습니다.

  1. 프로젝트를 열고 탐색기의 새 커넥션 만들기 버튼을 클릭합니다. DBMS 를 선택하고 DB에 연결 버튼을 클릭한 뒤 호스트, 포트, 조회용 DB 계정을 넣습니다. 결과: 접속 정보 칸이 열리고, 커넥션은 아직 저장되지 않았습니다. 칸마다의 설명은 커넥션 만들기와 수정 에 있습니다.
  2. SSL/SSH 탭에서 SSL/TLS 스위치를 활성화하고, Verify Full 모드를 선택한 뒤 CA 인증서를 CA 인증서 줄에 업로드합니다. IP 주소나 SSH 터널로 접속하면 Verify CA 모드를 선택합니다. 결과: 내용이 암호화되고, 접속한 상대가 진짜 DB 서버인지도 확인합니다. 처음 값인 Require 모드는 암호화만 하고 상대를 확인하지 않습니다.
  3. 배스천 호스트를 거쳐야 하면 같은 탭에서 SSH Tunnel 스위치를 활성화하고 SSH 서버와 계정을 넣은 뒤 호스트 키 검증 항목을 활성화합니다. 결과: NeoSQL 이 SSH 서버를 거쳐 DB 에 접속하고, SSH 서버가 변경되면 알아챕니다. 항목별 설명은 SSL/TLS 와 SSH 터널 에 있습니다.
  4. 연결 탭으로 돌아가 연결 테스트 버튼을 클릭합니다. 결과: 기기에서 DB 까지 접속할 수 있는지 확인합니다. 아직 저장하지 마세요. 다음 절에서 같은 창의 프로파일을 정합니다.

프로파일로 운영 환경 표시하기

  1. 같은 커넥션 창의 프로파일 탭을 열고 환경 항목(1)에서 운영 버튼을 클릭합니다. 결과: 색이 빨강, 배경 워터마크가 켬, 보호 모드가 확인 (DDL + 위험 DML) 상태로 함께 정해집니다.
  2. 조회용 커넥션이므로 보호 모드 항목(6)에서 읽기 전용 (SELECT 외 차단) 항목을 선택합니다. 결과: SQL 편집기, AI Assistant 패널, 외부 MCP 클라이언트가 커넥션에서 조회가 아닌 문장을 실행하지 않습니다.
  3. 저장 버튼을 클릭합니다. 결과: 커넥션과 프로파일이 함께 저장됩니다. 커넥션의 SQL 탭은 작업 탭 표시와 줄 번호 옆 선이 빨갛고, 배경에 커넥션 이름이 깔립니다.
  • 데이터를 수정할 때 사용할 커넥션은 변경용 DB 계정으로 따로 만들고, 같은 방법으로 운영 버튼을 클릭하되 보호 모드는 확인 (DDL + 위험 DML) 상태로 둡니다. 두 커넥션의 이름을 구분되게 지으세요.
  • 프로파일은 개인 설정입니다. 계정 프로젝트의 팀원은 각자 자기 프로파일을 정해야 합니다(커넥션 프로파일).
  • 계정 프로젝트의 공개 커넥션은 DB 사용자와 비밀번호를 팀이 함께 사용합니다. 변경용 커넥션을 공개 커넥션으로 만들면 팀원 모두가 변경용 계정으로 접속합니다(연결과 실행 대상).
  • 커넥션을 저장하면 커넥션을 모니터링하는 대시보드를 만들지 묻는 창이 표시될 수 있습니다. 만들면 서버 상태를 읽는 조회가 바로 운영 DB 로 나가니, 필요하면 나중에 대시보드로 DB 상태 모니터링하기 의 순서로 선택한 타일만 넣으세요.

데이터를 수정할 때는 트랜잭션으로

변경용 커넥션에서 데이터를 수정할 때는 실행과 확정을 나눕니다. 실행한 결과를 보고 확정할 수 있게 하기 위해서입니다.

  1. 변경용 커넥션으로 SQL 탭을 열고, 실행하기 전에 도구 모음의 Auto Commit 스위치(1)를 비활성화합니다. 결과: Commit 버튼과 Rollback 버튼(2)이 나타나고, 이제부터 실행한 문장은 트랜잭션 안에 남습니다.
  2. UPDATE orders SET status = 'CANCELLED' WHERE order_id = 1003 처럼 WHERE 가 있는 문장을 실행합니다. 결과: 보호 모드가 확인 (DDL + 위험 DML) 상태라도 WHERE 가 있는 UPDATE 는 묻지 않고 실행합니다. 확정하지 않은 변경이 있다는 표시가 도구 모음과 작업 탭에 붙습니다.
  3. SELECT 로 변경된 행을 확인한 뒤 Commit 버튼을 클릭합니다. 틀렸으면 Rollback 버튼을 클릭합니다. 결과: 그때 DB 에 확정되거나 되돌려집니다.
  • 운영 환경의 SQL 탭은 트랜잭션을 연 채 30분(처음 값) 동안 아무것도 하지 않으면 NeoSQL 이 롤백합니다. 커밋을 잊고 자리를 비워도 잠금이 오래 남지 않습니다. 값은 커넥션 프로파일 에서 설명합니다.
  • MySQL, MariaDB, Oracle 은 DDL 을 실행하면 그때까지의 변경이 함께 확정됩니다. 트랜잭션을 열어 둔 채 DDL 을 섞지 마세요 (SQL 실행과 트랜잭션).
  • 결과 그리드에서 셀을 수정하거나 ERD 의 변경을 DB 에 반영할 때도 보호 모드를 거치지만, 위험 SQL 확인은 하지 않습니다. 실행 전에 보여 주는 SQL 을 꼭 읽으세요.

AI 와 외부 MCP 클라이언트의 권한 줄이기

AI Assistant 패널과 외부 MCP 클라이언트는 사람이 문장을 하나하나 읽기 전에 SQL 을 만들어 실행할 수 있습니다. 그래서 운영 DB 커넥션은 AI 의 정책을 가장 좁게 둡니다.

  1. 프로젝트 화면 위쪽의 AI 설정 버튼을 클릭합니다. 결과: 커넥션마다 AI, MCP 정책을 정하는 표가 열립니다. 표는 AI Assistant 패널과 외부 MCP 클라이언트가 함께 따릅니다.
  2. 운영 DB 를 AI 에게 아예 보이지 않으려면 운영 DB 커넥션의 사용 항목(1)을 비활성화합니다. 결과: AI Assistant 패널에서 커넥션을 선택할 수 없고, 외부 MCP 클라이언트의 요청은 모두 거절됩니다. 여기서 비활성화하면 아래 단계는 필요 없습니다.
  3. AI 를 사용하게 둔다면 스키마 변경 항목(3)과 데이터 변경 항목(4)이 비활성화되어 있는지 확인하고, 데이터 전송 허용 항목(5)도 비활성화합니다. 결과: AI 가 만든 변경은 실행 전에 확인을 거치고, 외부 MCP 클라이언트의 데이터 변경은 커밋되지 않은 채 남습니다. AI 가 실제 행을 조회해 AI 제공자로 보내기 전에도 묻습니다. 데이터 전송 허용 항목은 새 커넥션에서 활성화되어 있습니다.
  4. 계정 프로젝트이면 민감정보 항상 마스킹 항목(6)을 활성화하고 저장 버튼을 클릭합니다. 결과: AI 와 외부 MCP 클라이언트로 가는 결과에서 민감 컬럼이 역할과 상관없이 마스킹됩니다.

AI 정책보다 커넥션 보호 모드가 먼저 걸립니다. AI Assistant 패널과 외부 MCP 클라이언트의 execute-query 는 SQL 편집기와 같은 기준을 따릅니다.

보호 모드AI Assistant 패널과 외부 MCP 클라이언트
읽기 전용 (SELECT 외 차단)조회가 아닌 문장은 INSERT, UPDATE, DELETE 를 포함해 모두 실행하지 않습니다. 여러 문장을 한꺼번에 보내도 하나라도 걸리면 아무것도 실행하지 않습니다
확인 (DDL + 위험 DML)DDL 과 WHERE 가 없는 UPDATE, DELETE 는 NeoSQL 에 확인 창을 띄웁니다. 외부 MCP 클라이언트의 요청은 45초 안에 답하지 않으면 실행하지 않습니다
  • 외부 MCP 클라이언트의 요청이 설정 때문에 거절되면 NeoSQL 화면에 MCP 실행 요청 거절됨 알림이 표시됩니다. 누가 무엇을 시도했는지 알림으로 압니다.
  • 외부 MCP 클라이언트가 도구를 자동으로 승인하도록 설정되어 있어도 위 기준은 NeoSQL 이 지킵니다. 다만 조회는 차단하지 않으므로, 조회 결과가 외부 클라이언트의 모델로 가면 안 되는 DB 는 2단계처럼 사용 항목을 비활성화하세요(AI 와 MCP).

계정 프로젝트라면 팀의 장치 걸기

계정 프로젝트에서는 프로젝트 소유자가 역할마다 장치를 겁니다. 프로파일과 달리 팀원 모두에게 걸리는 설정입니다. 로컬 프로젝트는 건너뛰세요.

  1. 소유자 계정으로 프로젝트 설정역할별 권한 탭을 열고, 운영 DB 의 스키마를 직접 변경하면 안 되는 역할에 DDL 제한 항목을 활성화합니다. 승인자 역할 칸에서 승인할 역할을 선택하고 저장합니다. 결과: 역할의 멤버는 SQL 편집기, ERD, AI Assistant 패널, 외부 MCP 클라이언트 어디에서도 DDL 을 직접 실행하지 못하고, DB 반영을 승인 요청으로 보냅니다(DDL 승인).
  2. 같은 탭에서 고객 정보를 보면 안 되는 역할에 민감정보 마스킹 처리 항목을 활성화하고 저장합니다. 결과: 역할에게 민감 컬럼과 패턴에 맞는 값이 마스킹되어 보입니다. 아직 마스킹할 컬럼은 정해지지 않았습니다.
  3. ERD 나 테이블 탭에서 customer 테이블의 email 컬럼을 우클릭해 민감정보로 지정 메뉴를 선택합니다. name 컬럼과 address 테이블의 line1 컬럼도 같게 지정합니다. 결과: 지정이 바로 저장되고, 마스킹이 적용된 역할의 결과 그리드, 내보내기, AI, MCP 결과에서 값이 마스킹됩니다(컬럼 마스킹).

차단되는지 확인하기

장치는 걸어 두었다고 끝나지 않습니다. 걸렸는지 직접 확인해 두면 나중에 차단해 줄 것이라 믿은 곳이 비어 있지 않습니다.

  1. 조회용 커넥션의 SQL 탭에서 UPDATE orders SET status = 'PAID' WHERE order_id = 1003 을 실행해 봅니다. 결과: 실행되지 않고 읽기 전용이라는 안내가 표시됩니다. 모양은 위험 SQL 확인 의 '읽기 전용 커넥션에서 차단되는 모양' 에 있습니다.
  2. 변경용 커넥션의 SQL 탭에서 WHERE 없이 DELETE FROM review 를 실행하려다 확인 창에서 취소 버튼을 클릭합니다. 결과: 보호 모드의 확인 창 하나에 보호 모드의 이유와 위험 SQL 의 이유가 함께 나오고, 취소하면 아무것도 실행하지 않습니다.
  3. AI 를 사용한다면 AI Assistant 패널에서 조회용 커넥션을 컨텍스트로 선택해 "1003번 주문을 취소 상태로 변경해 줘" 라고 요청해 봅니다. 결과: AI 가 만든 UPDATE 가 실행되지 않습니다. 외부 MCP 클라이언트에 같은 요청을 해도 거절되고 NeoSQL 에 알림이 표시됩니다.

다음에 할 일